izittmarvin/agent-skills-zh/ask-marvin

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 了解有序决策树：五个问题、每个分支背后的理由，以及为什么继续必须最先排除。在边界上做这个决定；阶段进行到一半时，继续当前工作，或把剩余部分拆给子 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，绑定个人环境，安装后通常需要按自己的习惯调整。