@fitlab-ai/agent-infra 0.6.4 → 0.7.0

package/templates/.agents/workflows/refactoring.en.yaml

@@ -1,154 +1,199 @@
-# Refactoring Workflow
+# Refactoring workflow
 # Use this workflow for code refactoring tasks.
+#
+# Note: a step's `pr_tasks` list is counted toward workflow progress only when
+# `.agents/.airc.json:requiresPullRequest !== false` (see .agents/skills/complete-task/SKILL.md).
 
 name: refactoring
 description: Safe and structured workflow for code refactoring.
 
 steps:
   - name: analysis
-    description: Analyze the current code and determine the refactoring scope.
+    description: Analyze the current code and define the refactoring scope.
     recommended_agents:
       - claude
       - gemini
     tasks:
-      - Identify the code to refactor and why it needs refactoring
-      - Map all dependencies and consumers of the impacted code
+      - Identify code to refactor and the reason for refactoring
+      - Map dependencies and callers for affected code
       - Assess refactoring risk and complexity
-      - Identify existing test coverage for impacted areas
-      - Record findings in the task file
+      - Identify existing test coverage for affected areas
+      - Record findings in the task workspace
     inputs:
-      - Refactoring request or issue description
+      - Refactoring request or Issue description
       - Project codebase
     artifact_versioning:
       outputs:
         - name: analysis
           pattern: "analysis.md | analysis-r{N}.md"
-          rule: "Scan existing analysis artifacts; create analysis.md for the first round, then analysis-r{N}.md for later revisions (N = current highest round + 1)"
+          rule: "Scan existing analysis artifacts; create analysis.md for round 1 and analysis-r{N}.md for later revisions (N = current highest round + 1)"
     outputs:
-      - Scope analysis with dependency mapping
+      - Scope analysis with dependency map
       - Risk assessment
-      - Updated task file (analysis section)
+      - Updated task analysis notes
+
+  - name: analysis-review
+    description: Review whether the refactoring analysis covers dependencies, risks, and the test baseline.
+    recommended_agents:
+      - claude
+      - gemini
+    tasks:
+      - Verify the refactoring scope and rationale
+      - Check dependency, caller, and risk identification
+      - Confirm the existing test baseline is enough for design
+      - Create the requirement analysis review report
+    inputs:
+      - Latest scope analysis
+      - Refactoring request or Issue description
+    artifact_versioning:
+      inputs:
+        - name: analysis
+          pattern: "analysis.md | analysis-r{N}.md"
+          rule: "Read the highest-round analysis artifact as review input"
+      outputs:
+        - name: review-analysis
+          pattern: "review-analysis.md | review-analysis-r{N}.md"
+          rule: "Scan existing requirement-analysis review artifacts; create review-analysis.md for round 1 and review-analysis-r{N}.md for later rounds (N = current highest round + 1)"
+    outputs:
+      - Requirement analysis review report
+      - Findings to fix, if any
 
   - name: design
-    description: Plan the refactoring approach to minimize risk.
+    description: Plan the refactoring approach while minimizing risk.
     recommended_agents:
       - claude
     tasks:
       - Define the target architecture or code structure
-      - Plan incremental refactoring steps to avoid a single large change
+      - Plan incremental refactoring steps
       - Identify intermediate states that must remain functional
-      - Plan any additional tests needed before refactoring
-      - Record the refactoring plan in the task file
+      - Plan any extra tests needed before refactoring
+      - Record the refactoring plan in the task workspace
     inputs:
-      - Scope analysis from the previous step
+      - Approved scope analysis
       - Project architecture
     artifact_versioning:
       inputs:
         - name: analysis
           pattern: "analysis.md | analysis-r{N}.md"
           rule: "Read the highest-round analysis artifact as design input"
+        - name: review-analysis
+          pattern: "review-analysis.md | review-analysis-r{N}.md"
+          rule: "Read the highest-round analysis review artifact and confirm feedback is approved or handled"
       outputs:
         - name: plan
           pattern: "plan.md | plan-r{N}.md"
