code-coder

Code Coder

遵循项目规则，以最小差异实现临时代码任务。

Harness 发现

参阅 ../nextstage-harness/references/harness-discovery.md。从 {harness_root}/rules/*.md 加载规则。先阅读 architecture-rules.md。旧版规则：仅当 {harness_root} 不存在时，才使用 .cursor/rules/*.mdc。

适用场景

• 计划版本之外的错误修复和热修复
• 独立的组件、钩子、服务或实用工具
• 小型重构（≤ 1 个文件或紧密关联的一组文件）
• 版本生命周期之外的脚本、迁移、种子数据
• 没有 execution-handoff.md 的“直接实现这个”任务

对于包含 execution-handoff.md 的完整计划版本，请遵循 ../execution-handoff-generator/references/run-implementation.md 并根据 ../execution-handoff-generator/SKILL.md 更新交接文档——不要使用本技能下方的临时任务 周期。

如果请求包含 GitLab 问题 URL（ISSUE_URL），请改用 execution-gitlab-issue，不要使用本技能。

会话输入

变量	必填
{product_root}	是（或在只有一个明显产品时推断）
{task_description}	是
{target_layer}	尽可能推断：前端、后端、基础设施、测试、全栈

范围隔离

仅在 {product_root}/** 和 harness 文档范围内操作。除非有要求，否则不要读取单体仓库中的其他产品。

启动（必需）

1. 阅读 AGENTS.md
2. 加载 harness 中对应层的规则（始终加载架构规则；按层加载后端／前端／测试／端到端规则）
3. 加载产品上下文：遵循 ../nextstage-harness/references/artifact-layout.md 中的 Implementation boot rule
4. 执行 git status 和 git diff
5. 写入前先阅读目标文件

实现规则

• 差异优先——只改必需的行；不做无关格式调整
• 优先编辑现有文件，而非新建文件
• **大改动门槛：**同时涉及 >1 个文件、单个文件超过 20 行，或变更公开契约时，先用一行说明计划并等待批准
• 除非用户明确要求，否则不要提交——提交时，参阅 ../nextstage-harness/references/agent-git-identity.md
• 不创建 SDD 工件——不创建 task-NNN.md、requirements.md、execution-handoff.md
• 除非用户要求，否则不添加无谓注释
• 按照 AGENTS.md 中的 Docker 和测试要求运行测试；项目专用容器和命令见 architecture-rules.md

单任务周期

1. 理解任务
2. 加载规则
3. 探索相关文件
4. 确定最小差异
5. 应用修改（或在达到大改动门槛时提交计划）
6. 在适用时运行测试
7. 审查循环——调用 code-reviewer 并根据其发现迭代（见下文）
8. 报告变更内容、最终审查结论和后续事项

审查循环（必需）

测试通过后（步骤 6），在报告完成前运行内部审查循环。

• 对工作树差异（git diff）调用 code-reviewer——不传入 ISSUE_URL，也不使用版本收尾流程，只审查临时任务的差异。
• **最多 3 轮。**每轮审查后：
  • 没有严重问题（评分令人满意）→ 继续报告。
  • 存在严重问题且尚有剩余轮次 → 应用能解决每项严重问题的最小差异（code-reviewer 只读，因此由本技能应用修复），在适用时重新运行测试，然后再次审查。
  • 轮次用尽但仍有未解决的严重问题 → 停止并报告受阻。列出尚未解决的严重问题。不得报告成功。
• 修复须限定在原任务范围内。如果严重问题需要更改范围外的内容（公开契约、跨产品、多日工作），请停止，并按照停止条件升级处理，而不要扩大差异。
• 警告和建议不构成阻碍：将其作为后续事项纳入最终报告。

停止条件

条件	操作
存在多个产品且 {product_root} 不明确	询问一次
触发重大变更门槛	制定计划并等待
涉及公共契约或跨产品边界	停止、说明并询问
任务需要多日的 SDD 规划	转交至规划环节

相关技能

• code-reviewer — 实现后必须进行审查循环（参见 审查循环）
• code-investigator — 遇到不明确的 Bug 而受阻时使用
• code-autonomous — 自主多 Agent 执行（GitLab issue 或本地计划）；对于 GitLab issue，请改用 execution-gitlab-issue

禁止事项

• 生成 SDD 工件
• 未明确指定范围时访问其他产品
• 未经明确请求提交更改
• 执行超出任务范围的重构