@fitlab-ai/agent-infra 0.3.0

package/templates/.agents/workflows/code-review.zh-CN.yaml

@@ -0,0 +1,60 @@
+# 代码审查工作流
+# 审查拉取请求或代码变更时使用此工作流。
+
+name: code-review
+description: 对拉取请求或分支进行全面代码审查的工作流。
+
+steps:
+  - name: analysis
+    description: 加载上下文并理解变更范围。
+    recommended_agents:
+      - claude
+      - gemini
+    tasks:
+      - 阅读 PR 描述和关联的 Issue
+      - 审查差异以理解变更内容
+      - 识别变更的意图和范围
+      - 加载相关的项目规范和标准
+    inputs:
+      - 待审查的拉取请求或分支
+      - 项目规范
+    outputs:
+      - 对变更范围的理解
+      - 待审查文件列表
+
+  - name: review
+    description: 执行全面的代码审查。
+    recommended_agents:
+      - claude
+    tasks:
+      - 检查代码正确性和逻辑
+      - 验证是否遵循项目编码标准
+      - 检查安全漏洞
+      - 评估性能影响
+      - 验证测试覆盖率和测试质量
+      - 检查文档更新
+      - 寻找边界情况和错误处理
+      - 审查提交信息
+    inputs:
+      - 代码变更（差异）
+      - 项目规范
+      - 现有测试套件
+    outputs:
+      - 包含分类发现的审查报告
+      - 批准或变更请求
+
+  - name: report
+    description: 记录和传达审查发现。
+    recommended_agents:
+      - claude
+    tasks:
+      - 从模板创建审查报告
+      - 按严重程度分类发现（严重、重要、次要、建议）
+      - 提供可操作的反馈，包含具体文件和行号引用
+      - 总结整体评估
+    inputs:
+      - 上一步的审查发现
+      - 审查报告模板
+    outputs:
+      - 完成的审查报告
+      - PR 评论（如适用）

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

@@ -0,0 +1,150 @@
+# 功能开发工作流
+# 实现新功能时使用此工作流。
+
+name: feature-development
+description: 开发新功能的端到端工作流。
+
+steps:
+  - name: analysis
+    description: 分析功能需求，探索代码库，识别受影响的区域。
+    recommended_agents:
+      - claude
+      - gemini
+    tasks:
+      - 阅读并理解功能需求
+      - 探索代码库以识别相关文件和模块
+      - 识别依赖项和潜在影响区域
+      - 将发现记录在任务文件中
+    inputs:
+      - 功能需求或 Issue 描述
+      - 项目代码库
+    artifact_versioning:
+      outputs:
+        - name: analysis
+          pattern: "analysis.md | analysis-r{N}.md"
+          rule: "扫描现有分析产物；首轮创建 analysis.md，后续修订创建 analysis-r{N}.md（N = 当前最高轮次 + 1）"
+    outputs:
+      - 更新后的任务文件（分析部分）
+      - 受影响文件列表
+      - 识别的风险或约束
+
+  - name: design
+    description: 为功能实现创建技术设计方案。
+    recommended_agents:
+      - claude
+      - gemini
+    tasks:
+      - 定义接口和数据结构
+      - 概述实现方案
+      - 识别边界情况和错误处理策略
+      - 在任务文件中记录设计方案
+    inputs:
+      - 上一步的分析结果
+      - 项目架构和规范
+    artifact_versioning:
+      inputs:
+        - name: analysis
+          pattern: "analysis.md | 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: 按照设计方案实现功能。
+    recommended_agents:
+      - codex
+      - cursor
+    tasks:
+      - 创建功能分支
+      - 实现功能代码
+      - 编写单元测试
+      - 编写集成测试（如适用）
+      - 确保代码遵循项目规范
+    inputs:
+      - 上一步的技术设计
+      - 项目编码标准
+    artifact_versioning:
+      outputs:
+        - name: implementation
+          pattern: "implementation.md | implementation-r{N}.md"
+          rule: "扫描现有实现产物；首轮创建 implementation.md，后续重实现创建 implementation-r{N}.md（N = 当前最高轮次 + 1）"
+    outputs:
+      - 包含实现的功能分支
+      - 测试文件
+      - 更新后的任务文件（实现备注）
+
+  - name: review
+    description: 审查实现的正确性、代码风格和最佳实践。
+    recommended_agents:
+      - claude
+    tasks:
+      - 审查代码变更的正确性
+      - 检查是否遵循项目规范
+      - 验证测试覆盖率和质量
+      - 检查安全和性能问题
+      - 创建审查报告
+    inputs:
+      - 实现分支
+      - 项目规范
+    artifact_versioning:
+      inputs:
+        - name: implementation
+          pattern: "implementation.md | implementation-r{N}.md"
+          rule: "读取最高轮次的实现产物作为审查输入"
+      outputs:
+        - name: review
+          pattern: "review.md | review-r{N}.md"
+          rule: "扫描现有审查产物；首轮创建 review.md，后续轮次创建 review-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: 最终确认变更并创建拉取请求。
+    recommended_agents:
+      - claude
+      - human
+    tasks:
+      - 确保所有测试通过
+      - 按规范编写清晰的提交信息
+      - 创建包含适当描述的拉取请求
+      - 将 PR 关联到相关 Issue
+      - 将任务移至已完成
+    inputs:
+      - 最终实现分支
+      - 任务文件
+    outputs:
+      - 拉取请求
+      - 已完成的任务文件（位于 .agent-workspace/completed/）

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

