@fitlab-ai/agent-infra 0.3.2 → 0.4.1

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

@@ -1,102 +1,63 @@
 ---
 name: implement-task
-description: >
-  根据技术方案实施任务，编写代码和测试，输出实现报告。当用户在技术方案审查通过后要求实施任务或编码时触发。
-  参数：task-id。
+description: "根据技术方案实施任务并输出报告"
 ---
 
 # 实施任务
 
+根据已批准的技术方案实施任务，并产出 `implementation.md` 或 `implementation-r{N}.md`。
+
 ## 行为边界 / 关键规则
 
-- 严格遵循最新技术方案产物（`plan.md` 或 `plan-r{N}.md`）—— 不要偏离，除非记录了偏离原因
-- 不要自动提交。绝不自动执行 `git commit` 或 `git add`
-- 本技能产出实现报告（`implementation.md` 或 `implementation-r{N}.md`）—— 不覆盖已有轮次产物
-- 执行本技能后，你**必须**立即更新 task.md 中的任务状态
+- 严格遵循最新方案产物：`plan.md` 或 `plan-r{N}.md`
+- 绝不自动执行 `git add` 或 `git commit`
+- 每轮实现都创建新的实现产物，不覆盖旧文件
+- 执行本技能后，你**必须**立即更新 task.md
 
 ## 执行步骤
 
 ### 1. 验证前置条件
 
-检查必要文件：
-- `.agent-workspace/active/{task-id}/task.md` - 任务文件
+先检查：
+- `.agents/workspace/active/{task-id}/task.md`
 - 至少一个技术方案产物：`plan.md` 或 `plan-r{N}.md`
 
-注意：`{task-id}` 格式为 `TASK-{yyyyMMdd-HHmmss}`，例如 `TASK-20260306-143022`
-
-如果任一文件缺失，提示用户先完成前置步骤。
+如果缺少任一文件，立即停止并提示用户先完成前置步骤。
 
 ### 2. 确定输入方案与实现轮次
 
-扫描 `.agent-workspace/active/{task-id}/` 目录中的技术方案文件（`plan.md`、`plan-r{N}.md`）：
-- 读取最高轮次的方案文件，记为 `{plan-artifact}`
-
-扫描 `.agent-workspace/active/{task-id}/` 目录中的实现报告文件：
-- 如果不存在 `implementation.md` 且不存在 `implementation-r*.md` → 本轮为第 1 轮，产出 `implementation.md`
-- 如果存在 `implementation.md` 且不存在 `implementation-r*.md` → 本轮为第 2 轮，产出 `implementation-r2.md`
-- 如果存在 `implementation-r{N}.md` → 本轮为第 N+1 轮，产出 `implementation-r{N+1}.md`
+扫描 `.agents/workspace/active/{task-id}/` 并记录：
+- 最高轮次的方案文件为 `{plan-artifact}`
+- 本轮实现产物为 `implementation.md` 或 `implementation-r{N}.md`
+- `{implementation-round}` 与 `{implementation-artifact}`
 
-记录：
-- `{plan-artifact}`：本次实现遵循的技术方案文件
-- `{implementation-round}`：本轮实现轮次
-- `{implementation-artifact}`：本轮实现报告文件名
-
-注意：仅在审查结论为“拒绝”后重新执行时才会进入多轮。正常首次实现始终产出 `implementation.md`。
+如果存在 `plan-r{N}.md`，读取最高轮次的方案文件；否则读取 `plan.md`。
 
 ### 3. 阅读技术方案
 
-仔细阅读 `{plan-artifact}` 以理解：
-- 技术方法和解决策略
-- 详细实施步骤
-- 需要创建/修改的文件
+仔细阅读 `{plan-artifact}`，提取：
+- 实施步骤
+- 需要创建或修改的文件
 - 测试策略
-- 任何约束或风险
+- 约束、风险与已批准的取舍
 
 ### 4. 执行代码实现
 
-遵循 `.agents/workflows/feature-development.yaml` 中的 `implementation` 步骤：
-
-**必要任务**：
-- [ ] 按照计划实现功能代码
-- [ ] 编写全面的单元测试
-- [ ] 在本地运行测试以验证功能
-- [ ] 更新相关文档和注释
-- [ ] 遵循项目编码规范（参见项目指南）
+按照 `.agents/workflows/feature-development.yaml` 和方案顺序实施。
 
