@fitlab-ai/agent-infra 0.3.0

package/templates/.agents/templates/handoff.zh-CN.md

@@ -0,0 +1,60 @@
+# 交接文档
+
+## 元数据
+
+- **任务 ID**：task-XXX
+- **交出方**：[AI 工具名称，例如 claude]
+- **接收方**：[AI 工具名称，例如 codex]
+- **已完成阶段**：[例如 analysis]
+- **下一阶段**：[例如 design]
+- **日期**：YYYY-MM-DD
+
+## 已完成工作摘要
+
+[简要总结在已完成阶段所取得的成果。]
+
+## 当前状态
+
+### 已修改的文件
+
+- `path/to/file1` - 修改内容及原因
+- `path/to/file2` - 修改内容及原因
+
+### 分支状态
+
+- **分支**：`feature/xxx`
+- **提交数**：[已提交次数]
+- **测试**：[通过 / 失败 / 尚未编写]
+
+### 关键决策
+
+1. [决策 1 及其理由]
+2. [决策 2 及其理由]
+
+## 后续步骤
+
+[接收方 AI 接下来应该做什么。请具体说明。]
+
+1. [ ] 步骤 1
+2. [ ] 步骤 2
+3. [ ] 步骤 3
+
+## 重要上下文
+
+[接收方 AI 需要了解的、代码中不明显的信息。]
+
+### 约束条件
+
+- [约束 1]
+- [约束 2]
+
+### 风险和关注点
+
+- [风险 1]
+- [风险 2]
+
+## 参考资料
+
+- 任务文件：`.agent-workspace/active/task-XXX.md`
+- 相关文档：[链接或文件路径]
+- 相关 Issue：#XXX

package/templates/.agents/templates/review-report.md

@@ -0,0 +1,67 @@
+# Code Review Report
+
+## Metadata
+
+- **Task ID**: task-XXX
+- **PR**: #XXX
+- **Branch**: `feature/xxx`
+- **Reviewer**: [AI tool name or human]
+- **Date**: YYYY-MM-DD
+- **Verdict**: [approve | request-changes | comment]
+
+## Summary
+
+[Brief summary of what was reviewed and the overall assessment.]
+
+## Files Reviewed
+
+| File | Status | Notes |
+|------|--------|-------|
+| `path/to/file1` | OK | - |
+| `path/to/file2` | Issues | See findings below |
+
+## Findings
+
+### Critical
+
+Issues that must be fixed before merging.
+
+- [ ] **[File:Line]** - Description of the critical issue.
+
+### Major
+
+Significant issues that should be addressed.
+
+- [ ] **[File:Line]** - Description of the major issue.
+
+### Minor
+
+Style, naming, or minor improvements.
+
+- [ ] **[File:Line]** - Description of the minor issue.
+
+### Suggestions
+
+Optional improvements for consideration.
+
+- [ ] **[File:Line]** - Suggestion description.
+
+## Test Coverage
+
+- [ ] New code has adequate test coverage
+- [ ] Existing tests still pass
+- [ ] Edge cases are covered
+- [ ] Error handling is tested
+
+## Checklist
+
+- [ ] Code follows project conventions
+- [ ] No security vulnerabilities introduced
+- [ ] No performance regressions
+- [ ] Documentation updated where needed
+- [ ] Commit messages follow conventions
+- [ ] No unnecessary files included
+
+## Additional Notes
+
+[Any other observations or recommendations.]

package/templates/.agents/templates/review-report.zh-CN.md

