@fitlab-ai/agent-infra 0.4.0 → 0.4.1

package/templates/.agents/skills/commit/SKILL.zh-CN.md

@@ -1,138 +1,40 @@
 ---
 name: commit
-description: >
-  提交当前变更到 Git，包含版权头年份检查和任务状态更新。
-  当用户要求提交代码或保存变更时触发。
+description: "提交当前变更到 Git"
 ---
 
 # 提交代码
 
-提交当前变更到 Git。
+在不覆盖用户本地工作的前提下创建 Git commit，并在需要时更新关联任务状态。
 
-## 步骤 0：检查本地修改（关键）
+## 1. 检查本地修改（关键）
 
-**强制步骤**：在任何编辑之前，你**必须**检查用户的本地修改以避免覆盖其工作。
+在任何编辑前先检查：
 
 ```bash
 git status --short
 git diff
 ```
 
-**规则**：
-1. **仔细阅读 `git diff` 输出** —— 理解用户已经做了哪些修改
-2. **在用户修改基础上进行增量编辑** —— 不要覆盖其实现
-3. **如果你计划的编辑与用户修改冲突**，先询问用户：
-   ```
-   This file has local modifications:
-   - Your changes: [描述用户的修改]
-   - My planned changes: [描述计划的修改]
-   Please confirm how to proceed.
-   ```
-4. **不要**重写用户已实现的代码
-5. **不要**添加用户没有要求的"改进"
+必须尊重现有用户改动；如果你的计划与之冲突，先停止并征求确认。
 
-## 步骤 1：更新版权头年份（关键）
+## 2. 更新版权头年份
 
-**强制步骤**：提交之前，检查并更新所有修改文件的版权头。
+动态获取当前年份，只更新已经改动过的文件。
 
-### 获取当前年份
+> 完整版权检查流程见 `reference/copyright-check.md`。修改任何版权头前，先读取 `reference/copyright-check.md`。
 
-```bash
-date +%Y
-```
-
-**绝不硬编码年份。**
-
-### 检查修改的文件
-
-```bash
-git status --short
-```
-
-### 对每个修改的文件
-
-检查文件是否有版权头：
-```bash
-grep "Copyright.*[0-9]\{4\}" <modified_file>
-```
-
-如果有版权头且年份不是当前年份，更新年份。
-
-**常见格式**：
-- `Copyright (C) 2024-2025` -> `Copyright (C) 2024-{CURRENT_YEAR}`
-- `Copyright (C) 2024` -> `Copyright (C) 2024-{CURRENT_YEAR}`
-- `Copyright (C) 2025` -> `Copyright (C) {CURRENT_YEAR}`（如果已是当前年份）
-
-### 版权检查清单
-
-执行 `git commit` 之前：
-- [ ] 使用 `date +%Y` 动态获取当前年份
-- [ ] 检查了所有即将提交的文件
-- [ ] 更新了所有有版权头的文件的版权年份
-- [ ] **绝不**硬编码年份
-- [ ] **仅**更新修改的文件，而非整个项目
-
-## 步骤 2：分析变更并生成提交信息
-
-```bash
-git status
-git diff
-git log --oneline -5
-```
-
-生成 Conventional Commits 格式的提交信息：
-- `<type>(<scope>): <subject>`（英文祈使语气，不超过 50 字符）
-- Body：2-4 个要点说明修改了什么以及为什么
-- 署名块：
-  - `Co-Authored-By: {你的模型名称} <noreply@provider.com>`
-  - 如果与任务相关，追加其他贡献 Agent 的 `Co-Authored-By` 行
-
-### 多 Agent 协作署名（仅任务相关提交）
-
-如果本次提交属于某个活动任务，且存在 `.agents/workspace/active/{task-id}/task.md`：
-
-1. 读取 `task.md` 中的 `## Activity Log` 部分。
-2. 从符合 `by {agent}` 的条目中提取所有唯一 Agent 名称；可使用较宽松的匹配模式，例如 `by (\S+)`。
-3. 排除 `human`，因为 Git author 已经是人类用户。
-4. 将 Agent 名称映射为 `Co-Authored-By` 行：
-
-| Agent | 署名 |
-|-------|------|
-| `claude` | `Co-Authored-By: Claude <noreply@anthropic.com>` |
-| `codex` | `Co-Authored-By: Codex <noreply@openai.com>` |
-| `gemini` | `Co-Authored-By: Gemini <noreply@google.com>` |
-| `opencode` | `Co-Authored-By: OpenCode <noreply@opencode.ai>` |
-
-5. 构建署名块时遵循以下规则：
-   - 保持当前执行提交的 Agent 署名在原有位置。
-   - 将其他唯一参与 Agent 作为额外的 `Co-Authored-By` 行追加。
-   - 如果当前 Agent 已在 `Activity Log` 中出现，不要重复追加。
-   - 未知 Agent 名称使用兜底格式 `Co-Authored-By: {Agent} <noreply@unknown>`。
-
-如果本次提交与任务无关，保持原有单行署名行为不变。
-
-## 步骤 3：创建提交
+## 3. 生成提交信息
 
