用途
Workflow 是一个把多步骤开发工作流程化的技能,按照“谨慎的资深工程师”的做法推进:先初步诊断,再写 PRD,用任务清单跟踪进度,完成后同步文档,并把踩过的坑记录下来,避免重复犯错。
对于只需改一个文件的修复(错别字、文案调整、单个显而易见的 bug),应当跳过本流程,直接修复。
主要能力
- 初步诊断(Triage):动手前先阅读请求与代码,用几行回答四个问题:缺了什么、坏了什么、不完整的是什么;两三种可能的原因或方案;最可能是哪一种及理由;还有哪些不清楚的地方需要询问。若最后一项不为空,只问一个问题,然后等待回答。对于 bug,必须先指出根因再提修复方案。
- PRD 撰写:满足以下任一条件时撰写 PRD:将改动三个及以上文件、schema 变更、涉及架构选择(认证、托管、数据模型)、bug 经过实际调查才诊断出、该工作日后会作为指南引用。单文件且从日志或类型即可看出的修复、错别字、CSS 微调、文案修改则跳过。PRD 写入
prds/<slug>.md,若计划中存在真正的取舍,则与用户共享。 - 任务跟踪:
task.md分为## To Do、## In Progress、## Completed三部分。新工作放在 To Do 并链接对应 PRD;尽量同一时间只有一项处于 In Progress;条目在验证通过后才移入 Completed,而不是编辑完成就移动。Completed 条目需包含 UTC 时间戳(YYYY-MM-DD HH:mm)、涉及文件、验证命令或结果。 - 构建:小步推进,逐步验证。
- 文档同步:加载 update-project-docs,更新
task.md、changelog.md、files.md,然后打印提交信息。changelog.md遵循 Keep a Changelog,日期来自git log --date=short,不得凭记忆填写;files.md新增文件并修正过时描述;关于交付内容的声明以 diff 为准,而非计划。可通过/update、@update或“update project docs”触发。 - 经验记录:
prds/lessons.md为平铺列表,一行一条,最新在底部。当用户第二次纠正同一模式、验证步骤发现计划遗漏、工具或 API 行为与文档不符时,追加一条。在任何会话开始时读取该文件。
使用方式
按步骤推进流程;当某一步需要用到相关技能时,再加载相应技能:写 PRD 用 create-prd;改动后同步文档用 update-project-docs;任何可能丢弃工作成果的 git 命令前用 git-safety;范围开始蔓延时用 avoid-feature-creep;被用户阻塞或下一步需要用户时用 what-i-need-from-you;部署前或公开仓库前用 sec-check。
执行风格:改动集保持紧凑,请求决定范围,额外想法写进总结而非 diff;任务足够大时,每个研究问题使用一个子代理,不要对同一文件并行编辑;当工作不再合理时停下重新规划,更新 PRD 后继续;宣布完成前自问:资深工程师会原样批准这个 diff 吗?
适用场景
跨多文件的功能开发、涉及 schema 或架构选择的工作、需要深入排查的 bug 修复,以及后续会作为参考指南的任务。
限制
该技能不部署、不发布、不提交、不推送,这些由用户完成;不在未运行 PRD 中验证步骤的情况下标记任务完成;不虚构日期(应运行 git log 或使用当前 UTC 时间);不为一行改动撰写 PRD。