用途:为比小改动更大的开发任务提供一套可重复执行的完整流程,强调规划、跟踪、验证与复盘,避免直接动手写代码。资料明确说明:单个文件的修复(错别字、文案调整、明显的单一 bug)不走此流程。
主要能力与流程:一、分诊,在动代码前先读请求与代码,回答缺少或损坏了什么、可能的两三种原因或方案、最可能的是哪个及原因、还有哪些不清楚需要提问;若有疑问只问一个问题,然后等待;修 bug 前必须先指出根因。二、PRD,在 prds/<slug>.md 按模板撰写,必含问题、根因(仅 bug)、方案、涉及文件、边界情况、验证步骤和完成日志,顶部保留 UTC 元数据 Created、Last Updated、Status(Draft/In Progress/Done),保持简短,通常两屏足够;旧或敏感 PRD 移入 prds/archive/。三、任务跟踪,task.md 分为 To Do、In Progress、Completed 三节,新工作放在 To Do 并链接其 PRD,尽量同时只有一项进行中,验证通过后才移入 Completed,完成项需带 UTC 时间戳、涉及文件和验证命令或结果。
文档同步与执行风格:完成后 task.md、changelog.md、files.md 需与代码一致,changelog.md 遵循 Keep a Changelog,日期用 git log --date=short;files.md 增补新文件并修正过时描述;交付说明依据 diff 而非计划。变更集保持紧凑,额外想法写入总结而非 diff;范围漂移时可加载 avoid-feature-creep。大任务可为每个研究问题使用一个子代理,但不要并行编辑同一文件。
学习循环:prds/lessons.md 为一行的扁平列表,最新在底部;当同一模式被用户二次纠正、验证发现计划遗漏、或工具/API 行为与文档不符时追加一条;每次在该仓库开始会话时先读它。
限制与禁止事项:不部署、不发布、不提交、不推送,这些由用户完成;未运行 PRD 中写明的验证步骤不得标记完成;不得凭记忆编日期,需运行 git log 或使用当前 UTC 时间;不为一行改动写 PRD。
其它:文中提及的 references/prd-template.md、project-docs 技能与具体模板内容,资料未提供。