-          rule: "Scan existing plan artifacts; create plan.md for the first round, then plan-r{N}.md for later revisions (N = current highest round + 1)"
+          rule: "Scan existing plan artifacts; create plan.md for round 1 and plan-r{N}.md for later revisions (N = current highest round + 1)"
+    outputs:
+      - Incremental refactoring plan
+      - Prerequisite test list
+      - Updated task design notes
+
+  - name: design-review
+    description: Review whether the refactoring plan preserves behavior, is verifiable step by step, and controls risk.
+    recommended_agents:
+      - claude
+      - gemini
+    tasks:
+      - Verify the plan covers the approved scope analysis
+      - Check incremental steps, test strategy, and rollback risk
+      - Confirm the plan is ready for coding
+      - Create the plan review report
+    inputs:
+      - Latest refactoring plan
+      - Latest scope analysis and review report
+    artifact_versioning:
+      inputs:
+        - name: plan
+          pattern: "plan.md | plan-r{N}.md"
+          rule: "Read the highest-round plan artifact as review input"
+      outputs:
+        - name: review-plan
+          pattern: "review-plan.md | review-plan-r{N}.md"
+          rule: "Scan existing plan review artifacts; create review-plan.md for round 1 and review-plan-r{N}.md for later rounds (N = current highest round + 1)"
     outputs:
-      - Refactoring plan with incremental steps
-      - List of prerequisite tests
-      - Updated task file (design section)
+      - Plan review report
+      - Findings to fix, if any
 
-  - name: implementation
-    description: Execute the refactoring according to the plan.
+  - name: code
+    description: Execute the approved refactoring plan; run the same stage again after code review to handle fixes.
     recommended_agents:
       - codex
       - cursor
     tasks:
       - Create a refactoring branch
-      - Add prerequisite tests if they do not already exist
-      - Execute the refactoring incrementally
-      - Verify tests pass after each step
-      - Update impacted documentation or comments
-      - Ensure the code follows project conventions
+      - Add prerequisite tests when not already present
+      - Execute refactoring steps incrementally
+      - Verify tests after each step
+      - Fix findings from the latest code-review artifact when in fix mode
+      - Update affected docs or comments
+      - Ensure code follows project conventions
     inputs:
-      - Refactoring plan from the previous step
+      - Approved refactoring plan
       - Project coding standards
+      - Latest code review report when in fix mode
     artifact_versioning:
+      inputs:
+        - name: plan
+          pattern: "plan.md | plan-r{N}.md"
+          rule: "Read the highest-round plan artifact as implementation input"
+        - name: review-plan
+          pattern: "review-plan.md | review-plan-r{N}.md"
+          rule: "Read the highest-round plan review artifact and confirm feedback is approved or handled"
+        - name: review-code
+          pattern: "review-code.md | review-code-r{N}.md"
+          rule: "In fix mode, read the highest-round code review artifact and verify it matches the latest Code Review entry in task.md Activity Log"
       outputs:
-        - name: implementation
-          pattern: "implementation.md | implementation-r{N}.md"
-          rule: "Scan existing implementation artifacts; create implementation.md for the first round, then implementation-r{N}.md for later re-implementations (N = current highest round + 1)"
+        - name: code
+          pattern: "code.md | code-r{N}.md"
+          rule: "Scan existing code artifacts; create code.md for round 1 and code-r{N}.md for later fixes or reimplementation (N = current highest round + 1)"
     outputs:
-      - Refactoring branch with the changes
+      - Refactoring branch with implementation or fixes
       - Updated or new test files
-      - Updated task file (implementation notes)
+      - Updated task notes
 
-  - name: review
+  - name: code-review
     description: Verify that the refactoring preserves behavior and improves code quality.
     recommended_agents:
       - claude
     tasks:
-      - Verify functional equivalence unless behavior changes are intentional
+      - Verify functional equivalence unless behavior change is intentional
       - Check that all tests pass
-      - Confirm that code quality has improved
-      - Check for missed dependencies or consumers
+      - Verify code quality improvements
+      - Check for missing dependencies or callers
       - Assess performance impact when applicable
-      - Create a review report
+      - Create the code review report
     inputs:
       - Refactoring branch
       - Original code for comparison
       - Test results
     artifact_versioning:
       inputs:
-        - name: implementation
-          pattern: "implementation.md | implementation-r{N}.md"
-          rule: "Read the highest-round implementation artifact as review input"
-      outputs:
-        - name: review
-          pattern: "review.md | review-r{N}.md"
-          rule: "Scan existing review artifacts; create review.md for the first round, then review-r{N}.md for later rounds (N = current highest round + 1)"
-    outputs:
-      - Review report
-      - List of issues if any
-
-  - name: fix
-    description: Address issues found during review.
-    recommended_agents:
-      - codex
-      - cursor
-    tasks:
-      - Fix issues identified in the review
-      - Update tests as needed
-      - Verify that all tests pass
-      - Ensure there are no regressions
-    inputs:
-      - Review report
-      - Refactoring branch
-    artifact_versioning:
-      inputs:
-        - name: review
-          pattern: "review.md | review-r{N}.md"
-          rule: "Read the highest-round review artifact and verify that it matches the latest Code Review entry in the task.md Activity Log"
+        - name: code
+          pattern: "code.md | code-r{N}.md"
+          rule: "Read the highest-round code artifact as review input"
       outputs:
-        - name: refinement
-          pattern: "refinement.md | refinement-r{N}.md"
-          rule: "Scan existing refinement artifacts; create refinement.md for the first round, then refinement-r{N}.md for later rounds (N = current highest round + 1)"
+        - name: review-code
+          pattern: "review-code.md | review-code-r{N}.md"
+          rule: "Scan existing code review artifacts; create review-code.md for round 1 and review-code-r{N}.md for later rounds (N = current highest round + 1)"
     outputs:
-      - Updated branch with fixes
-      - Updated task file
+      - Code review report
+      - Findings list, if any
 
   - name: commit
-    description: Finalize the refactoring and create a pull request.
+    description: Finalize the refactoring and create a pull request (the PR portion runs only when the project enables the PR flow).
     recommended_agents:
       - claude
       - human
     tasks:
       - Ensure all tests pass
-      - Write a clear commit message that explains the refactoring
-      - Create a pull request with a detailed change summary
-      - Link the PR to the relevant issue
+      - Write a clear commit message explaining the refactoring
       - Move the task to completed
+    pr_tasks:
+      - Create a pull request with detailed changes
+      - Link the PR to the related Issue
     inputs:
       - Final refactoring branch
-      - Task file
+      - Task workspace
     outputs:
-      - Pull request
-      - Completed task file (stored in .agents/workspace/completed/)
+      - Completed task workspace under .agents/workspace/completed/
+      - Pull request (only when the project enables the PR flow)

package/templates/.agents/workflows/refactoring.zh-CN.yaml

@@ -1,5 +1,8 @@
 # 重构工作流
 # 代码重构任务时使用此工作流。
+#
+# 注：步骤中的 `pr_tasks` 列表仅在 `.agents/.airc.json:requiresPullRequest !== false` 时
+# 被计入工作流进度判定（详见 .agents/skills/complete-task/SKILL.md）。
 
 name: refactoring
 description: 安全且结构化的代码重构工作流。
@@ -29,6 +32,32 @@ steps:
       - 风险评估
       - 更新后的任务文件（分析部分）
 
+  - name: analysis-review
+    description: 审查重构分析是否覆盖依赖、风险和测试基线。
+    recommended_agents:
+      - claude
+      - gemini
+    tasks:
+      - 验证待重构范围和原因
+      - 检查依赖关系、使用者和风险识别
+      - 确认现有测试基线足以支撑设计
+      - 创建需求分析审查报告
+    inputs:
+      - 最新范围分析
+      - 重构请求或 Issue 描述
+    artifact_versioning:
+      inputs:
+        - name: analysis
+          pattern: "analysis.md | analysis-r{N}.md"
+          rule: "读取最高轮次的分析产物作为审查输入"
+      outputs:
+        - name: review-analysis
+          pattern: "review-analysis.md | review-analysis-r{N}.md"
+          rule: "扫描现有需求分析审查产物；首轮创建 review-analysis.md，后续轮次创建 review-analysis-r{N}.md（N = 当前最高轮次 + 1）"
+    outputs:
+      - 需求分析审查报告
+      - 待修正问题列表（如有）
+
   - name: design
     description: 规划重构方案以最小化风险。
     recommended_agents:
@@ -40,13 +69,16 @@ steps:
       - 规划重构前需要的额外测试
       - 在任务文件中记录重构计划
     inputs:
-      - 上一步的范围分析
+      - 已通过审查的范围分析
       - 项目架构
     artifact_versioning:
       inputs:
         - name: analysis
           pattern: "analysis.md | analysis-r{N}.md"
           rule: "读取最高轮次的分析产物作为设计输入"
+        - name: review-analysis
+          pattern: "review-analysis.md | review-analysis-r{N}.md"
+          rule: "读取最高轮次的需求分析审查产物，确认分析已获通过或已处理反馈"
       outputs:
         - name: plan
           pattern: "plan.md | plan-r{N}.md"
@@ -56,8 +88,34 @@ steps:
       - 前置测试列表
       - 更新后的任务文件（设计部分）
 
-  - name: implementation
-    description: 按计划执行重构。
+  - name: design-review
+    description: 审查重构方案是否保持行为稳定、步骤可验证且风险可控。
+    recommended_agents:
+      - claude
+      - gemini
+    tasks:
+      - 验证方案覆盖已批准的范围分析
+      - 检查增量步骤、测试策略和回滚风险
+      - 确认方案足以进入编码阶段
+      - 创建技术方案审查报告
+    inputs:
+      - 最新重构计划
+      - 最新范围分析和审查报告
+    artifact_versioning:
+      inputs:
+        - name: plan
+          pattern: "plan.md | plan-r{N}.md"
+          rule: "读取最高轮次的方案产物作为审查输入"
+      outputs:
+        - name: review-plan
+          pattern: "review-plan.md | review-plan-r{N}.md"
+          rule: "扫描现有方案审查产物；首轮创建 review-plan.md，后续轮次创建 review-plan-r{N}.md（N = 当前最高轮次 + 1）"
+    outputs:
+      - 技术方案审查报告
+      - 待修正问题列表（如有）
+
+  - name: code
+    description: 按计划执行重构；在审查后再次执行同一阶段处理修复。
     recommended_agents:
       - codex
       - cursor
@@ -66,22 +124,34 @@ steps:
       - 添加前置测试（如尚未存在）
       - 增量执行重构步骤
       - 每步后验证测试通过
+      - 修复最新 code-review 产物中要求处理的问题（如处于修复模式）
       - 更新受影响的文档或注释
       - 确保代码遵循项目规范
     inputs:
-      - 上一步的重构计划
+      - 已通过审查的重构计划
       - 项目编码标准
+      - 最新代码审查报告（修复模式适用）
     artifact_versioning:
+      inputs:
+        - name: plan
+          pattern: "plan.md | plan-r{N}.md"
+          rule: "读取最高轮次的方案产物作为实现输入"
+        - name: review-plan
+          pattern: "review-plan.md | review-plan-r{N}.md"
+          rule: "读取最高轮次的方案审查产物，确认方案已获通过或已处理反馈"
+        - name: review-code
+          pattern: "review-code.md | review-code-r{N}.md"
+          rule: "修复模式读取最高轮次的代码审查产物，并校验其与 task.md Activity Log 中最近一条 Code Review 记录一致"
       outputs:
-        - name: implementation
-          pattern: "implementation.md | implementation-r{N}.md"
-          rule: "扫描现有实现产物；首轮创建 implementation.md，后续重实现创建 implementation-r{N}.md（N = 当前最高轮次 + 1）"
+        - name: code
+          pattern: "code.md | code-r{N}.md"
+          rule: "扫描现有实现产物；首轮创建 code.md，后续修复或重实现创建 code-r{N}.md（N = 当前最高轮次 + 1）"
     outputs:
       - 包含变更的重构分支
       - 更新或新增的测试文件
       - 更新后的任务文件（实现备注）
 
-  - name: review
+  - name: code-review
     description: 验证重构是否保持了行为并提升了代码质量。
     recommended_agents:
       - claude
@@ -91,64 +161,39 @@ steps:
       - 验证代码质量提升
       - 检查是否有遗漏的依赖项或使用者
       - 评估性能影响（如适用）
-      - 创建审查报告
+      - 创建代码审查报告
     inputs:
       - 重构分支
       - 原始代码用于对比
       - 测试结果
     artifact_versioning:
       inputs:
-        - name: implementation
-          pattern: "implementation.md | implementation-r{N}.md"
+        - name: code
+          pattern: "code.md | code-r{N}.md"
           rule: "读取最高轮次的实现产物作为审查输入"
       outputs:
-        - name: review
-          pattern: "review.md | review-r{N}.md"
-          rule: "扫描现有审查产物；首轮创建 review.md，后续轮次创建 review-r{N}.md（N = 当前最高轮次 + 1）"
+        - name: review-code
+          pattern: "review-code.md | review-code-r{N}.md"
+          rule: "扫描现有代码审查产物；首轮创建 review-code.md，后续轮次创建 review-code-r{N}.md（N = 当前最高轮次 + 1）"
     outputs:
-      - 审查报告
+      - 代码审查报告
       - 问题列表（如有）
 
-  - name: fix
-    description: 处理审查中发现的问题。
-    recommended_agents:
-      - codex
-      - cursor
-    tasks:
-      - 修复审查中识别的问题
-      - 根据需要更新测试
-      - 验证所有测试通过
-      - 确保无回归问题
-    inputs:
-      - 审查报告
-      - 重构分支
-    artifact_versioning:
-      inputs:
-        - name: review
-          pattern: "review.md | review-r{N}.md"
-          rule: "读取最高轮次的审查产物，并校验其与 task.md Activity Log 中最近一条 Code Review 记录一致"
-      outputs:
-        - name: refinement
-          pattern: "refinement.md | refinement-r{N}.md"
-          rule: "扫描现有修复产物；首轮创建 refinement.md，后续轮次创建 refinement-r{N}.md（N = 当前最高轮次 + 1）"
-    outputs:
-      - 包含修复的更新分支
-      - 更新后的任务文件
-
   - name: commit
-    description: 最终确认重构并创建拉取请求。
+    description: 最终确认重构并创建拉取请求（PR 部分仅在项目启用 PR 流程时执行）。
     recommended_agents:
       - claude
       - human
     tasks:
       - 确保所有测试通过
       - 编写清晰的提交信息说明重构内容
+      - 将任务移至已完成
+    pr_tasks:
       - 创建包含详细变更描述的拉取请求
       - 将 PR 关联到相关 Issue
-      - 将任务移至已完成
     inputs:
       - 最终重构分支
       - 任务文件
     outputs:
-      - 拉取请求
       - 已完成的任务文件（位于 .agents/workspace/completed/）
+      - 拉取请求（仅项目启用 PR 流程时）

package/templates/.claude/commands/code-task.en.md

@@ -0,0 +1,8 @@
+---
+description: "Code a task from its technical plan and output a report"
+usage: "/code-task <task-id>"
+---
+
+Read and execute the code-task skill from `.agents/skills/code-task/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

package/templates/.claude/commands/code-task.zh-CN.md

@@ -0,0 +1,8 @@
+---
+description: "根据技术方案编码任务并输出报告"
+usage: "/code-task <task-id>"
+---
+
+读取并执行 `.agents/skills/code-task/SKILL.md` 中的 code-task 技能。
+
+严格按照技能中定义的所有步骤执行。

package/templates/.claude/commands/review-analysis.en.md

@@ -0,0 +1,8 @@
+---
+description: "Review a requirement analysis report"
+usage: "/review-analysis <task-id>"
+---
+
+Read and execute the review-analysis skill from `.agents/skills/review-analysis/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

package/templates/.claude/commands/review-analysis.zh-CN.md

@@ -0,0 +1,8 @@
+---
+description: "审查需求分析报告"
+usage: "/review-analysis <task-id>"
+---
+
+读取并执行 `.agents/skills/review-analysis/SKILL.md` 中的 review-analysis 技能。
+
+严格按照技能中定义的所有步骤执行。

package/templates/.claude/commands/review-code.en.md