-**实现原则**：
-1. **严格遵循计划**：不偏离技术方案
-2. **逐步执行**：按顺序执行计划步骤
-3. **持续测试**：每完成一个步骤后运行测试
-4. **保持简单**：不过度设计，不添加计划外的功能
+> 详细实现规则、测试纪律和偏离处理见 `reference/implementation-rules.md`。执行此步骤前，先读取 `reference/implementation-rules.md`。
 
 ### 5. 运行测试验证
 
-执行项目的测试命令。参考 `test` 技能获取项目特定的测试命令：
+使用 `test` 技能中的项目测试命令，直到所有必需测试通过。
 
-```bash
-# 查看 .agents/skills/test/SKILL.md 获取项目测试命令
-# 常见模式：
-# npm test          (Node.js)
-# mvn test          (Maven)
-# pytest            (Python)
-# go test ./...     (Go)
-```
-
-如果测试失败：
-- 先分析失败原因，优先修复由本次实现引入的问题，以及为匹配已批准方案而需要同步调整的测试或文档
-- 修复后重新运行测试，直到测试通过，或明确确认存在超出当前任务范围的外部阻塞
-- 仅当问题属于外部阻塞、环境缺失或需求不明确且无法在当前任务内解决时，才向用户报告阻塞并停止；此时不要创建实现报告，不要更新 task.md 为实现完成，也不要输出步骤 8 的完成模板
+如果测试失败，先尝试修复并重新运行测试。只有在确认存在外部阻塞、环境缺失或需求不明确且超出任务范围时，才可以停止。
 
-只有全部测试通过后，才可以继续步骤 6、7 和 8。
+### 6. 编写实现报告
 
-### 6. 输出实现报告
+创建 `.agents/workspace/active/{task-id}/{implementation-artifact}`。
 
-创建 `.agent-workspace/active/{task-id}/{implementation-artifact}`。
-
-要求：
-- 不要覆盖已有的实现报告
-- 在报告中明确记录本轮轮次编号和实际产物文件名
-- 如果本轮是重实现，说明其触发原因（例如上一轮审查结论为 Rejected）
+> 报告结构、必填章节和完整模板见 `reference/report-template.md`。写报告前先读取 `reference/report-template.md`。
 
 ### 7. 更新任务状态
 
@@ -106,127 +67,38 @@ description: >
 date "+%Y-%m-%d %H:%M:%S"
 ```
 
-更新 `.agent-workspace/active/{task-id}/task.md`：
+更新 `.agents/workspace/active/{task-id}/task.md`：
 - `current_step`：implementation
-- `assigned_to`：{当前 AI 代理}
+- `assigned_to`：{当前代理}
 - `updated_at`：{当前时间}
-- 记录本轮实现产物：`{implementation-artifact}`（Round `{implementation-round}`）
-- 在工作流进度中标记 implementation 为已完成，并注明实际轮次（如果任务模板支持）
-- **追加**到 `## Activity Log`（不要覆盖之前的记录）：
-  ```
-  - {yyyy-MM-dd HH:mm:ss} — **Implementation (Round {N})** by {agent} — Code implemented, {n} files modified, {n} tests passed → {artifact-filename}
-  ```
+- 记录 Round `{implementation-round}` 的 `{implementation-artifact}`
+- 追加：
+  `- {yyyy-MM-dd HH:mm:ss} — **Implementation (Round {N})** by {agent} — Code implemented, {n} files modified, {n} tests passed → {implementation-artifact}`
 
 ### 8. 告知用户
 
