@fitlab-ai/agent-infra 0.3.0

package/templates/.agents/skills/create-task/SKILL.md

@@ -0,0 +1,143 @@
+---
+name: create-task
+description: >
+  根据用户的自然语言描述创建任务骨架。当用户描述一个新功能、Bug 或改进需求时触发。
+  唯一的产出是 task.md —— 不编写任何业务代码。参数：任务描述文本。
+---
+
+# 创建任务
+
+## 行为边界 / 关键规则
+
+**本技能的唯一产出是 `task.md`。**
+
+- 不要编写、修改或创建任何业务代码或配置文件
+- 不要执行需求分析；分析由 `analyze-task` 独立完成
+- 不要直接实现所描述的功能
+- 不要跳过工作流直接进入计划/实现阶段
+- 仅执行：解析描述 -> 创建任务文件 -> 更新任务状态 -> 告知用户下一步
+
+用户的描述是一个**待办事项**，而不是**立即执行的指令**。
+
+执行本技能后，你**必须**立即更新 task.md 中的任务状态。
+
+## 执行步骤
+
+### 1. 解析用户描述
+
+从自然语言描述中提取：
+- **任务标题**：简洁标题（最多 50 个字符）
+- **任务类型**：`feature` | `bugfix` | `refactor` | `docs` | `chore`（从描述推断）
+- **工作流**：`feature-development` | `bug-fix` | `refactoring`（从类型推断）
+- **详细描述**：整理后的用户原始描述
+
+如果描述不清晰，**先向用户确认**再继续。
+
+**类型推断规则**：
+- 包含 "add"、"new"、"support"、"implement" -> `feature`
+- 包含 "fix"、"resolve"、"bug"、"error" -> `bugfix`
+- 包含 "refactor"、"optimize"、"improve"、"clean up" -> `refactor`
+- 包含 "document"、"javadoc"、"comment"、"readme" -> `docs`
+- 其他 -> `chore`
+
+**工作流映射**：
+- `feature` / `docs` / `chore` -> `feature-development`
+- `bugfix` -> `bug-fix`
+- `refactor` -> `refactoring`
+
+### 2. 创建任务目录和文件
+
+获取当前时间戳：
+
+```bash
+date +%Y%m%d-%H%M%S
+```
+
+- 创建任务目录：`.agent-workspace/active/TASK-{yyyyMMdd-HHmmss}/`
+- 使用 `.agents/templates/task.md` 模板创建任务文件：`task.md`
+
+**重要**：
+- 目录命名：`TASK-{yyyyMMdd-HHmmss}`（**必须**包含 `TASK-` 前缀）
+- 示例：`TASK-20260306-143022`
+- 任务 ID = 目录名
+
+任务元数据（task.md YAML front matter）：
+```yaml
+id: TASK-{yyyyMMdd-HHmmss}
+type: feature|bugfix|refactor|docs|chore
+workflow: feature-development|bug-fix|refactoring
+status: active
+created_at: {yyyy-MM-dd HH:mm:ss}
+updated_at: {yyyy-MM-dd HH:mm:ss}
+created_by: human
+current_step: requirement-analysis
+assigned_to: {当前 AI 代理}
+```
+
+注意：`created_by` 为 `human`，因为任务来源于用户的描述。
+
+### 3. 更新任务状态
+
+获取当前时间：
+
+```bash
+date "+%Y-%m-%d %H:%M:%S"
+```
+
+更新 `.agent-workspace/active/{task-id}/task.md`：
+- `current_step`：requirement-analysis
+- `assigned_to`：{当前 AI 代理}
+- `updated_at`：{当前时间}
+- **追加**到 `## Activity Log`（不要覆盖之前的记录）：
+  ```
+  - {yyyy-MM-dd HH:mm:ss} — **Task Created** by {agent} — Task created from description
+  ```
+
+### 4. 告知用户
+
+> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
+
+输出格式：
+```
+任务已创建。
+
+任务信息：
+- 任务 ID：{task-id}
+- 标题：{title}
+- 类型：{type}
+- 工作流：{workflow}
+
+产出文件：
+- 任务文件：.agent-workspace/active/{task-id}/task.md
+
+下一步 - 执行需求分析：
+  - Claude Code / OpenCode：/analyze-task {task-id}
+  - Gemini CLI：/agent-infra:analyze-task {task-id}
+  - Codex CLI：$analyze-task {task-id}
+```
+
+## 完成检查清单
+
+- [ ] 创建了任务文件 `.agent-workspace/active/{task-id}/task.md`
+- [ ] 更新了 task.md 中的 `current_step` 为 requirement-analysis
+- [ ] 更新了 task.md 中的 `updated_at` 为当前时间
+- [ ] 更新了 task.md 中的 `assigned_to`
+- [ ] 追加了 Activity Log 条目到 task.md
+- [ ] 告知了用户下一步（必须展示所有 TUI 的命令格式，不要筛选）
+- [ ] **没有修改任何业务代码或配置文件**（仅 task.md）
+
+## 停止
+
+完成检查清单后，**立即停止**。不要继续执行计划、实现或任何后续步骤。
+等待用户执行 `analyze-task` 技能。
+
+## 注意事项
+
+1. **清晰度**：如果用户描述模糊或缺少关键信息，先要求澄清
+2. **与 import-issue 的区别**：`import-issue` 从 GitHub Issue 导入任务；`create-task` 从自由描述创建
+3. **工作流顺序**：创建任务后，必须先执行 `analyze-task`，再进入 `plan-task`
+
+## 错误处理
+
+- 空描述：提示 "Please provide a task description"
+- 描述过于模糊：在创建任务之前提出澄清问题