@@ -0,0 +1,8 @@
+---
+description: "Review code implementation and output a code review report"
+usage: "/review-code <task-id>"
+---
+
+Read and execute the review-code skill from `.agents/skills/review-code/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

package/templates/.claude/commands/review-code.zh-CN.md

@@ -0,0 +1,8 @@
+---
+description: "审查代码实现并输出代码审查报告"
+usage: "/review-code <task-id>"
+---
+
+读取并执行 `.agents/skills/review-code/SKILL.md` 中的 review-code 技能。
+
+严格按照技能中定义的所有步骤执行。

package/templates/.claude/commands/review-plan.en.md

@@ -0,0 +1,8 @@
+---
+description: "Review a technical plan"
+usage: "/review-plan <task-id>"
+---
+
+Read and execute the review-plan skill from `.agents/skills/review-plan/SKILL.md`.
+
+Follow all steps defined in the skill exactly.

package/templates/.claude/commands/review-plan.zh-CN.md

@@ -0,0 +1,8 @@
+---
+description: "审查技术方案"
+usage: "/review-plan <task-id>"
+---
+
+读取并执行 `.agents/skills/review-plan/SKILL.md` 中的 review-plan 技能。
+
+严格按照技能中定义的所有步骤执行。

package/templates/.gemini/commands/_project_/archive-tasks.zh-CN.toml

@@ -2,7 +2,7 @@ description = "归档已完成任务到按日期组织的目录"
 prompt = """
 归档已完成任务：{{args}}
 
-为 {{project}} 归档已完成任务。
+为 agent-infra 归档已完成任务。
 
 读取并执行 `.agents/skills/archive-tasks/SKILL.md` 中的 archive-tasks 技能。
 

package/templates/.gemini/commands/_project_/code-task.en.toml

@@ -0,0 +1,8 @@
+description = "Code a task from its technical plan and output a report"
+prompt = """
+Code task {{args}}.
+
+Read and execute the code-task skill from `.agents/skills/code-task/SKILL.md`.
+
+Follow all steps defined in the skill exactly.
+"""

package/templates/.gemini/commands/_project_/code-task.zh-CN.toml

@@ -0,0 +1,8 @@
+description = "根据技术方案编码任务并输出报告"
+prompt = """
+编码任务 {{args}}。
+
+读取并执行 `.agents/skills/code-task/SKILL.md` 中的 code-task 技能。
+
+严格按照技能中定义的所有步骤执行。
+"""

package/templates/.gemini/commands/_project_/init-labels.zh-CN.toml

@@ -1,6 +1,6 @@
 description = "初始化仓库的 labels 体系"
 prompt = """
-为 {{project}} 初始化 labels。
+为 agent-infra 初始化 labels。
 
 读取并执行 `.agents/skills/init-labels/SKILL.md` 中的 init-labels 技能。
 

package/templates/.gemini/commands/_project_/init-milestones.zh-CN.toml

@@ -2,7 +2,7 @@ description = "初始化仓库的 milestones 体系"
 prompt = """
 初始化里程碑：{{args}}
 
-为 {{project}} 初始化 milestones。
+为 agent-infra 初始化 milestones。
 
 读取并执行 `.agents/skills/init-milestones/SKILL.md` 中的 init-milestones 技能。
 

package/templates/.gemini/commands/_project_/review-analysis.en.toml

@@ -0,0 +1,8 @@
+description = "Review a requirement analysis report"
+prompt = """
+Review analysis for task {{args}}.
+
+Read and execute the review-analysis skill from `.agents/skills/review-analysis/SKILL.md`.
+
+Follow all steps defined in the skill exactly.
+"""

package/templates/.gemini/commands/_project_/review-analysis.zh-CN.toml

@@ -0,0 +1,8 @@
+description = "审查需求分析报告"
+prompt = """
+审查任务 {{args}} 的需求分析。
+
+读取并执行 `.agents/skills/review-analysis/SKILL.md` 中的 review-analysis 技能。
+
+严格按照技能中定义的所有步骤执行。
+"""

package/templates/.gemini/commands/_project_/review-code.en.toml

@@ -0,0 +1,8 @@
+description = "Review code implementation and output a code review report"
+prompt = """
+Review code for task {{args}}.
+
+Read and execute the review-code skill from `.agents/skills/review-code/SKILL.md`.
+
+Follow all steps defined in the skill exactly.
+"""

package/templates/.gemini/commands/_project_/review-code.zh-CN.toml

@@ -0,0 +1,8 @@
+description = "审查代码实现并输出代码审查报告"
+prompt = """
+审查任务 {{args}} 的代码。
+
+读取并执行 `.agents/skills/review-code/SKILL.md` 中的 review-code 技能。
+
+严格按照技能中定义的所有步骤执行。
+"""