@@ -0,0 +1,150 @@
+# 功能开发工作流
+# 实现新功能时使用此工作流。
+
+name: feature-development
+description: 开发新功能的端到端工作流。
+
+steps:
+  - name: analysis
+    description: 分析功能需求，探索代码库，识别受影响的区域。
+    recommended_agents:
+      - claude
+      - gemini
+    tasks:
+      - 阅读并理解功能需求
+      - 探索代码库以识别相关文件和模块
+      - 识别依赖项和潜在影响区域
+      - 将发现记录在任务文件中
+    inputs:
+      - 功能需求或 Issue 描述
+      - 项目代码库
+    artifact_versioning:
+      outputs:
+        - name: analysis
+          pattern: "analysis.md | analysis-r{N}.md"
+          rule: "扫描现有分析产物；首轮创建 analysis.md，后续修订创建 analysis-r{N}.md（N = 当前最高轮次 + 1）"
+    outputs:
+      - 更新后的任务文件（分析部分）
+      - 受影响文件列表
+      - 识别的风险或约束
+
+  - name: design
+    description: 为功能实现创建技术设计方案。
+    recommended_agents:
+      - claude
+      - gemini
+    tasks:
+      - 定义接口和数据结构
+      - 概述实现方案
+      - 识别边界情况和错误处理策略
+      - 在任务文件中记录设计方案
+    inputs:
+      - 上一步的分析结果
+      - 项目架构和规范
+    artifact_versioning:
+      inputs:
+        - name: analysis
+          pattern: "analysis.md | 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: 按照设计方案实现功能。
+    recommended_agents:
+      - codex
+      - cursor
+    tasks:
+      - 创建功能分支
+      - 实现功能代码
+      - 编写单元测试
+      - 编写集成测试（如适用）
+      - 确保代码遵循项目规范
+    inputs:
+      - 上一步的技术设计
+      - 项目编码标准
+    artifact_versioning:
+      outputs:
+        - name: implementation
+          pattern: "implementation.md | implementation-r{N}.md"
+          rule: "扫描现有实现产物；首轮创建 implementation.md，后续重实现创建 implementation-r{N}.md（N = 当前最高轮次 + 1）"
+    outputs:
+      - 包含实现的功能分支
+      - 测试文件
+      - 更新后的任务文件（实现备注）
+
+  - name: review
+    description: 审查实现的正确性、代码风格和最佳实践。
+    recommended_agents:
+      - claude
+    tasks:
+      - 审查代码变更的正确性
+      - 检查是否遵循项目规范
+      - 验证测试覆盖率和质量
+      - 检查安全和性能问题
+      - 创建审查报告
+    inputs:
+      - 实现分支
+      - 项目规范
+    artifact_versioning:
+      inputs:
+        - name: implementation
+          pattern: "implementation.md | implementation-r{N}.md"
+          rule: "读取最高轮次的实现产物作为审查输入"
+      outputs:
+        - name: review
+          pattern: "review.md | review-r{N}.md"
+          rule: "扫描现有审查产物；首轮创建 review.md，后续轮次创建 review-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: 最终确认变更并创建拉取请求。
+    recommended_agents:
+      - claude
+      - human
+    tasks:
+      - 确保所有测试通过
+      - 按规范编写清晰的提交信息
+      - 创建包含适当描述的拉取请求
+      - 将 PR 关联到相关 Issue
+      - 将任务移至已完成
+    inputs:
+      - 最终实现分支
+      - 任务文件
+    outputs:
+      - 拉取请求
+      - 已完成的任务文件（位于 .agent-workspace/completed/）

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