-> **重要**：以下「下一步」中列出的所有 TUI 命令格式必须完整输出，不要只展示当前 AI 代理对应的格式。
-
-输出格式：
-```
-任务 {task-id} 实现完成。
-
-摘要：
-- 修改文件：{数量}
-- 新建文件：{数量}
-- 测试通过：{数量}/{总数}
-
-产出文件：
-- 实现报告：.agent-workspace/active/{task-id}/{implementation-artifact}（Round {implementation-round}）
-
-下一步 - 代码审查：
-  - Claude Code / OpenCode：/review-task {task-id}
-  - Gemini CLI：/{{project}}:review-task {task-id}
-  - Codex CLI：$review-task {task-id}
-```
-
-## 输出模板
-
-```markdown
-# 实现报告
-
-- **实现轮次**：Round {implementation-round}
-- **产物文件**：`{implementation-artifact}`
-
-## 修改文件
-
-### 新建文件
-- `{file-path}` - {描述}
-
-### 修改文件
-- `{file-path}` - {变更摘要}
-
-## 关键代码说明
-
-### {模块/功能名称}
-**文件**：`{file-path}:{line-number}`
-
-**实现逻辑**：
-{重要逻辑的说明}
-
-**关键代码**：
-```{language}
-{关键代码片段}
-```
-
-## 测试结果
-
-### 单元测试
-- 测试文件：`{test-file-path}`
-- 测试用例数：{数量}
-- 通过率：{百分比}
-
-**测试输出**：
-```
-{测试运行结果}
-```
-
-## 与计划的差异
-
-{如果实现与计划有差异，说明原因}
-
-## 审查关注点
-
-**需要审查者注意的要点**：
-- {关注点 1}
-- {关注点 2}
-
-## 已知问题
-
-{实现过程中发现的问题或后续需要优化的事项}
-
-## 后续步骤
-
-{代码审查或后续工作的建议}
-```
+输出实现摘要，并完整展示下一步代码审查的所有 TUI 命令格式。
 
 ## 完成检查清单
 
-- [ ] 完成了所有代码实现
-- [ ] 创建了实现报告 `.agent-workspace/active/{task-id}/{implementation-artifact}`
-- [ ] 所有测试通过
-- [ ] 更新了 task.md 中的 `current_step` 为 implementation
-- [ ] 更新了 task.md 中的 `updated_at` 为当前时间
-- [ ] 更新了 task.md 中的 `assigned_to`
-- [ ] 追加了 Activity Log 条目到 task.md
-- [ ] 在工作流进度中标记了 implementation 为已完成
-- [ ] 告知了用户下一步（必须展示所有 TUI 的命令格式，不要筛选）
+- [ ] 已完成批准范围内的代码实现
+- [ ] 已创建 `{implementation-artifact}`
+- [ ] 所有必需测试通过
+- [ ] 已更新 task.md 并追加 Activity Log
+- [ ] 已向用户展示所有 TUI 格式的下一步命令
 
 ## 停止
 
-完成检查清单后，**停止**。不要自动提交。等待代码审查后再提交。
+完成检查清单后立即停止。不要自动提交。
 
 ## 注意事项
 
-1. **前置条件**：必须有已审查的技术方案（`plan.md` 或 `plan-r{N}.md` 存在且已获批准）
-2. **禁止自动提交**：不要自动执行 `git commit` 或 `git add`。提醒用户手动提交
-3. **测试要求**：所有新代码必须有单元测试；测试覆盖率不得下降
-4. **代码质量**：遵循项目编码规范
-5. **计划偏离**：如果需要偏离计划，在实现报告中记录原因
-6. **版本化规则**：首轮实现使用 `implementation.md`；后续重实现使用 `implementation-r{N}.md`
+- 首轮实现使用 `implementation.md`，后续轮次使用 `implementation-r{N}.md`
+- 如偏离 `{plan-artifact}`，必须在报告中记录原因
+- 新测试必须验证有意义的业务行为，而不是机械透传
 
 ## 错误处理
 
-- 任务未找到：提示 "Task {task-id} not found"
-- 缺少计划：提示 "Technical plan not found, please run the plan-task skill first"
-- 测试失败：先尝试修复并重新运行测试；只有在存在外部阻塞、环境缺失或需求不明确时才停止，并输出阻塞原因
-- 构建失败：输出构建错误，停止实现
+- 任务未找到：`Task {task-id} not found`
+- 缺少方案：`Technical plan not found, please run the plan-task skill first`
+- 本地修复后仍无法通过测试：说明外部阻塞并停止，且不要创建实现产物

package/templates/.agents/skills/implement-task/reference/implementation-rules.md

