@fitlab-ai/agent-infra 0.6.5 → 0.7.0

package/templates/.agents/workflows/feature-development.zh-CN.yaml

@@ -1,5 +1,8 @@
 # 功能开发工作流
 # 实现新功能时使用此工作流。
+#
+# 注：步骤中的 `pr_tasks` 列表仅在 `.agents/.airc.json:requiresPullRequest !== false` 时
+# 被计入工作流进度判定（详见 .agents/skills/complete-task/SKILL.md）。
 
 name: feature-development
 description: 开发新功能的端到端工作流。
@@ -24,10 +27,36 @@ steps:
           pattern: "analysis.md | analysis-r{N}.md"
           rule: "扫描现有分析产物；首轮创建 analysis.md，后续修订创建 analysis-r{N}.md（N = 当前最高轮次 + 1）"
     outputs:
-      - 更新后的任务文件（分析部分）
+      - 需求分析报告
       - 受影响文件列表
       - 识别的风险或约束
 
+  - 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:
@@ -39,24 +68,53 @@ 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"
           rule: "扫描现有方案产物；首轮创建 plan.md，后续修订创建 plan-r{N}.md（N = 当前最高轮次 + 1）"
     outputs:
-      - 更新后的任务文件（设计部分）
+      - 技术方案
       - 接口定义
       - 实现计划
 
-  - 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
@@ -65,21 +123,33 @@ 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
@@ -88,63 +158,38 @@ 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/.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)