@@ -0,0 +1,154 @@
+# 重构工作流
+# 代码重构任务时使用此工作流。
+
+name: refactoring
+description: 安全且结构化的代码重构工作流。
+
+steps:
+  - name: analysis
+    description: 分析当前代码并确定重构范围。
+    recommended_agents:
+      - claude
+      - gemini
+    tasks:
+      - 识别待重构的代码及重构原因
+      - 映射受影响代码的所有依赖项和使用者
+      - 评估重构的风险和复杂度
+      - 识别受影响区域的现有测试覆盖
+      - 将发现记录在任务文件中
+    inputs:
+      - 重构请求或 Issue 描述
+      - 项目代码库
+    artifact_versioning:
+      outputs:
+        - name: analysis
+          pattern: "analysis.md | analysis-r{N}.md"
+          rule: "扫描现有分析产物；首轮创建 analysis.md，后续修订创建 analysis-r{N}.md（N = 当前最高轮次 + 1）"
+    outputs:
+      - 包含依赖关系图的范围分析
+      - 风险评估
+      - 更新后的任务文件（分析部分）
+
+  - name: design
+    description: 规划重构方案以最小化风险。
+    recommended_agents:
+      - claude
+    tasks:
+      - 定义目标架构或代码结构
+      - 规划增量重构步骤（避免一次性大改动）
+      - 识别应保持功能正常的中间状态
+      - 规划重构前需要的额外测试
+      - 在任务文件中记录重构计划
+    inputs:
+      - 上一步的范围分析
+      - 项目架构
+    artifact_versioning:
+      inputs:
+        - name: analysis
+          pattern: "analysis.md | 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: 按计划执行重构。
+    recommended_agents:
+      - codex
+      - cursor
+    tasks:
+      - 创建重构分支
+      - 添加前置测试（如尚未存在）
+      - 增量执行重构步骤
+      - 每步后验证测试通过
+      - 更新受影响的文档或注释
+      - 确保代码遵循项目规范
+    inputs:
+      - 上一步的重构计划
+      - 项目编码标准
+    artifact_versioning:
+      outputs:
+        - name: implementation
+          pattern: "implementation.md | implementation-r{N}.md"
+          rule: "扫描现有实现产物；首轮创建 implementation.md，后续重实现创建 implementation-r{N}.md（N = 当前最高轮次 + 1）"
+    outputs:
+      - 包含变更的重构分支
+      - 更新或新增的测试文件
+      - 更新后的任务文件（实现备注）
+
+  - name: review
+    description: 验证重构是否保持了行为并提升了代码质量。
+    recommended_agents:
+      - claude
+    tasks:
+      - 验证功能等价性（除非有意改变，否则行为不变）
+      - 检查所有测试通过
+      - 验证代码质量提升
+      - 检查是否有遗漏的依赖项或使用者
+      - 评估性能影响（如适用）
+      - 创建审查报告
+    inputs:
+      - 重构分支
+      - 原始代码用于对比
+      - 测试结果
+    artifact_versioning:
+      inputs:
+        - name: implementation
+          pattern: "implementation.md | implementation-r{N}.md"
+          rule: "读取最高轮次的实现产物作为审查输入"
+      outputs:
+        - name: review
+          pattern: "review.md | review-r{N}.md"
+          rule: "扫描现有审查产物；首轮创建 review.md，后续轮次创建 review-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: 最终确认重构并创建拉取请求。
+    recommended_agents:
+      - claude
+      - human
+    tasks:
+      - 确保所有测试通过
+      - 编写清晰的提交信息说明重构内容
+      - 创建包含详细变更描述的拉取请求
+      - 将 PR 关联到相关 Issue
+      - 将任务移至已完成
+    inputs:
+      - 最终重构分支
+      - 任务文件
+    outputs:
+      - 拉取请求
+      - 已完成的任务文件（位于 .agent-workspace/completed/）

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