-```bash
-git add <specific-files>
-git commit -m "$(cat <<'EOF'
-<type>(<scope>): <subject>
+检查状态、diff 和最近历史，然后按 Conventional Commits 生成 message，并补齐正确的协作署名。
 
-- <要点 1>
-- <要点 2>
+> 提交信息规则、示例和多代理署名细节见 `reference/commit-message.md`。写 commit message 前先读取 `reference/commit-message.md`。
 
-Co-Authored-By: {你的模型名称} <noreply@provider.com>
-<其他任务参与者的额外 Co-Authored-By 行（如有）>
-EOF
-)"
-```
+## 4. 创建提交
 
-**重要**：
-- 按名称添加特定文件 —— 不要使用 `git add -A` 或 `git add .`
-- 不要提交可能包含密钥的文件（.env、凭据、密钥）
-- 对于任务相关提交，保持当前 Agent 署名在前，并在其后追加上面生成的额外署名行
+只暂存明确列出的文件，然后执行 `git commit`。
 
-## 步骤 4：更新任务状态（如果与任务相关）
+## 5. 按需更新任务状态
 
 获取当前时间：
 
@@ -140,93 +42,20 @@ EOF
 date "+%Y-%m-%d %H:%M:%S"
 ```
 
-提交后，根据情况更新任务状态：
-
-对于以下所有情况，**追加**到 task.md 的 `## Activity Log`（不要覆盖之前的记录）：
-```
-- {yyyy-MM-dd HH:mm:ss} — **Commit** by {agent} — {commit hash short} {commit subject}
-```
-
-> **⚠️ 情况判断 — 你必须先核对任务状态，再从下面 4 种情况中精确匹配唯一分支：**
->
-> - 检查 `task.md` 的 `current_step`、工作流进度和 `## Activity Log` 最新记录
-> - 检查是否存在最新 `review.md` / `review-r{N}.md`，以及最新审查是否为“通过且无问题”
-> - 检查是否仍有待处理的修复、审查或 PR 创建步骤
->
-> | 判断依据 | 必须选择的情况 |
-> |---------|---------------|
-> | 所有工作流步骤完成 + 最新审查通过且无问题 + 所有测试通过 | 情况 1：最终提交 |
-> | 仍有未完成步骤、待修复问题或等待他人动作 | 情况 2：还有后续工作 |
-> | 当前提交的目的就是把实现/修复结果送入代码审查 | 情况 3：准备审查 |
-> | 代码已提交且审查已完成，下一步应创建 PR | 情况 4：准备创建 PR |
->
-> **禁止同时套用多个情况。必须先判断，再输出唯一匹配的下一步。**
-
-### 情况 1：最终提交（触发条件：所有工作已完成，下一步是归档任务）
-
-如果这是最后一次提交且所有工作已完成：
-
-前置条件：
-- [ ] 所有代码已提交
-- [ ] 所有测试通过
-- [ ] 代码审查通过
-- [ ] 所有工作流步骤完成
-
-建议下一步：
-
-> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
-
-```
-下一步 - 完成并归档任务：
-  - Claude Code / OpenCode：/complete-task {task-id}
-  - Gemini CLI：/{{project}}:complete-task {task-id}
-  - Codex CLI：$complete-task {task-id}
-```
-
-### 情况 2：还有后续工作（触发条件：仍有未完成步骤、待修复项或待协作事项）
+> 完整的 4 种状态分支、前置条件检查和多 TUI 下一步命令见 `reference/task-status-update.md`。更新任务状态前，先读取 `reference/task-status-update.md`。
 
