用途:在任意代码库中使用 Claude Code 开发功能时,让工作经过纪律化的构建→审查→测试→修复循环,避免仅凭“能编译”就交付。
工作来源:若仓库中存在计划文件(路线图、重构计划或带 - [ ] 复选框的任务列表),则处理第一个未勾选任务。在 ProductOS 仓库中,计划文件为 docs/ROADMAP.md、docs/REFACTOR.md,以及用户要求安全修复时的 docs/SECURITY-AUDIT.md 中的 Fix plan;docs/PLAN.md 与 productos/*-CHECKLIST.md 不是构建计划,即使含列表也忽略。任务顺序有意安排,不得跳过。若计划引用规格文档,只读与当前任务相关的章节。无计划或请求超出计划时,依据用户提示构建,先将其复述为可验证目标并给出 2–4 条成功标准,用一条消息确认范围后再开始。
循环步骤(每个任务或提示功能执行,任一步未通过不得推进):构建,严格实现任务规定内容,采用满足需求的最简实现,做外科手术式改动,不引入推测性范围,遵循项目既有约定。审查,对改动代码运行 /review;若涉及认证、支付、用户输入或数据访问,还要运行 /security-review;修复范围内所有发现的问题,包括缺陷、安全问题、边界情况、性能及所改文件的风格;若项目有设计系统规范(设计令牌文件、DESIGN.md、主题配置),检查 UI 改动是否绕过令牌,不得硬编码颜色、字体或间距;未改动代码中的既有问题记录到报告中而非静默修复;重复 /review 直至干净;若发现与任务或规格冲突,以规格为准并标记分歧。端到端测试,运行任务的验证步骤或成功标准,运行完整测试套件确保此前通过项仍通过,为新逻辑补测试,然后像用户一样实际运行应用走真实流程,包括空、加载和错误状态。修复,测试发现的问题回到循环:修复→/review→重测;绝不把失败任务标记完成,绝不在应用损坏时开始下一任务。继续,将任务标记为 - [x],更新计划中的进度/状态行,循环至下一任务直到请求范围完成。报告,完成后告知用户:构建内容与计划进度、已修复的审查发现与推迟项、验证方式(测试与流程走查)、下一步需关注事项,并如实说明不稳定或仅部分验证的内容。
规则:跳过审查或未测试的工作等于未完成;不要重新争论计划决策,若任务看似有误,提一个具体问题而非猜测;发现无任务覆盖的工作时,应提出并建议新任务,绝不静默扩大范围。