@@ -0,0 +1,154 @@
+# 重构工作流
+# 代码重构任务时使用此工作流。
+
+name: refactoring
+description: 安全且结构化的代码重构工作流。
+
+steps:
+  - name: analysis
+    description: 分析当前代码并确定重构范围。
+    recommended_agents:
+      - claude
+      - gemini
+    tasks:
+      - 识别待重构的代码及重构原因
+      - 映射受影响代码的所有依赖项和使用者
+      - 评估重构的风险和复杂度
+      - 识别受影响区域的现有测试覆盖
+      - 将发现记录在任务文件中
+    inputs:
+      - 重构请求或 Issue 描述
+      - 项目代码库
+    artifact_versioning:
+      outputs:
+        - name: analysis
+          pattern: "analysis.md | analysis-r{N}.md"
+          rule: "扫描现有分析产物；首轮创建 analysis.md，后续修订创建 analysis-r{N}.md（N = 当前最高轮次 + 1）"
+    outputs:
+      - 包含依赖关系图的范围分析
+      - 风险评估
+      - 更新后的任务文件（分析部分）
+
+  - name: design
+    description: 规划重构方案以最小化风险。
+    recommended_agents:
+      - claude
+    tasks:
+      - 定义目标架构或代码结构
+      - 规划增量重构步骤（避免一次性大改动）
+      - 识别应保持功能正常的中间状态
+      - 规划重构前需要的额外测试
+      - 在任务文件中记录重构计划
+    inputs:
+      - 上一步的范围分析
+      - 项目架构
+    artifact_versioning:
+      inputs:
+        - name: analysis
+          pattern: "analysis.md | 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: 按计划执行重构。
+    recommended_agents:
+      - codex
+      - cursor
+    tasks:
+      - 创建重构分支
+      - 添加前置测试（如尚未存在）
+      - 增量执行重构步骤
+      - 每步后验证测试通过
+      - 更新受影响的文档或注释
+      - 确保代码遵循项目规范
+    inputs:
+      - 上一步的重构计划
+      - 项目编码标准
+    artifact_versioning:
+      outputs:
+        - name: implementation
+          pattern: "implementation.md | implementation-r{N}.md"
+          rule: "扫描现有实现产物；首轮创建 implementation.md，后续重实现创建 implementation-r{N}.md（N = 当前最高轮次 + 1）"
+    outputs:
+      - 包含变更的重构分支
+      - 更新或新增的测试文件
+      - 更新后的任务文件（实现备注）
+
+  - name: review
+    description: 验证重构是否保持了行为并提升了代码质量。
+    recommended_agents:
+      - claude
+    tasks:
+      - 验证功能等价性（除非有意改变，否则行为不变）
+      - 检查所有测试通过
+      - 验证代码质量提升
+      - 检查是否有遗漏的依赖项或使用者
+      - 评估性能影响（如适用）
+      - 创建审查报告
+    inputs:
+      - 重构分支
+      - 原始代码用于对比
+      - 测试结果
+    artifact_versioning:
+      inputs:
+        - name: implementation
+          pattern: "implementation.md | implementation-r{N}.md"
+          rule: "读取最高轮次的实现产物作为审查输入"
+      outputs:
+        - name: review
+          pattern: "review.md | review-r{N}.md"
+          rule: "扫描现有审查产物；首轮创建 review.md，后续轮次创建 review-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: 最终确认重构并创建拉取请求。
+    recommended_agents:
+      - claude
+      - human
+    tasks:
+      - 确保所有测试通过
+      - 编写清晰的提交信息说明重构内容
+      - 创建包含详细变更描述的拉取请求
+      - 将 PR 关联到相关 Issue
+      - 将任务移至已完成
+    inputs:
+      - 最终重构分支
+      - 任务文件
+    outputs:
+      - 拉取请求
+      - 已完成的任务文件（位于 .agent-workspace/completed/）