-如果有后续工作（等待审查、需要更多修复）：
-- 更新 `task.md`：设置 `updated_at` 为当前时间
-- 在 task.md 中记录此次提交的内容和下一步
+追加 Commit 的 Activity Log，并且只能选择一个下一步分支：
+- 最终提交 -> `complete-task {task-id}`
+- 还有后续工作 -> 更新 task.md 后停止
+- 准备审查 -> `review-task {task-id}`
+- 准备创建 PR -> `create-pr`
 
-### 情况 3：准备审查（触发条件：下一步应执行 `review-task`）
-
-如果提交已准备好进行代码审查：
-- 更新 `task.md`：设置 `current_step` 为 `code-review`
-- 更新 `task.md`：设置 `updated_at` 为当前时间
-- 在工作流进度中标记 implementation 步骤为已完成
-
-建议下一步：
-
-> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
-
-```
-下一步 - 代码审查：
-  - Claude Code / OpenCode：/review-task {task-id}
-  - Gemini CLI：/{{project}}:review-task {task-id}
-  - Codex CLI：$review-task {task-id}
-```
-
-### 情况 4：准备创建 PR（触发条件：下一步应执行 `create-pr`）
-
-如果提交应该创建 Pull Request：
-- 更新 `task.md`：设置 `updated_at` 为当前时间
-- 在 task.md 中记录 PR 计划
-
-建议下一步：
+## 注意事项
 
-> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
+- 不要提交 `.env`、凭据、密钥等敏感文件
+- 协作署名中当前代理必须排在最前面
+- 不要使用 `git add -A` 或 `git add .`
 
-```
-下一步 - 创建 Pull Request：
-  - Claude Code / OpenCode：/create-pr
-  - Gemini CLI：/{{project}}:create-pr
-  - Codex CLI：$create-pr
-```
-
-## 注意事项
+## 错误处理
 
-- 不要提交包含敏感信息的文件（.env、凭据等）
-- 确保提交信息清晰描述变更内容
-- 遵循项目的 Conventional Commits 规范
-- 如果任务状态更新失败，警告用户但不要阻止提交
+- 如果任务状态更新失败，警告用户，但不要因此阻止提交

package/templates/.agents/skills/commit/reference/commit-message.md

@@ -0,0 +1,60 @@
+# Commit Message Rules
+
+Read this file before staging files or composing the commit message.
+
+## Analyze Changes and Generate the Commit Message
+
+```bash
+git status
+git diff
+git log --oneline -5
+```
+
+Generate a Conventional Commit:
+- `<type>(<scope>): <subject>`
+- imperative English subject, under 50 characters
+- 2-4 body bullets describing what changed and why
+
+### Multi-Agent Co-Authorship
+
+If the commit belongs to an active task:
+1. read `## Activity Log` in task.md
+2. collect unique agent names from `by {agent}`
+3. exclude `human`
+4. map agents to `Co-Authored-By` lines
+
+| Agent | Co-Authored-By line |
+|---|---|
+| `claude` | `Co-Authored-By: Claude <noreply@anthropic.com>` |
+| `codex` | `Co-Authored-By: Codex <noreply@openai.com>` |
+| `gemini` | `Co-Authored-By: Gemini <noreply@google.com>` |
+| `opencode` | `Co-Authored-By: OpenCode <noreply@opencode.ai>` |
+
+Build the co-author block with these rules:
+1. keep the current executing agent first
+2. append other unique participating agents after it
+3. if the current agent already appears in Activity Log, do not add a duplicate line
+4. de-duplicate all additional `Co-Authored-By` lines
+5. map unknown agents to `Co-Authored-By: {Agent} <noreply@unknown>`
+
+## Create the Commit
+
+```bash
+git add <specific-files>
+git commit -m "$(cat <<'EOF'
+<type>(<scope>): <subject>
+
+- <bullet point 1>
+- <bullet point 2>
+
+Co-Authored-By: {Your Model Name} <noreply@provider.com>
+<additional Co-Authored-By lines>
+EOF
+)"
+```
+
+Important:
+- add specific files only
+- do not use `git add -A` or `git add .`
+- do not include secrets
+- keep the current agent first in the co-author block