@@ -0,0 +1,58 @@
+# Implementation Rules
+
+Read this file before coding or interpreting test failures.
+
+## Execute Code Implementation
+
+Follow the `implementation` step in `.agents/workflows/feature-development.yaml`.
+
+**Required tasks**:
+- [ ] implement the feature code according to the plan
+- [ ] write comprehensive unit tests
+- [ ] run tests locally to validate the feature
+- [ ] update related documentation and comments
+- [ ] follow project coding standards
+
+**Implementation principles**:
+1. **Follow the plan strictly**: do not deviate from the technical plan
+2. **Work step by step**: execute the planned sequence
+3. **Keep testing continuously**: re-run tests as work progresses
+4. **Keep it simple**: do not add unplanned features
+
+## Run Test Verification
+
+Run the project test command. Refer to the `test` skill for project-specific commands.
+
+```bash
+# See .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)
+```
+
+If tests fail:
+- analyze the failure first and prioritize fixing issues introduced by this implementation
+- re-run tests after each fix until they pass, or confirm that the problem is an external blocker
+- only stop without producing the implementation artifact when the failure is caused by an external blocker, missing environment, or unclear requirement that cannot be resolved inside the task
+
+Two-way failure handling:
+1. implementation-caused failures:
+   - fix the code, tests, docs, or fixtures introduced by this implementation
+   - re-run the test command after each fix
+   - continue until all required tests pass
+2. external blockers:
+   - confirm the failure comes from missing environment, unrelated upstream breakage, or unclear requirements outside this task
+   - stop without creating `implementation.md` / `implementation-r{N}.md`
+   - do not mark implementation complete in `task.md`
+   - do not output the normal success/next-step template
+
+## Notes
+
+1. **Prerequisite**: the approved technical plan must exist (`plan.md` or `plan-r{N}.md`)
+2. **No auto-commit**: do not run `git commit` or `git add`
+3. **Test quality**: new tests must validate meaningful business logic
+4. **Code quality**: follow project coding conventions
+5. **Plan deviation**: record any deviation in the implementation report
+6. **Versioning**: Round 1 uses `implementation.md`; later rounds use `implementation-r{N}.md`

package/templates/.agents/skills/implement-task/reference/implementation-rules.zh-CN.md

@@ -0,0 +1,58 @@
+# 实现规则
+
+在编写代码或判断测试失败原因之前先读取本文件。
+
+## 执行代码实现
+
+遵循 `.agents/workflows/feature-development.yaml` 中的 `implementation` 步骤。
+
+**必做任务**：
+- [ ] 按计划实现功能代码
+- [ ] 编写完整的单元测试
+- [ ] 在本地运行测试验证功能
+- [ ] 更新相关文档和注释
+- [ ] 遵守项目编码规范
+
+**实现原则**：
+1. **严格遵循方案**：不要偏离技术方案
+2. **按步骤推进**：按计划顺序执行
+3. **持续测试**：实现过程中持续重新运行测试
+4. **保持简单**：不要加入未计划的功能
+
+## 运行测试验证
+
+运行项目测试命令。项目特定命令请参考 `test` skill。
+
+```bash
+# 参考 .agents/skills/test/SKILL.md 中的项目测试命令
+# 常见模式：
+# npm test          (Node.js)
+# mvn test          (Maven)
+# pytest            (Python)
+# go test ./...     (Go)
+```
+
+如果测试失败：
+- 先分析失败原因，并优先修复由本次实现引入的问题
+- 每次修复后重新运行测试，直到通过，或者确认问题属于外部阻塞
+- 只有当失败由外部阻塞、环境缺失或当前任务内无法澄清的需求问题导致时，才允许在不生成实现产物的情况下停止
+
+双分支失败处理：
+1. 本次实现引入的失败：
+   - 修复由本次实现引入的代码、测试、文档或 fixture 问题
+   - 每次修复后重新运行测试命令
+   - 持续处理直到所有必需测试通过
+2. 外部阻塞：
+   - 确认失败来自缺失环境、无关的上游损坏，或任务范围外的需求不明确
+   - 停止，并且不要创建 `implementation.md` / `implementation-r{N}.md`
+   - 不要在 `task.md` 中把实现标记为完成
+   - 不要输出正常的成功/下一步模板
+
+## 注意事项
+
+1. **前置条件**：必须存在已批准的技术方案（`plan.md` 或 `plan-r{N}.md`）
+2. **禁止自动提交**：不要执行 `git commit` 或 `git add`
+3. **测试质量**：新增测试必须验证有意义的业务逻辑
+4. **代码质量**：遵循项目编码规范
+5. **方案偏离**：任何偏离都要记录到实现报告中
+6. **版本命名**：Round 1 使用 `implementation.md`，后续轮次使用 `implementation-r{N}.md`

package/templates/.agents/skills/implement-task/reference/report-template.md

