@fitlab-ai/agent-infra 0.3.2 → 0.4.1

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
@@ -19,7 +14,7 @@ description: >
 
 ### 1. Verify Task Exists
 
-Check that the task exists in `.agent-workspace/active/{task-id}/`.
+Check that the task exists in `.agents/workspace/active/{task-id}/`.
 
 Note: `{task-id}` format is `TASK-{yyyyMMdd-HHmmss}`, e.g. `TASK-20260306-143022`
 
@@ -61,7 +56,7 @@ Get the current time:
 date "+%Y-%m-%d %H:%M:%S"
 ```
 
-Update `.agent-workspace/active/{task-id}/task.md`:
+Update `.agents/workspace/active/{task-id}/task.md`:
 - `status`: completed
 - `completed_at`: {current timestamp}
 - `updated_at`: {current timestamp}
@@ -76,13 +71,13 @@ Update `.agent-workspace/active/{task-id}/task.md`:
 Move the task directory from active to completed:
 
 ```bash
-mv .agent-workspace/active/{task-id} .agent-workspace/completed/{task-id}
+mv .agents/workspace/active/{task-id} .agents/workspace/completed/{task-id}
 ```
 
 ### 5. Verify Archive
 
 ```bash
-ls .agent-workspace/completed/{task-id}/task.md
+ls .agents/workspace/completed/{task-id}/task.md
 ```
 
 Confirm the task directory was successfully moved.
@@ -111,7 +106,7 @@ Task {task-id} completed and archived.
 Task info:
 - Title: {title}
 - Completed at: {timestamp}
-- Archived to: .agent-workspace/completed/{task-id}/
+- Archived to: .agents/workspace/completed/{task-id}/
 
 Deliverables:
 - {List of key outputs: files modified, tests added, etc.}
@@ -121,7 +116,7 @@ Deliverables:
 
 - [ ] Verified all workflow steps are complete
 - [ ] Updated task.md with completed status and timestamp
-- [ ] Moved task directory to `.agent-workspace/completed/`
+- [ ] Moved task directory to `.agents/workspace/completed/`
 - [ ] Verified archive succeeded
 - [ ] Informed user of completion
 
@@ -135,7 +130,7 @@ Deliverables:
 
 2. **Rollback**: If a task was archived incorrectly:
    ```bash
-   mv .agent-workspace/completed/{task-id} .agent-workspace/active/{task-id}
+   mv .agents/workspace/completed/{task-id} .agents/workspace/active/{task-id}
    ```
    Then update task.md status back to `active`.
 

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

@@ -1,9 +1,6 @@
 ---
 name: complete-task
-description: >
-  标记任务完成并归档，将任务目录从 active/ 移动到 completed/。在允许完成之前，
-  验证所有工作流步骤已完成、代码已审查并提交、测试已通过。
-  当用户要求完成或归档任务时触发。参数：task-id。
+description: "标记任务完成并归档"
 ---
 
 # 完成任务
@@ -17,7 +14,7 @@ description: >
 
 ### 1. 验证任务存在
 
-检查任务是否存在于 `.agent-workspace/active/{task-id}/`。
+检查任务是否存在于 `.agents/workspace/active/{task-id}/`。
 
 注意：`{task-id}` 格式为 `TASK-{yyyyMMdd-HHmmss}`，例如 `TASK-20260306-143022`
 
@@ -59,7 +56,7 @@ Please complete the missing steps first, or use --force to override.
 date "+%Y-%m-%d %H:%M:%S"
 ```
 
-更新 `.agent-workspace/active/{task-id}/task.md`：
+更新 `.agents/workspace/active/{task-id}/task.md`：
 - `status`：completed
 - `completed_at`：{当前时间戳}
 - `updated_at`：{当前时间戳}
@@ -74,13 +71,13 @@ date "+%Y-%m-%d %H:%M:%S"
 将任务目录从 active 移动到 completed：
 
 ```bash
-mv .agent-workspace/active/{task-id} .agent-workspace/completed/{task-id}
+mv .agents/workspace/active/{task-id} .agents/workspace/completed/{task-id}
 ```
 
 ### 5. 验证归档
 
 ```bash
-ls .agent-workspace/completed/{task-id}/task.md
+ls .agents/workspace/completed/{task-id}/task.md
 ```
 
 确认任务目录已成功移动。
@@ -109,7 +106,7 @@ ls .agent-workspace/completed/{task-id}/task.md
 任务信息：
 - 标题：{title}
 - 完成时间：{timestamp}
-- 归档路径：.agent-workspace/completed/{task-id}/
+- 归档路径：.agents/workspace/completed/{task-id}/
 
 交付物：
 - {关键产出列表：修改的文件、添加的测试等}
@@ -119,7 +116,7 @@ ls .agent-workspace/completed/{task-id}/task.md
 
 - [ ] 验证了所有工作流步骤已完成
 - [ ] 更新了 task.md 的完成状态和时间戳
-- [ ] 将任务目录移动到 `.agent-workspace/completed/`
+- [ ] 将任务目录移动到 `.agents/workspace/completed/`
 - [ ] 验证了归档成功
 - [ ] 告知了用户完成情况
 
@@ -133,7 +130,7 @@ ls .agent-workspace/completed/{task-id}/task.md
 
 2. **回滚**：如果任务被错误归档：
    ```bash
-   mv .agent-workspace/completed/{task-id} .agent-workspace/active/{task-id}
+   mv .agents/workspace/completed/{task-id} .agents/workspace/active/{task-id}
    ```
    然后将 task.md 中的状态改回 `active`。