package/templates/.agents/skills/commit/reference/commit-message.zh-CN.md

@@ -0,0 +1,60 @@
+# 提交信息规则
+
+在暂存文件或编写 commit message 之前先读取本文件。
+
+## 分析变更并生成提交信息
+
+```bash
+git status
+git diff
+git log --oneline -5
+```
+
+生成 Conventional Commit：
+- `<type>(<scope>): <subject>`
+- `subject` 必须使用英文祈使句，且不超过 50 个字符
+- 正文使用 2-4 条 bullet，说明改了什么以及为什么改
+
+### 多 Agent 共同署名
+
+如果该提交属于一个活动中的任务：
+1. 读取 task.md 中的 `## Activity Log`
+2. 从 `by {agent}` 中收集去重后的 agent 名称
+3. 排除 `human`
+4. 将 agent 映射为 `Co-Authored-By` 行
+
+| Agent | Co-Authored-By 行 |
+|---|---|
+| `claude` | `Co-Authored-By: Claude <noreply@anthropic.com>` |
+| `codex` | `Co-Authored-By: Codex <noreply@openai.com>` |
+| `gemini` | `Co-Authored-By: Gemini <noreply@google.com>` |
+| `opencode` | `Co-Authored-By: OpenCode <noreply@opencode.ai>` |
+
+按以下规则构建 co-author 区块：
+1. 当前执行的 agent 必须放在第一行
+2. 其余参与过的唯一 agent 追加在后面
+3. 如果当前 agent 已经出现在 Activity Log 中，不要重复追加同一行
+4. 所有额外的 `Co-Authored-By` 行都要去重
+5. 未知 agent 统一映射为 `Co-Authored-By: {Agent} <noreply@unknown>`
+
+## 创建提交
+
+```bash
+git add <specific-files>
+git commit -m "$(cat <<'EOF'
+<type>(<scope>): <subject>
+
+- <bullet point 1>
+- <bullet point 2>
+
+Co-Authored-By: {Your Model Name} <noreply@provider.com>
+<additional Co-Authored-By lines>
+EOF
+)"
+```
+
+重要约束：
+- 只能添加明确指定的文件
+- 不要使用 `git add -A` 或 `git add .`
+- 不要提交任何敏感信息
+- co-author 区块必须把当前 agent 放在第一行

package/templates/.agents/skills/commit/reference/copyright-check.md

@@ -0,0 +1,39 @@
+# Copyright Check
+
+Read this file before editing any copyright header.
+
+## Update Copyright Header Years
+
+### Get Current Year
+
+```bash
+date +%Y
+```
+
+### Check Modified Files
+
+```bash
+git status --short
+```
+
+### For Each Modified File
+
+Check whether the file contains a copyright header:
+
+```bash
+grep "Copyright.*[0-9]\{4\}" <modified_file>
+```
+
+If a header exists and the year is outdated, update it using the current year.
+
+Common update patterns:
+- `Copyright (C) 2024-2025` -> `Copyright (C) 2024-{CURRENT_YEAR}`
+- `Copyright (C) 2024` -> `Copyright (C) 2024-{CURRENT_YEAR}`
+- `Copyright (C) 2025` -> `Copyright (C) {CURRENT_YEAR}` when the file already uses the current year
+
+### Copyright Checklist
+
+- [ ] Use `date +%Y`
+- [ ] Check every modified file
+- [ ] Update only modified files
+- [ ] Never hardcode the current year