package/templates/.agents/skills/create-task/SKILL.zh-CN.md

@@ -0,0 +1,143 @@
+---
+name: create-task
+description: >
+  根据用户的自然语言描述创建任务骨架。当用户描述一个新功能、Bug 或改进需求时触发。
+  唯一的产出是 task.md —— 不编写任何业务代码。参数：任务描述文本。
+---
+
+# 创建任务
+
+## 行为边界 / 关键规则
+
+**本技能的唯一产出是 `task.md`。**
+
+- 不要编写、修改或创建任何业务代码或配置文件
+- 不要执行需求分析；分析由 `analyze-task` 独立完成
+- 不要直接实现所描述的功能
+- 不要跳过工作流直接进入计划/实现阶段
+- 仅执行：解析描述 -> 创建任务文件 -> 更新任务状态 -> 告知用户下一步
+
+用户的描述是一个**待办事项**，而不是**立即执行的指令**。
+
+执行本技能后，你**必须**立即更新 task.md 中的任务状态。
+
+## 执行步骤
+
+### 1. 解析用户描述
+
+从自然语言描述中提取：
+- **任务标题**：简洁标题（最多 50 个字符）
+- **任务类型**：`feature` | `bugfix` | `refactor` | `docs` | `chore`（从描述推断）
+- **工作流**：`feature-development` | `bug-fix` | `refactoring`（从类型推断）
+- **详细描述**：整理后的用户原始描述
+
+如果描述不清晰，**先向用户确认**再继续。
+
+**类型推断规则**：
+- 包含 "add"、"new"、"support"、"implement" -> `feature`
+- 包含 "fix"、"resolve"、"bug"、"error" -> `bugfix`
+- 包含 "refactor"、"optimize"、"improve"、"clean up" -> `refactor`
+- 包含 "document"、"javadoc"、"comment"、"readme" -> `docs`
+- 其他 -> `chore`
+
+**工作流映射**：
+- `feature` / `docs` / `chore` -> `feature-development`
+- `bugfix` -> `bug-fix`
+- `refactor` -> `refactoring`
+
+### 2. 创建任务目录和文件
+
+获取当前时间戳：
+
+```bash
+date +%Y%m%d-%H%M%S
+```
+
+- 创建任务目录：`.agent-workspace/active/TASK-{yyyyMMdd-HHmmss}/`
+- 使用 `.agents/templates/task.md` 模板创建任务文件：`task.md`
+
+**重要**：
+- 目录命名：`TASK-{yyyyMMdd-HHmmss}`（**必须**包含 `TASK-` 前缀）
+- 示例：`TASK-20260306-143022`
+- 任务 ID = 目录名
+
+任务元数据（task.md YAML front matter）：
+```yaml
+id: TASK-{yyyyMMdd-HHmmss}
+type: feature|bugfix|refactor|docs|chore
+workflow: feature-development|bug-fix|refactoring
+status: active
+created_at: {yyyy-MM-dd HH:mm:ss}
+updated_at: {yyyy-MM-dd HH:mm:ss}
+created_by: human
+current_step: requirement-analysis
+assigned_to: {当前 AI 代理}
+```
+
+注意：`created_by` 为 `human`，因为任务来源于用户的描述。
+
+### 3. 更新任务状态
+
+获取当前时间：
+
+```bash
+date "+%Y-%m-%d %H:%M:%S"
+```
+
+更新 `.agent-workspace/active/{task-id}/task.md`：
+- `current_step`：requirement-analysis
+- `assigned_to`：{当前 AI 代理}
+- `updated_at`：{当前时间}
+- **追加**到 `## Activity Log`（不要覆盖之前的记录）：
+  ```
+  - {yyyy-MM-dd HH:mm:ss} — **Task Created** by {agent} — Task created from description
+  ```
+
+### 4. 告知用户
+
+> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
+
+输出格式：
+```
+任务已创建。
+
+任务信息：
+- 任务 ID：{task-id}
+- 标题：{title}
+- 类型：{type}
+- 工作流：{workflow}
+
+产出文件：
+- 任务文件：.agent-workspace/active/{task-id}/task.md
+
+下一步 - 执行需求分析：
+  - Claude Code / OpenCode：/analyze-task {task-id}
+  - Gemini CLI：/agent-infra:analyze-task {task-id}
+  - Codex CLI：$analyze-task {task-id}
+```
+
+## 完成检查清单
+
+- [ ] 创建了任务文件 `.agent-workspace/active/{task-id}/task.md`
+- [ ] 更新了 task.md 中的 `current_step` 为 requirement-analysis
+- [ ] 更新了 task.md 中的 `updated_at` 为当前时间
+- [ ] 更新了 task.md 中的 `assigned_to`
+- [ ] 追加了 Activity Log 条目到 task.md
+- [ ] 告知了用户下一步（必须展示所有 TUI 的命令格式，不要筛选）
+- [ ] **没有修改任何业务代码或配置文件**（仅 task.md）
+
+## 停止
+
+完成检查清单后，**立即停止**。不要继续执行计划、实现或任何后续步骤。
+等待用户执行 `analyze-task` 技能。
+
+## 注意事项
+
+1. **清晰度**：如果用户描述模糊或缺少关键信息，先要求澄清
+2. **与 import-issue 的区别**：`import-issue` 从 GitHub Issue 导入任务；`create-task` 从自由描述创建
+3. **工作流顺序**：创建任务后，必须先执行 `analyze-task`，再进入 `plan-task`
+
+## 错误处理
+
+- 空描述：提示 "Please provide a task description"
+- 描述过于模糊：在创建任务之前提出澄清问题