@@ -0,0 +1,67 @@
+# 代码审查报告
+
+## 元数据
+
+- **任务 ID**：task-XXX
+- **PR**：#XXX
+- **分支**：`feature/xxx`
+- **审查者**：[AI 工具名称或人员]
+- **日期**：YYYY-MM-DD
+- **结论**：[approve | request-changes | comment]
+
+## 摘要
+
+[简要总结审查内容和整体评估。]
+
+## 审查文件
+
+| 文件 | 状态 | 备注 |
+|------|------|------|
+| `path/to/file1` | 通过 | - |
+| `path/to/file2` | 有问题 | 见下方发现 |
+
+## 发现
+
+### 严重问题
+
+合并前必须修复的问题。
+
+- [ ] **[文件:行号]** - 严重问题描述。
+
+### 重要问题
+
+应该处理的重要问题。
+
+- [ ] **[文件:行号]** - 重要问题描述。
+
+### 次要问题
+
+代码风格、命名或细微改进。
+
+- [ ] **[文件:行号]** - 次要问题描述。
+
+### 建议
+
+可选的改进建议供参考。
+
+- [ ] **[文件:行号]** - 建议描述。
+
+## 测试覆盖
+
+- [ ] 新代码有足够的测试覆盖
+- [ ] 现有测试仍然通过
+- [ ] 边界情况已覆盖
+- [ ] 错误处理已测试
+
+## 检查清单
+
+- [ ] 代码遵循项目规范
+- [ ] 未引入安全漏洞
+- [ ] 无性能回归
+- [ ] 文档已按需更新
+- [ ] 提交信息遵循规范
+- [ ] 未包含不必要的文件
+
+## 补充说明
+
+[其他观察或建议。]

package/templates/.agents/templates/task.md

@@ -0,0 +1,65 @@
+---
+id: task-XXX
+type: feature          # feature | bugfix | refactor | docs | review
+workflow: feature-development  # feature-development | bug-fix | code-review | refactoring
+status: open           # open | in-progress | review | blocked | completed
+created_at: YYYY-MM-DD
+updated_at: YYYY-MM-DD
+current_step: analysis # analysis | design | implementation | review | fix | commit
+assigned_to: ""        # claude | codex | gemini | opencode | human
+---
+
+# Task: [Title]
+
+## Description
+
+[Describe the task clearly and concisely.]
+
+## Context
+
+- **Related Issue**: #XXX
+- **Related PR**: #XXX
+- **Branch**: `feature/xxx`
+
+## Requirements
+
+- [ ] Requirement 1
+- [ ] Requirement 2
+- [ ] Requirement 3
+
+## Analysis
+
+[Findings from the analysis phase. Which files are affected? What is the scope?]
+
+### Affected Files
+
+- `path/to/file1` - Description of changes
+- `path/to/file2` - Description of changes
+
+## Design
+
+[Technical approach. Interfaces, data flow, architecture decisions.]
+
+## Implementation Notes
+
+[Notes from the implementation phase. Decisions made, trade-offs, deviations from design.]
+
+## Review Feedback
+
+[Feedback from the review phase. Issues found, suggestions.]
+
+- [ ] Issue 1
+- [ ] Issue 2
+
+## Activity Log
+
+<!-- Append a new entry for each workflow step. Do NOT overwrite previous entries. -->
+<!-- Format: - {yyyy-MM-dd HH:mm} — **{step}** by {agent} — {brief summary} -->
+
+## Completion Checklist
+
+- [ ] All requirements met
+- [ ] Tests written and passing
+- [ ] Code reviewed
+- [ ] Documentation updated (if applicable)
+- [ ] PR created

package/templates/.agents/templates/task.zh-CN.md