package/templates/.agents/skills/commit/reference/copyright-check.zh-CN.md

@@ -0,0 +1,39 @@
+# 版权检查
+
+在修改任何版权头之前先读取本文件。
+
+## 更新版权头年份（关键）
+
+### 获取当前年份
+
+```bash
+date +%Y
+```
+
+### 检查已修改文件
+
+```bash
+git status --short
+```
+
+### 对每个已修改文件执行
+
+检查文件是否包含版权头：
+
+```bash
+grep "Copyright.*[0-9]\{4\}" <modified_file>
+```
+
+如果存在版权头且年份已过期，必须使用当前年份更新。
+
+常见更新模式：
+- `Copyright (C) 2024-2025` -> `Copyright (C) 2024-{CURRENT_YEAR}`
+- `Copyright (C) 2024` -> `Copyright (C) 2024-{CURRENT_YEAR}`
+- `Copyright (C) 2025` -> 如果文件已经使用当前年份，则更新为 `Copyright (C) {CURRENT_YEAR}`
+
+### 版权检查清单
+
+- [ ] 使用 `date +%Y`
+- [ ] 检查每一个已修改文件
+- [ ] 只更新已修改文件
+- [ ] 绝对不要硬编码当前年份

package/templates/.agents/skills/commit/reference/task-status-update.md

@@ -0,0 +1,88 @@
+# Task Status Update
+
+Read this file before choosing the post-commit task-state branch.
+
+## Update the Related Task State
+
+Get the current time first:
+
+```bash
+date "+%Y-%m-%d %H:%M:%S"
+```
+
+For every task-related commit, append this Activity Log entry in `task.md`:
+
+```text
+- {yyyy-MM-dd HH:mm:ss} — **Commit** by {agent} — {commit hash short} {commit subject}
+```
+
+Before selecting the next step, verify:
+- `current_step` and the latest workflow progress in `task.md`
+- whether the latest `review.md` / `review-r{N}.md` passed without findings
+- whether there are still pending fixes, review work, or PR creation steps
+
+Choose exactly one case:
+
+| Decision Basis | Required Case |
+|---|---|
+| all workflow steps completed + latest review approved with no findings + all tests passed | Case 1: final commit |
+| unfinished steps, pending fixes, or waiting on others still exist | Case 2: more work remains |
+| this commit prepares the task for code review | Case 3: ready for review |
+| code is committed, review is done, and the next step is PR creation | Case 4: ready for PR |
+
+Never apply more than one case. Match the single next-step branch first, then update the task.
+
+### Case 1: Final Commit
+
+Prerequisites:
+- [ ] all code committed
+- [ ] all tests passed
+- [ ] code review approved
+- [ ] all workflow steps completed
+
+Required next-step commands:
+
+```text
+Next step - complete and archive the task:
+  - Claude Code / OpenCode: /complete-task {task-id}
+  - Gemini CLI: /agent-infra:complete-task {task-id}
+  - Codex CLI: $complete-task {task-id}
+```
+
+### Case 2: More Work Remains
+
+If more work is still pending:
+- update `updated_at` in `task.md`
+- record what this commit finished
+- record what the next human or agent action is
+
+### Case 3: Ready for Review
+
+If this commit hands work over to code review:
+- update `current_step` to `code-review`
+- update `updated_at`
+- mark implementation as finished in the workflow state
+
+Required next-step commands:
+
+```text
+Next step - code review:
+  - Claude Code / OpenCode: /review-task {task-id}
+  - Gemini CLI: /agent-infra:review-task {task-id}
+  - Codex CLI: $review-task {task-id}
+```
+
+### Case 4: Ready for PR
+
+If the next step is Pull Request creation:
+- update `updated_at`
+- record the PR plan in `task.md`
+
+Required next-step commands:
+
+```text
+Next step - create Pull Request:
+  - Claude Code / OpenCode: /create-pr
+  - Gemini CLI: /agent-infra:create-pr
+  - Codex CLI: $create-pr
+```

