技能介绍

要解决的问题

多数 agent 开发流程把「工程化」理解成阶段门禁：每完成一个阶段就停下来等用户确认，遇到决策就反问一轮。结果是用户需要在几十轮对话里持续充当项目经理，而 agent 的上下文也随之塞满需求、代码和日志。另一个常见问题是跨会话丢失状态：新对话里 agent 不知道上次做到哪一步，只能重新读仓库。

核心思路

这个技能把自主性拆成三件套：yolo 模式免去工具权限弹窗、子 Agent 全权承包让主 Agent 不亲自写码、最小上下文通过文档分层控制每次加载的内容。主 Agent 只负责规划、派发、回收结构化小结和更新文档，业务实现、测试、修 bug、git commit 全部由子 Agent 一包到底。

启动时先确认是否处于自动批准模式，不是则生成 --dangerously-skip-permissions 启动脚本或降级运行；规划阶段先把接口和类型定义落盘，再拆分成 vault/0X-*.md 任务卡；编码前子 Agent 拿接口契约去实现，不得擅自改契约；开发循环中主 Agent 只持有任务索引，细节留在文档里按需读。

打断用户只有两种时机：遇到阻塞开发的硬问题，或所有可完成任务完成后集中确认阻塞项和跳过项。其余小决策由子 Agent 自行拍板，落盘留痕。

文档与续作

文档结构由 项目备忘录.md、docs/开发进度.md 和 vault/ 任务卡组成。每个 vault 顶部三行摘要承担快速定位，接口与类型段作为实现契约。新会话只需读备忘录和下一个待办 vault 就能续作，不需要重读全部 docs。bug 走复现、定位、修复、验证四步，落盘时机按严重度区分，避免为小问题膨胀上下文。

适用边界

yolo 是强烈推荐的前提但不是硬前提：无法切换自动批准模式时会降级运行，工具调用会弹权限框，自主性受影响但流程不阻塞。主 Agent 完全不写码，意味着实现质量取决于子 Agent 能力和自审清单的执行。单文件超过 500 行要拆，超过 1000 行必须先拆模块。抽象需求需要先翻译成可执行假设，再用交互式问答给出 2-3 个选项让用户挑，而不是反问「你到底要什么」。