@@ -0,0 +1,63 @@
+# Implementation Report Template
+
+Use this structure when creating `implementation.md` or `implementation-r{N}.md`.
+
+## 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}` - {change summary}
+
+## Key Code Explanation
+
+### {Module/Feature Name}
+**File**: `{file-path}:{line-number}`
+
+**Implementation Logic**:
+{important logic summary}
+
+**Key Code**:
+```{language}
+{key-code-snippet}
+```
+
+## Test Results
+
+### Unit Tests
+- Test file: `{test-file-path}`
+- Test case count: {count}
+- Pass rate: {percentage}
+
+**Test Output**:
+```
+{test-run-output}
+```
+
+## Differences from Plan
+
+{describe any deviation from the approved plan}
+
+## Items for Review
+
+**Focus areas for reviewers**:
+- {item 1}
+- {item 2}
+
+## Known Issues
+
+{known issues or follow-up ideas}
+
+## Next Steps
+
+{recommended follow-up}
+```

package/templates/.agents/skills/implement-task/reference/report-template.zh-CN.md

@@ -0,0 +1,63 @@
+# 实现报告模板
+
+创建 `implementation.md` 或 `implementation-r{N}.md` 时，使用以下结构。
+
+## 输出模板
+
+```markdown
+# 实现报告
+
+- **实现轮次**: Round {implementation-round}
+- **产物文件**: `{implementation-artifact}`
+
+## 变更文件
+
+### 新建文件
+- `{file-path}` - {description}
+
+### 修改文件
+- `{file-path}` - {change summary}
+
+## 关键代码说明
+
+### {模块/功能名称}
+**文件**: `{file-path}:{line-number}`
+
+**实现逻辑**:
+{important logic summary}
+
+**关键代码**:
+```{language}
+{key-code-snippet}
+```
+
+## 测试结果
+
+### 单元测试
+- 测试文件: `{test-file-path}`
+- 测试用例数: {count}
+- 通过率: {percentage}
+
+**测试输出**:
+```
+{test-run-output}
+```
+
+## 与方案的差异
+
+{describe any deviation from the approved plan}
+
+## 供审查关注的内容
+
+**建议审查者重点关注**:
+- {item 1}
+- {item 2}
+
+## 已知问题
+
+{known issues or follow-up ideas}
+
+## 下一步
+
+{recommended follow-up}
+```

package/templates/.agents/skills/import-codescan/SKILL.md

@@ -1,9 +1,6 @@
 ---
 name: import-codescan
-description: >
-  Import a Code Scanning (CodeQL) alert and create a remediation task.
-  Triggered when the user asks to import a Code Scanning alert.
-  Argument: alert number.
+description: "Import a Code Scanning alert and create a remediation task"
 ---
 
 # Import Code Scanning Alert
@@ -36,7 +33,7 @@ Extract key information:
 
 Check whether a task for this alert already exists. If not, create one:
 
-Directory: `.agent-workspace/active/TASK-{yyyyMMdd-HHmmss}/`
+Directory: `.agents/workspace/active/TASK-{yyyyMMdd-HHmmss}/`
 
 Task metadata:
 ```yaml

package/templates/.agents/skills/import-codescan/SKILL.zh-CN.md

@@ -1,8 +1,6 @@
 ---
 name: import-codescan
-description: >
-  导入 Code Scanning（CodeQL）告警并创建修复任务。
-  当用户要求导入 Code Scanning 告警时触发。参数：告警编号。
+description: "导入 Code Scanning 告警并创建修复任务"
 ---
 
 # 导入 Code Scanning 告警
@@ -35,7 +33,7 @@ gh api repos/{owner}/{repo}/code-scanning/alerts/<alert-number>
 
 检查是否已存在该告警的任务。如果不存在，创建：
 
-目录：`.agent-workspace/active/TASK-{yyyyMMdd-HHmmss}/`
+目录：`.agents/workspace/active/TASK-{yyyyMMdd-HHmmss}/`
 
 任务元数据：
 ```yaml

package/templates/.agents/skills/import-dependabot/SKILL.md

@@ -1,9 +1,6 @@
 ---
 name: import-dependabot
-description: >
-  Import a Dependabot security alert and create a remediation task.
-  Triggered when the user asks to import a Dependabot alert.
-  Argument: alert number.
+description: "Import a Dependabot alert and create a remediation task"
 ---
 
 # Import Dependabot Security Alert
@@ -33,11 +30,11 @@ Extract key information:
 
 ### 2. Create the Task Directory and File
 
-Check whether `.agent-workspace/active/` already has a task for this alert.
+Check whether `.agents/workspace/active/` already has a task for this alert.
 - If found, ask the user whether to re-import
 - If not found, create a new task
 
-Create directory: `.agent-workspace/active/TASK-{yyyyMMdd-HHmmss}/`
+Create directory: `.agents/workspace/active/TASK-{yyyyMMdd-HHmmss}/`
 
 Task metadata must include:
 ```yaml