package/templates/.agents/skills/commit/reference/task-status-update.zh-CN.md

@@ -0,0 +1,88 @@
+# 任务状态更新
+
+在选择提交后的任务状态分支之前先读取本文件。
+
+## 更新关联任务状态
+
+先获取当前时间：
+
+```bash
+date "+%Y-%m-%d %H:%M:%S"
+```
+
+对于每一次与任务相关的提交，都要在 `task.md` 中追加以下 Activity Log：
+
+```text
+- {yyyy-MM-dd HH:mm:ss} — **Commit** by {agent} — {commit hash short} {commit subject}
+```
+
+在决定下一步之前，先确认：
+- `task.md` 中的 `current_step` 和最新工作流进度
+- 最新的 `review.md` / `review-r{N}.md` 是否无问题通过
+- 是否仍然存在待修复项、待审查工作或待创建 PR 的步骤
+
+必须且只能选择一个分支：
+
+| 判断依据 | 必选分支 |
+|---|---|
+| 所有工作流步骤都已完成 + 最新审查无问题通过 + 所有测试通过 | 场景 1：最终提交 |
+| 仍有未完成步骤、待修复项或等待他人的动作 | 场景 2：还有后续工作 |
+| 这次提交是为了把任务交给代码审查 | 场景 3：准备进入审查 |
+| 代码已提交、审查已完成，下一步是创建 PR | 场景 4：准备创建 PR |
+
+绝对不要同时套用多个分支。先匹配唯一的下一步分支，再更新任务。
+
+### 场景 1：最终提交
+
+前置条件：
+- [ ] 所有代码都已提交
+- [ ] 所有测试通过
+- [ ] 代码审查已通过
+- [ ] 所有工作流步骤已完成
+
+必带下一步命令：
+
+```text
+下一步 - 完成并归档任务：
+  - Claude Code / OpenCode: /complete-task {task-id}
+  - Gemini CLI: /agent-infra:complete-task {task-id}
+  - Codex CLI: $complete-task {task-id}
+```
+
+### 场景 2：还有后续工作
+
+如果仍有工作待完成：
+- 更新 `task.md` 中的 `updated_at`
+- 记录这次提交完成了什么
+- 记录下一位人类或 agent 需要继续做什么
+
+### 场景 3：准备进入审查
+
+如果这次提交把工作移交给代码审查：
+- 将 `current_step` 更新为 `code-review`
+- 更新 `updated_at`
+- 在工作流状态中标记实现阶段已完成
+
+必带下一步命令：
+
+```text
+下一步 - 代码审查：
+  - Claude Code / OpenCode: /review-task {task-id}
+  - Gemini CLI: /agent-infra:review-task {task-id}
+  - Codex CLI: $review-task {task-id}
+```
+
+### 场景 4：准备创建 PR
+
+如果下一步是创建 Pull Request：
+- 更新 `updated_at`
+- 在 `task.md` 中记录 PR 计划
+
+必带下一步命令：
+
+```text
+下一步 - 创建 Pull Request：
+  - Claude Code / OpenCode: /create-pr
+  - Gemini CLI: /agent-infra:create-pr
+  - Codex CLI: $create-pr
+```

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

@@ -1,11 +1,6 @@
 ---
 name: complete-task
-description: >
-  Mark a task as completed and archive it by moving the task directory from
-  active/ to completed/. Verifies that all workflow steps are done, code is
-  reviewed and committed, and tests pass before allowing completion.
-  Triggered when the user requests task completion or archiving.
-  Argument: task-id.
+description: "Mark a task as completed and archive it"
 ---
 
 # Complete Task

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

@@ -1,9 +1,6 @@
 ---
 name: complete-task
-description: >
-  标记任务完成并归档，将任务目录从 active/ 移动到 completed/。在允许完成之前，
-  验证所有工作流步骤已完成、代码已审查并提交、测试已通过。
-  当用户要求完成或归档任务时触发。参数：task-id。
+description: "标记任务完成并归档"
 ---
 
 # 完成任务