refine-task

name	refine-task
description	处理代码审查反馈并修复问题

修复审查问题

修复审查发现的问题，并产出 refinement.md 或 refinement-r{N}.md。

行为边界 / 关键规则

• 只修复审查产物中记录的问题
• env-blocked 项不在修复范围内：refinement 报告必须如实保留这些项并记录“不在 AI 修复范围（环境性遗留）”，不能为了清空报告做 no-op 改动
• 绝不自动执行 git add 或 git commit
• 执行本技能后，你必须立即更新 task.md

版本戳规则：创建或更新 task.md frontmatter 时，先读取 .agents/rules/version-stamp.md，并写入或刷新 agent_infra_version。

常见违规借口与反驳

借口	反驳
「这条审查意见不合理，直接忽略」	不同意要在报告的未解决问题中写明理由，不能静默跳过 blocker/major。
「顺手把旁边也优化了」	范围严格限定在审查项内，范围外改动属于越界。
「env-blocked 项清掉报告好看」	env-blocked 不在修复范围，必须如实保留并标注，禁止 no-op 改动充数。

第 0 步：状态核对（执行前硬约束）

在加载 workflow / skill / rules 指令之后、做任何任务状态判断或用户可见结论之前，必须先执行状态核对。指令类文件读取不算对外动作或结论。

运行以下命令，并把原文粘贴到回复正文和本轮产物的 ## 状态核对 段：

git status -s
ls -la .agents/workspace/active/{task-id}/
tail .agents/workspace/active/{task-id}/task.md

状态核对完成前，禁止任何关于外部状态的断言（例如“代码没变”“测试已通过”“没有其他引用”），包括思考阶段。本门禁只提供结构下限；逐条证据配对和真实性仍需按报告模板与审查要求核对。

执行步骤

1. 验证前置条件

要求存在：

• .agents/workspace/active/{task-id}/task.md
• 至少一个审查产物：review.md 或 review-r{N}.md

在前置检查阶段必须记录 {review-artifact}、{refinement-round}、{refinement-artifact}，并从最新实现报告中记录 {implementation-artifact}。

同时校验 Activity Log 中最近一条 Code Review 记录；如果引用了不存在的文件，立即停止并输出： Review artifact mismatch: Activity Log references {expected} but file not found. Please verify the review artifact exists.

2. 阅读审查与实现上下文

在修改代码前先读取最新的 {review-artifact} 和 {implementation-artifact}。

3. 规划并执行修复

按 Blocker -> Major -> Minor 的顺序处理，始终保持改动聚焦。

详细修复流程、优先级和验证循环见 reference/fix-workflow.md。执行此步骤前先读取 reference/fix-workflow.md。

4. 运行测试验证

修复后运行项目测试命令，并把修复范围限制在审查结论内。

5. 编写修复报告

创建 .agents/workspace/active/{task-id}/{refinement-artifact}。

报告结构和示例章节见 reference/report-template.md。写报告前先读取 reference/report-template.md。

6. 更新任务状态

获取当前时间：

date "+%Y-%m-%d %H:%M:%S%:z"

更新 task.md：

• 审查 ## 需求 段落，仅把因本轮修复而新满足且有测试通过支撑的条目从 - [ ] 勾为 - [x]
• 保留明确填写的可选 Issue 字段元数据（priority、effort、start_date、target_date）；仅在审查上下文非常明确时推断 priority 或 effort，不要臆测日期
• 追加： - {YYYY-MM-DD HH:mm:ss±HH:MM} — **Refinement (Round {N}, for {review-artifact})** by {agent} — Fixed {n} blockers, {n} major, {n} minor issues[, skipped {n} env-blocked] → {refinement-artifact}

env-blocked > 0 时附加 , skipped {n} env-blocked；env-blocked = 0 时省略。

如果 task.md 中存在有效的 issue_number，执行以下同步操作（任一失败则跳过并继续）：

• 执行前先读取 .agents/rules/issue-sync.md，完成 upstream 仓库检测和权限检测
• 按 issue-sync.md 设置 status: in-progress
• 创建或更新 .agents/rules/issue-sync.md 中定义的 task 评论标记（按 issue-sync.md 的 task.md 评论同步规则）
• 发布 {refinement-artifact} 评论

7. 完成校验

运行完成校验，确认任务产物和同步状态符合规范：

node .agents/scripts/validate-artifact.js gate refine-task .agents/workspace/active/{task-id} {refinement-artifact} --format text

处理结果：

• 退出码 0（全部通过）-> 继续到「告知用户」步骤
• 退出码 1（校验失败）-> 根据输出修复问题后重新运行校验
• 退出码 2（网络中断）-> 停止执行并告知用户需要人工介入

将校验输出保留在回复中作为当次验证输出。没有当次校验输出，不得声明完成。

8. 告知用户

仅在校验通过后执行本步骤。

重要：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。如果 .agents/.airc.json 中配置了自定义 TUI（customTUIs），读取每个工具的 name 和 invoke，按同样格式补充对应命令行（${skillName} 替换为技能名，${projectName} 替换为项目名）。

输出修复摘要后，展示下一步：

下一步 - 重新审查或提交：
- 重新审查（始终推荐）：
  - Claude Code / OpenCode：/review-task {task-id}
  - Gemini CLI：/agent-infra:review-task {task-id}
  - Codex CLI：$review-task {task-id}
- 直接提交（可选；仅在所有问题已解决且风险可控时）：
  - Claude Code / OpenCode：/commit
  - Gemini CLI：/agent-infra:commit
  - Codex CLI：$commit

完成检查清单

• 已读取最新审查与实现上下文
• 已修复所有必需的 Blocker 和 Major 问题
• 已写出 {refinement-artifact}
• 已更新 task.md 并追加 Activity Log
• 已根据剩余风险推荐正确的下一步

注意事项

• 首轮修复使用 refinement.md，后续轮次使用 refinement-r{N}.md
• 若不同意审查意见，要在报告的未解决问题中记录理由
• 不要把范围扩展到审查项之外

停止

完成检查清单后立即停止。

错误处理

• 任务未找到：Task {task-id} not found
• 缺少审查报告：Review report not found, please run the review-task skill first
• 审查产物不一致：Review artifact mismatch: Activity Log references {expected} but file not found. Please verify the review artifact exists.