ask-marvin

Files (3)

• PHASE-BOUNDARIES.md
• SKILL.md
• openai.yaml · agents/

SKILL.md (first lines)

# Ask Marvin

你不必记住仓库里的每个 Skill；拿不准时就从这里开始。

## 主流程：核心工作流

日常开发沿着核心工作流推进，其余 Skill 按需插入：

1. **`/grilling`**——计划里还有真正需要用户拍板的选择时，从这里开始。它按轮次追问：事实由 Agent 自己查，只有决策才会来问人。收敛后输出摘要（方案、假设、排除项、验收判据）并确认去向：仅讨论、落盘成执行清单，或直接实现。
2. **`/to-checklist`**——需求已确认、要落盘成可接力文档时。产出 `.plans/` 下的本地执行清单（分批、带 checkbox，归 gitignore）；文档即接力凭证，新会话让 `/implement` 读它就能继续，无需交接。一步能完成的小改动跳过它。
3. **`/implement`**——需求和验收明确后写代码。存在 `.plans/` 清单时按批次执行并勾选。它会在预先确认的 seam 上驱动 **`/tdd`**（一次一个红—绿切片），完成后用 **`/code-review`** 审查并提交。只改一个明确行为时单独用 `/tdd`；只想审查某个固定点以来的 diff 时单独用 `/code-review`。
4. **`/debug`**——缺陷需要诊断时。它用可行信号验证原因；只诊断时交付证据，获准修复时补充回归保护。
5. **`/wrap-up`**——工作结束时收尾：兑现承诺过的结果、清理现场、报告真实最终状态。

按需插入：

- **`/prototype`** 讨论说不清时写一次性代码回答设计问题：状态模型、业务逻辑，或必须亲眼比较的 UI 变体。
- **`/handoff`** 会话太长、要换宿主或换目录时，把上下文压缩成接力文档，新会话读取后续上。

## 阶段边界

**阶段（phase）** 是一次会话内部的一块工作：追问、实现、验收。两个阶段之间的**边界**上有五个选项，这是整张地图里最依赖判断的决定：

- **继续**：留在当前会话。没有成本，也不会丢失任何内容。
- **`/clear`**：清空窗口，当前会话对下一步没有用时使用。
- **`/handoff`** 写出一份可携带的 Markdown 文件。范围很窄：换一套宿主、换一个目录、交给同事，或在阶段进行到一半时分出旁路任务。
- **子 Agent**：把范围足够窄的任务送到独立窗口，再拿回报告。
- **`/compact`** 压缩当前上下文，并用摘要启动新会话。这是**默认选项**，放在决策树底部，不是第一选择。

阅读 [PHASE-BOUNDARIES.md](PHASE-BOUNDARIES.md) 了解有序决策树：五个问题、每个分支背后的理由，以及为什么**继续**必须最先排除。在边界上做这个决定；阶段进行到一半时，继续当前工作，或把剩余部分拆给子 Agent。

## 代码库健康

- **`/establish-engineering-harness`** 为代码库建立并刷新可执行的工程护栏：唯一 Harness 入口、module 职责、dependency rules、state owner、canonical contracts 和可信验证命令。新仓库首次建立，或 Harness 与代码发生漂移时使用。
- **`/codebase-design`** 寻找有源码依据的架构改进机会，或直接设计指定模块的接口与测试边界；术语查询只加载词汇参考。

## 独立使用

- **`/wizard`** 处理只有人能走的步骤：开通基础设施、配置凭据或 CI secrets、走不熟悉的第三方控制台。生成交互式 bash 脚本，打开每个 URL、捕获每个值。
- **`/teach`** 以当前目录为有状态的学习工作区，跨多个会话教用户一项新技能或概念。
- **`/writing-for-agents`** 编写 Agent 所消费文档的参考：Skill、`AGENTS.md` / `CLAUDE.md`，以及通过指针到达的文档。
- **`/frontend-craft`** 生产级前端表面的设计、实现、审查与打磨：先判定 surface mode，再按需加载深层规则；展示类表面内置 12 风格配方与 434 案例库做风格选型。

个人分类还有 `/obsidian-vault`，绑定个人环境，安装后通常需要按自己的习惯调整。

From iZiTTMarvin/agent-skills-zh, MIT.

More from iZiTTMarvin/agent-skills-zh