@@ -78,7 +75,7 @@ Task information:
 - Task ID: {task-id}
 
 Output file:
-- Task file: .agent-workspace/active/{task-id}/task.md
+- Task file: .agents/workspace/active/{task-id}/task.md
 
 Next step:
   - Claude Code / OpenCode: /analyze-task {task-id}

package/templates/.agents/skills/import-dependabot/SKILL.zh-CN.md

@@ -1,8 +1,6 @@
 ---
 name: import-dependabot
-description: >
-  导入 Dependabot 安全告警并创建修复任务。
-  当用户要求导入 Dependabot 告警时触发。参数：告警编号。
+description: "导入 Dependabot 安全告警并创建修复任务"
 ---
 
 # 导入 Dependabot 安全告警
@@ -32,11 +30,11 @@ gh api repos/{owner}/{repo}/dependabot/alerts/<alert-number>
 
 ### 2. 创建任务目录和文件
 
-检查 `.agent-workspace/active/` 中是否已存在该告警的任务。
+检查 `.agents/workspace/active/` 中是否已存在该告警的任务。
 - 如果找到，询问用户是否重新导入
 - 如果未找到，创建新任务
 
-创建目录：`.agent-workspace/active/TASK-{yyyyMMdd-HHmmss}/`
+创建目录：`.agents/workspace/active/TASK-{yyyyMMdd-HHmmss}/`
 
 任务元数据需包含：
 ```yaml
@@ -77,7 +75,7 @@ date "+%Y-%m-%d %H:%M:%S"
 - 任务 ID：{task-id}
 
 产出文件：
-- 任务文件：.agent-workspace/active/{task-id}/task.md
+- 任务文件：.agents/workspace/active/{task-id}/task.md
 
 下一步：
   - Claude Code / OpenCode：/analyze-task {task-id}

package/templates/.agents/skills/import-issue/SKILL.md

@@ -1,8 +1,6 @@
 ---
 name: import-issue
-description: >
-  Import from a GitHub Issue and create a task file.
-  Triggered when the user asks to import an Issue. Argument: issue number.
+description: "Import a GitHub Issue and create a task"
 ---
 
 # Import Issue
@@ -27,7 +25,7 @@ Extract: issue number, title, description, and labels.
 
 ### 2. Check for an Existing Task
 
-Search `.agent-workspace/active/` for an existing task linked to this Issue.
+Search `.agents/workspace/active/` for an existing task linked to this Issue.
 - If found, ask the user whether to re-import or continue with the existing task
 - If not found, create a new task
 
@@ -37,7 +35,7 @@ Search `.agent-workspace/active/` for an existing task linked to this Issue.
 date +%Y%m%d-%H%M%S
 ```
 
-- Create the directory: `.agent-workspace/active/TASK-{yyyyMMdd-HHmmss}/`
+- Create the directory: `.agents/workspace/active/TASK-{yyyyMMdd-HHmmss}/`
 - Use the `.agents/templates/task.md` template to create `task.md`
 
 Task metadata:
@@ -62,7 +60,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`:
 - `current_step`: requirement-analysis
 - `assigned_to`: {current AI agent}
 - `updated_at`: {current time}
@@ -84,7 +82,7 @@ Task information:
 - Workflow: {workflow}
 
 Output file:
-- Task file: .agent-workspace/active/{task-id}/task.md
+- Task file: .agents/workspace/active/{task-id}/task.md
 
 Next step - run requirements analysis:
   - Claude Code / OpenCode: /analyze-task {task-id}
@@ -94,7 +92,7 @@ Next step - run requirements analysis:
 
 ## Completion Checklist
 
-- [ ] Created the task file `.agent-workspace/active/{task-id}/task.md`
+- [ ] Created the task file `.agents/workspace/active/{task-id}/task.md`
 - [ ] Recorded `issue_number` in task.md
 - [ ] Updated `current_step` to requirement-analysis
 - [ ] Updated `updated_at` to the current time