@@ -0,0 +1,65 @@
+---
+id: task-XXX
+type: feature          # feature | bugfix | refactor | docs | review
+workflow: feature-development  # feature-development | bug-fix | code-review | refactoring
+status: open           # open | in-progress | review | blocked | completed
+created_at: YYYY-MM-DD
+updated_at: YYYY-MM-DD
+current_step: analysis # analysis | design | implementation | review | fix | commit
+assigned_to: ""        # claude | codex | gemini | opencode | human
+---
+
+# 任务：[标题]
+
+## 描述
+
+[清晰简洁地描述任务。]
+
+## 上下文
+
+- **关联 Issue**：#XXX
+- **关联 PR**：#XXX
+- **分支**：`feature/xxx`
+
+## 需求
+
+- [ ] 需求 1
+- [ ] 需求 2
+- [ ] 需求 3
+
+## 分析
+
+[分析阶段的发现。哪些文件受影响？范围是什么？]
+
+### 受影响的文件
+
+- `path/to/file1` - 变更描述
+- `path/to/file2` - 变更描述
+
+## 设计
+
+[技术方案。接口、数据流、架构决策。]
+
+## 实现备注
+
+[实现阶段的备注。做出的决策、权衡、与设计的偏差。]
+
+## 审查反馈
+
+[审查阶段的反馈。发现的问题、建议。]
+
+- [ ] 问题 1
+- [ ] 问题 2
+
+## 活动日志
+
+<!-- 每个工作流步骤追加一条新记录，不要覆盖之前的记录。 -->
+<!-- 格式：- {yyyy-MM-dd HH:mm} — **{步骤}** by {执行者} — {简要说明} -->
+
+## 完成检查清单
+
+- [ ] 所有需求已满足
+- [ ] 测试已编写并通过
+- [ ] 代码已审查
+- [ ] 文档已更新（如适用）
+- [ ] PR 已创建

package/templates/.agents/workflows/bug-fix.yaml

@@ -0,0 +1,149 @@
+# 缺陷修复工作流
+# 修复缺陷时使用此工作流。
+
+name: bug-fix
+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:
+      - 确保所有测试通过
+      - 编写引用缺陷/Issue 的提交信息
+      - 创建包含缺陷修复描述的拉取请求
+      - 将 PR 关联到缺陷报告 Issue
+      - 将任务移至已完成
+    inputs:
+      - 最终缺陷修复分支
+      - 任务文件
+    outputs:
+      - 拉取请求
+      - 已完成的任务文件（位于 .agent-workspace/completed/）

package/templates/.agents/workflows/bug-fix.zh-CN.yaml

@@ -0,0 +1,149 @@
+# 缺陷修复工作流
+# 修复缺陷时使用此工作流。
+
+name: bug-fix
+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:
+      - 确保所有测试通过
+      - 编写引用缺陷/Issue 的提交信息
+      - 创建包含缺陷修复描述的拉取请求
+      - 将 PR 关联到缺陷报告 Issue
+      - 将任务移至已完成
+    inputs:
+      - 最终缺陷修复分支
+      - 任务文件
+    outputs:
+      - 拉取请求
+      - 已完成的任务文件（位于 .agent-workspace/completed/）

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

@@ -0,0 +1,60 @@
+# Code Review Workflow
+# Use this workflow for reviewing pull requests or code changes.
+
+name: code-review
+description: Workflow for thorough code review of pull requests or branches.
+
+steps:
+  - name: analysis
+    description: Load context and understand the scope of changes.
+    recommended_agents:
+      - claude
+      - gemini
+    tasks:
+      - Read the PR description and linked issues
+      - Review the diff to understand what changed
+      - Identify the intent and scope of the changes
+      - Load relevant project conventions and standards
+    inputs:
+      - Pull request or branch to review
+      - Project conventions
+    outputs:
+      - Understanding of change scope
+      - List of files to review
+
+  - name: review
+    description: Perform a thorough code review.
+    recommended_agents:
+      - claude
+    tasks:
+      - Check code correctness and logic
+      - Verify adherence to project coding standards
+      - Check for security vulnerabilities
+      - Assess performance implications
+      - Verify test coverage and test quality
+      - Check documentation updates
+      - Look for edge cases and error handling
+      - Review commit messages
+    inputs:
+      - Code changes (diff)
+      - Project conventions
+      - Existing test suite
+    outputs:
+      - Review report with categorized findings
+      - Approval or change request
+
+  - name: report
+    description: Document and communicate review findings.
+    recommended_agents:
+      - claude
+    tasks:
+      - Create a review report from the template
+      - Categorize findings by severity (critical, major, minor, suggestion)
+      - Provide actionable feedback with specific file and line references
+      - Summarize overall assessment
+    inputs:
+      - Review findings from previous step
+      - Review report template
+    outputs:
+      - Completed review report
+      - PR comments (if applicable)