package/templates/.agents/skills/implement-task/SKILL.md

@@ -0,0 +1,229 @@
+---
+name: implement-task
+description: >
+  Implement a task based on the technical plan, write code and tests, and
+  output an implementation report. Triggered when the user requests task
+  implementation or coding after the technical plan has been reviewed and
+  approved. Argument: task-id.
+---
+
+# Implement Task
+
+## Boundary / Critical Rules
+
+- Strictly follow the latest technical plan artifact (`plan.md` or `plan-r{N}.md`) -- do not deviate without documenting the reason
+- Do NOT auto-commit. Never execute `git commit` or `git add` automatically
+- This skill outputs an implementation report (`implementation.md` or `implementation-r{N}.md`) and must never overwrite an existing round artifact
+- After executing this skill, you **must** immediately update task status in task.md
+
+## Steps
+
+### 1. Verify Prerequisites
+
+Check required files:
+- `.agent-workspace/active/{task-id}/task.md` - Task file
+- At least one technical plan artifact: `plan.md` or `plan-r{N}.md`
+
+Note: `{task-id}` format is `TASK-{yyyyMMdd-HHmmss}`, e.g. `TASK-20260306-143022`
+
+If either file is missing, prompt the user to complete the prerequisite step first.
+
+### 2. Determine the Input Plan and Implementation Round
+
+Scan `.agent-workspace/active/{task-id}/` for technical plan files (`plan.md`, `plan-r{N}.md`):
+- Read the highest-round plan file and record it as `{plan-artifact}`
+
+Scan `.agent-workspace/active/{task-id}/` for implementation report files:
+- If neither `implementation.md` nor `implementation-r*.md` exists -> this is Round 1 and must create `implementation.md`
+- If `implementation.md` exists and no `implementation-r*.md` exists -> this is Round 2 and must create `implementation-r2.md`
+- If `implementation-r{N}.md` exists -> this is Round N+1 and must create `implementation-r{N+1}.md`
+
+Record:
+- `{plan-artifact}`: the technical plan file used for this implementation
+- `{implementation-round}`: the current implementation round
+- `{implementation-artifact}`: the implementation report filename for this round
+
+Note: multi-round implementation should only happen after a review verdict of Rejected. A normal first implementation always creates `implementation.md`.
+
+### 3. Read Technical Plan
+
+Carefully read `{plan-artifact}` to understand:
+- Technical approach and solution strategy
+- Detailed implementation steps
+- Files to create/modify
+- Test strategy
+- Any constraints or risks
+
+### 4. Execute Code Implementation
+
+Follow the `implementation` step in `.agents/workflows/feature-development.yaml`:
+
+**Required tasks**:
+- [ ] Implement functionality code following the plan
+- [ ] Write comprehensive unit tests
+- [ ] Run tests locally to verify functionality
+- [ ] Update related documentation and comments
+- [ ] Follow project coding standards (see project instructions)
+
+**Implementation principles**:
+1. **Strictly follow the plan**: Do not deviate from the technical plan
+2. **Step by step**: Execute plan steps in order
+3. **Test continuously**: Run tests after completing each step
+4. **Keep it simple**: Do not over-engineer or add unplanned features
+
+### 5. Run Test Verification
+
+Execute the project's test command. Reference the `test` skill for the project-specific test command:
+
+```bash
+# Check .agents/skills/test/SKILL.md for the project's test command
+# Common patterns:
+# npm test          (Node.js)
+# mvn test          (Maven)
+# pytest            (Python)
+# go test ./...     (Go)
+```
+
+Ensure all tests pass. If tests fail, fix the issues before proceeding.
+
+### 6. Output Implementation Report
+
+Create `.agent-workspace/active/{task-id}/{implementation-artifact}`.
+
+Requirements:
+- Do not overwrite any existing implementation report
+- Record the actual round number and artifact filename in the report
+- If this is a re-implementation round, explain what triggered it
+
+### 7. Update Task Status
+
+Get the current time:
+
+```bash
+date "+%Y-%m-%d %H:%M:%S"
+```
+
+Update `.agent-workspace/active/{task-id}/task.md`:
+- `current_step`: implementation
+- `assigned_to`: {current AI agent}
+- `updated_at`: {current time}
+- Record the implementation artifact for this round: `{implementation-artifact}` (Round `{implementation-round}`)
+- Mark implementation as complete in workflow progress and include the actual round when the task template supports it
+- **Append** to `## Activity Log` (do NOT overwrite previous entries):
+  ```
+  - {yyyy-MM-dd HH:mm:ss} — **Implementation (Round {N})** by {agent} — Code implemented, {n} files modified, {n} tests passed → {artifact-filename}
+  ```
+
+### 8. Inform User
+
+> **IMPORTANT**: All TUI command formats listed below must be output in full. Do not show only the format for the current AI agent.
+
+Output format:
+```
+Implementation complete for task {task-id}.
+
+Summary:
+- Modified files: {count}
+- New files: {count}
+- Tests passed: {count}/{total}
+
+Output file:
+- Implementation report: .agent-workspace/active/{task-id}/{implementation-artifact} (Round {implementation-round})
+
+Next step - code review:
+  - Claude Code / OpenCode: /review-task {task-id}
+  - Gemini CLI: /{{project}}:review-task {task-id}
+  - Codex CLI: $review-task {task-id}
+```
+
+## Output Template
+
+```markdown
+# Implementation Report
+
+- **Implementation round**: Round {implementation-round}
+- **Artifact file**: `{implementation-artifact}`
+
+## Modified Files
+
+### New Files
+- `{file-path}` - {Description}
+
+### Modified Files
+- `{file-path}` - {Summary of changes}
+
+## Key Code Explanation
+
+### {Module/Feature Name}
+**File**: `{file-path}:{line-number}`
+
+**Implementation logic**:
+{Explanation of important logic}
+
+**Key code**:
+```{language}
+{Key code snippet}
+```
+
+## Test Results
+
+### Unit Tests
+- Test file: `{test-file-path}`
+- Test cases: {count}
+- Pass rate: {percentage}
+
+**Test output**:
+```
+{Test run results}
+```
+
+## Differences from Plan
+
+{If implementation differs from plan, explain why}
+
+## Items for Review
+
+**Points that need reviewer attention**:
+- {Attention point 1}
+- {Attention point 2}
+
+## Known Issues
+
+{Issues discovered during implementation or items to optimize later}
+
+## Next Steps
+
+{Suggestions for code review or follow-up work}
+```
+
+## Completion Checklist
+
+- [ ] Completed all code implementation
+- [ ] Created implementation report `.agent-workspace/active/{task-id}/{implementation-artifact}`
+- [ ] All tests pass
+- [ ] Updated `current_step` to implementation in task.md
+- [ ] Updated `updated_at` to current time in task.md
+- [ ] Updated `assigned_to` in task.md
+- [ ] Appended entry to Activity Log in task.md
+- [ ] Marked implementation as complete in workflow progress
+- [ ] Informed user of next step (must include all TUI command formats — do not filter)
+
+## STOP
+
+After completing the checklist, **stop**. Do not auto-commit. Wait for code review before submission.
+
+## Notes
+
+1. **Prerequisites**: Must have a reviewed technical plan (`plan.md` or `plan-r{N}.md` exists and is approved)
+2. **No auto-commit**: Do NOT execute `git commit` or `git add` automatically. Remind the user to commit manually
+3. **Test requirement**: All new code must have unit tests; test coverage must not decrease
+4. **Code quality**: Follow project coding standards
+5. **Plan deviation**: If you need to deviate from the plan, document the reason in the implementation report
+6. **Versioning rule**: First-round implementation uses `implementation.md`; later re-implementations use `implementation-r{N}.md`
+
+## Error Handling
+
+- Task not found: Prompt "Task {task-id} not found"
+- Missing plan: Prompt "Technical plan not found, please run the plan-task skill first"
+- Test failure: Output test errors, ask user whether to continue
+- Build failure: Output build errors, stop implementation