@fitlab-ai/agent-infra 0.3.2 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (85) hide show
  1. package/README.md +18 -33
  2. package/README.zh-CN.md +18 -33
  3. package/lib/defaults.json +3 -12
  4. package/lib/init.js +13 -24
  5. package/lib/paths.js +3 -42
  6. package/lib/update.js +98 -32
  7. package/package.json +2 -1
  8. package/templates/.agents/QUICKSTART.md +7 -7
  9. package/templates/.agents/QUICKSTART.zh-CN.md +7 -7
  10. package/templates/.agents/README.md +4 -4
  11. package/templates/.agents/README.zh-CN.md +4 -4
  12. package/templates/.agents/skills/analyze-task/SKILL.md +6 -6
  13. package/templates/.agents/skills/analyze-task/SKILL.zh-CN.md +6 -6
  14. package/templates/.agents/skills/block-task/SKILL.md +8 -8
  15. package/templates/.agents/skills/block-task/SKILL.zh-CN.md +8 -8
  16. package/templates/.agents/skills/check-task/SKILL.md +3 -3
  17. package/templates/.agents/skills/check-task/SKILL.zh-CN.md +3 -3
  18. package/templates/.agents/skills/commit/SKILL.md +1 -1
  19. package/templates/.agents/skills/commit/SKILL.zh-CN.md +1 -1
  20. package/templates/.agents/skills/complete-task/SKILL.md +7 -7
  21. package/templates/.agents/skills/complete-task/SKILL.zh-CN.md +7 -7
  22. package/templates/.agents/skills/create-issue/SKILL.md +2 -2
  23. package/templates/.agents/skills/create-issue/SKILL.zh-CN.md +2 -2
  24. package/templates/.agents/skills/create-pr/SKILL.md +1 -1
  25. package/templates/.agents/skills/create-pr/SKILL.zh-CN.md +1 -1
  26. package/templates/.agents/skills/create-task/SKILL.md +4 -4
  27. package/templates/.agents/skills/create-task/SKILL.zh-CN.md +4 -4
  28. package/templates/.agents/skills/implement-task/SKILL.md +8 -8
  29. package/templates/.agents/skills/implement-task/SKILL.zh-CN.md +8 -8
  30. package/templates/.agents/skills/import-codescan/SKILL.md +1 -1
  31. package/templates/.agents/skills/import-codescan/SKILL.zh-CN.md +1 -1
  32. package/templates/.agents/skills/import-dependabot/SKILL.md +3 -3
  33. package/templates/.agents/skills/import-dependabot/SKILL.zh-CN.md +3 -3
  34. package/templates/.agents/skills/import-issue/SKILL.md +5 -5
  35. package/templates/.agents/skills/import-issue/SKILL.zh-CN.md +5 -5
  36. package/templates/.agents/skills/plan-task/SKILL.md +6 -6
  37. package/templates/.agents/skills/plan-task/SKILL.zh-CN.md +6 -6
  38. package/templates/.agents/skills/refine-task/SKILL.md +3 -3
  39. package/templates/.agents/skills/refine-task/SKILL.zh-CN.md +3 -3
  40. package/templates/.agents/skills/release/SKILL.md +55 -14
  41. package/templates/.agents/skills/release/SKILL.zh-CN.md +55 -14
  42. package/templates/.agents/skills/review-task/SKILL.md +9 -9
  43. package/templates/.agents/skills/review-task/SKILL.zh-CN.md +9 -9
  44. package/templates/.agents/skills/sync-issue/SKILL.md +8 -8
  45. package/templates/.agents/skills/sync-issue/SKILL.zh-CN.md +8 -8
  46. package/templates/.agents/skills/sync-pr/SKILL.md +3 -3
  47. package/templates/.agents/skills/sync-pr/SKILL.zh-CN.md +3 -3
  48. package/templates/.agents/skills/update-agent-infra/SKILL.md +6 -6
  49. package/templates/.agents/skills/update-agent-infra/SKILL.zh-CN.md +6 -6
  50. package/templates/.agents/skills/update-agent-infra/scripts/sync-templates.js +61 -116
  51. package/templates/.agents/templates/handoff.md +1 -1
  52. package/templates/.agents/templates/handoff.zh-CN.md +1 -1
  53. package/templates/.agents/workflows/bug-fix.yaml +71 -71
  54. package/templates/.agents/workflows/bug-fix.zh-CN.yaml +1 -1
  55. package/templates/.agents/workflows/feature-development.yaml +71 -71
  56. package/templates/.agents/workflows/feature-development.zh-CN.yaml +1 -1
  57. package/templates/.agents/workflows/refactoring.yaml +76 -76
  58. package/templates/.agents/workflows/refactoring.zh-CN.yaml +1 -1
  59. package/templates/{.agent-workspace → .agents/workspace}/README.md +1 -1
  60. package/templates/{.agent-workspace → .agents/workspace}/README.zh-CN.md +1 -1
  61. package/templates/.claude/CLAUDE.md +1 -1
  62. package/templates/.claude/CLAUDE.zh-CN.md +1 -1
  63. package/templates/.claude/hooks/check-version-format.sh +44 -0
  64. package/templates/.claude/settings.json +14 -0
  65. package/templates/.opencode/COMMAND_STYLE_GUIDE.md +6 -6
  66. package/templates/.opencode/COMMAND_STYLE_GUIDE.zh-CN.md +6 -6
  67. package/templates/AGENTS.md +1 -1
  68. package/templates/AGENTS.zh-CN.md +1 -1
  69. package/templates/.editorconfig +0 -15
  70. package/templates/.github/ISSUE_TEMPLATE/01_bug_report.yml +0 -149
  71. package/templates/.github/ISSUE_TEMPLATE/02_question.yml +0 -101
  72. package/templates/.github/ISSUE_TEMPLATE/03_feature_request.yml +0 -131
  73. package/templates/.github/ISSUE_TEMPLATE/04_documentation.yml +0 -165
  74. package/templates/.github/ISSUE_TEMPLATE/05_other.yml +0 -147
  75. package/templates/.github/ISSUE_TEMPLATE/config.yml +0 -11
  76. package/templates/.github/PULL_REQUEST_TEMPLATE.md +0 -123
  77. package/templates/.github/dependabot.yml +0 -17
  78. package/templates/.github/hooks/check-utf8-encoding.sh +0 -25
  79. package/templates/.github/release.yml +0 -27
  80. package/templates/.github/workflows/pr-title-check.yml +0 -42
  81. package/templates/.mailmap +0 -4
  82. package/templates/CONTRIBUTING.md +0 -126
  83. package/templates/CONTRIBUTING.zh-CN.md +0 -124
  84. package/templates/SECURITY.md +0 -131
  85. package/templates/SECURITY.zh-CN.md +0 -131
@@ -13,7 +13,7 @@ This guide walks you through using multiple AI coding assistants together on a p
13
13
  1. Copy the task template to the active workspace:
14
14
 
15
15
  ```bash
16
- cp .agents/templates/task.md .agent-workspace/active/task-001.md
16
+ cp .agents/templates/task.md .agents/workspace/active/task-001.md
17
17
  ```
18
18
 
19
19
  2. Fill in the task metadata:
@@ -49,7 +49,7 @@ Claude Code excels at codebase exploration and understanding complex relationshi
49
49
  gemini
50
50
 
51
51
  # Example prompt:
52
- # "Based on the analysis in .agent-workspace/active/task-001.md,
52
+ # "Based on the analysis in .agents/workspace/active/task-001.md,
53
53
  # create a technical design. Define interfaces and outline the approach."
54
54
  ```
55
55
 
@@ -60,7 +60,7 @@ gemini
60
60
  codex
61
61
 
62
62
  # Example prompt:
63
- # "Implement the changes described in .agent-workspace/active/task-001.md.
63
+ # "Implement the changes described in .agents/workspace/active/task-001.md.
64
64
  # Follow the design section. Create a new branch for this work."
65
65
  ```
66
66
 
@@ -87,7 +87,7 @@ claude
87
87
 
88
88
  ```bash
89
89
  # Quick bug fix workflow
90
- cp .agents/templates/task.md .agent-workspace/active/bugfix-001.md
90
+ cp .agents/templates/task.md .agents/workspace/active/bugfix-001.md
91
91
  # Edit the task, then:
92
92
  # 1. Use Claude Code to analyze
93
93
  # 2. Use Codex/Cursor to fix
@@ -101,7 +101,7 @@ cp .agents/templates/task.md .agent-workspace/active/bugfix-001.md
101
101
  3. **Report**: Generate review report from template.
102
102
 
103
103
  ```bash
104
- cp .agents/templates/review-report.md .agent-workspace/active/review-pr-42.md
104
+ cp .agents/templates/review-report.md .agents/workspace/active/review-pr-42.md
105
105
  # Use Claude Code to fill in the review
106
106
  ```
107
107
 
@@ -113,7 +113,7 @@ cp .agents/templates/review-report.md .agent-workspace/active/review-pr-42.md
113
113
  4. **Verify** (Claude Code): Ensure no regressions, run tests.
114
114
 
115
115
  ```bash
116
- cp .agents/templates/task.md .agent-workspace/active/refactor-001.md
116
+ cp .agents/templates/task.md .agents/workspace/active/refactor-001.md
117
117
  # Follow the refactoring workflow in .agents/workflows/refactoring.yaml
118
118
  ```
119
119
 
@@ -122,7 +122,7 @@ cp .agents/templates/task.md .agent-workspace/active/refactor-001.md
122
122
  When switching between AI tools, create a handoff document:
123
123
 
124
124
  ```bash
125
- cp .agents/templates/handoff.md .agent-workspace/active/handoff-task-001-phase2.md
125
+ cp .agents/templates/handoff.md .agents/workspace/active/handoff-task-001-phase2.md
126
126
  ```
127
127
 
128
128
  Fill in:
@@ -13,7 +13,7 @@
13
13
  1. 将任务模板复制到活跃工作区:
14
14
 
15
15
  ```bash
16
- cp .agents/templates/task.zh-CN.md .agent-workspace/active/task-001.md
16
+ cp .agents/templates/task.zh-CN.md .agents/workspace/active/task-001.md
17
17
  ```
18
18
 
19
19
  2. 填写任务元数据:
@@ -49,7 +49,7 @@ Claude Code 擅长代码库探索和理解文件间的复杂关系。
49
49
  gemini
50
50
 
51
51
  # 示例提示:
52
- # "基于 .agent-workspace/active/task-001.md 中的分析结果,
52
+ # "基于 .agents/workspace/active/task-001.md 中的分析结果,
53
53
  # 创建技术设计方案。定义接口并概述实现思路。"
54
54
  ```
55
55
 
@@ -60,7 +60,7 @@ gemini
60
60
  codex
61
61
 
62
62
  # 示例提示:
63
- # "实现 .agent-workspace/active/task-001.md 中描述的变更。
63
+ # "实现 .agents/workspace/active/task-001.md 中描述的变更。
64
64
  # 遵循设计部分。为此工作创建新分支。"
65
65
  ```
66
66
 
@@ -87,7 +87,7 @@ claude
87
87
 
88
88
  ```bash
89
89
  # 快速缺陷修复工作流
90
- cp .agents/templates/task.zh-CN.md .agent-workspace/active/bugfix-001.md
90
+ cp .agents/templates/task.zh-CN.md .agents/workspace/active/bugfix-001.md
91
91
  # 编辑任务,然后:
92
92
  # 1. 使用 Claude Code 分析
93
93
  # 2. 使用 Codex/Cursor 修复
@@ -101,7 +101,7 @@ cp .agents/templates/task.zh-CN.md .agent-workspace/active/bugfix-001.md
101
101
  3. **报告**:从模板生成审查报告。
102
102
 
103
103
  ```bash
104
- cp .agents/templates/review-report.zh-CN.md .agent-workspace/active/review-pr-42.md
104
+ cp .agents/templates/review-report.zh-CN.md .agents/workspace/active/review-pr-42.md
105
105
  # 使用 Claude Code 填写审查内容
106
106
  ```
107
107
 
@@ -113,7 +113,7 @@ cp .agents/templates/review-report.zh-CN.md .agent-workspace/active/review-pr-42
113
113
  4. **验证**(Claude Code):确保没有回归问题,运行测试。
114
114
 
115
115
  ```bash
116
- cp .agents/templates/task.zh-CN.md .agent-workspace/active/refactor-001.md
116
+ cp .agents/templates/task.zh-CN.md .agents/workspace/active/refactor-001.md
117
117
  # 按照 .agents/workflows/refactoring.zh-CN.yaml 中的重构工作流执行
118
118
  ```
119
119
 
@@ -122,7 +122,7 @@ cp .agents/templates/task.zh-CN.md .agent-workspace/active/refactor-001.md
122
122
  在 AI 工具之间切换时,创建交接文档:
123
123
 
124
124
  ```bash
125
- cp .agents/templates/handoff.zh-CN.md .agent-workspace/active/handoff-task-001-phase2.md
125
+ cp .agents/templates/handoff.zh-CN.md .agents/workspace/active/handoff-task-001-phase2.md
126
126
  ```
127
127
 
128
128
  填写:
@@ -37,7 +37,7 @@ This dual-config approach ensures every AI tool receives appropriate project con
37
37
  code-review.yaml # Code review workflow
38
38
  refactoring.yaml # Refactoring workflow
39
39
 
40
- .agent-workspace/ # Runtime workspace (git-ignored)
40
+ .agents/workspace/ # Runtime workspace (git-ignored)
41
41
  active/ # Currently active tasks
42
42
  blocked/ # Blocked tasks
43
43
  completed/ # Completed tasks
@@ -95,7 +95,7 @@ Each AI tool has different strengths. Use them accordingly:
95
95
  ## Quick Start
96
96
 
97
97
  1. **Read the quick start guide**: See `QUICKSTART.md` for step-by-step instructions.
98
- 2. **Create a task**: Copy `.agents/templates/task.md` to `.agent-workspace/active/`.
98
+ 2. **Create a task**: Copy `.agents/templates/task.md` to `.agents/workspace/active/`.
99
99
  3. **Assign to an AI**: Update the `assigned_to` field in the task metadata.
100
100
  4. **Run the workflow**: Follow the appropriate workflow in `.agents/workflows/`.
101
101
  5. **Hand off**: When switching AIs, create a handoff document from the template.
@@ -131,7 +131,7 @@ No. Claude Code reads from `.claude/CLAUDE.md`, and all other tools read from `A
131
131
 
132
132
  ### Q: How do tasks get passed between AI tools?
133
133
 
134
- Through handoff documents stored in `.agent-workspace/`. Each handoff includes context, progress, and next steps so the receiving AI can continue seamlessly.
134
+ Through handoff documents stored in `.agents/workspace/`. Each handoff includes context, progress, and next steps so the receiving AI can continue seamlessly.
135
135
 
136
136
  ### Q: What if an AI tool doesn't support AGENTS.md?
137
137
 
@@ -143,4 +143,4 @@ It's not recommended. The workflow model is sequential -- one AI per phase. Para
143
143
 
144
144
  ### Q: Where are runtime files stored?
145
145
 
146
- In `.agent-workspace/`, which is git-ignored. Only templates and workflow definitions in `.agents/` are version-controlled.
146
+ In `.agents/workspace/`, which is git-ignored. Only templates and workflow definitions in `.agents/` are version-controlled.
@@ -37,7 +37,7 @@
37
37
  code-review.yaml # 代码审查工作流
38
38
  refactoring.yaml # 重构工作流
39
39
 
40
- .agent-workspace/ # 运行时工作区(已被 git ignore)
40
+ .agents/workspace/ # 运行时工作区(已被 git ignore)
41
41
  active/ # 当前活跃任务
42
42
  blocked/ # 被阻塞的任务
43
43
  completed/ # 已完成的任务
@@ -95,7 +95,7 @@
95
95
  ## 快速入门
96
96
 
97
97
  1. **阅读快速入门指南**:参见 `QUICKSTART.zh-CN.md` 获取分步说明。
98
- 2. **创建任务**:将 `.agents/templates/task.zh-CN.md` 复制到 `.agent-workspace/active/`。
98
+ 2. **创建任务**:将 `.agents/templates/task.zh-CN.md` 复制到 `.agents/workspace/active/`。
99
99
  3. **分配给 AI**:更新任务元数据中的 `assigned_to` 字段。
100
100
  4. **执行工作流**:按照 `.agents/workflows/` 中相应的工作流执行。
101
101
  5. **交接**:切换 AI 时,从模板创建交接文档。
@@ -131,7 +131,7 @@
131
131
 
132
132
  ### Q:任务如何在 AI 工具之间传递?
133
133
 
134
- 通过存储在 `.agent-workspace/` 中的交接文档。每份交接文档包含上下文、进度和后续步骤,让接收方 AI 能无缝接续。
134
+ 通过存储在 `.agents/workspace/` 中的交接文档。每份交接文档包含上下文、进度和后续步骤,让接收方 AI 能无缝接续。
135
135
 
136
136
  ### Q:如果某个 AI 工具不支持 AGENTS.md 怎么办?
137
137
 
@@ -143,4 +143,4 @@
143
143
 
144
144
  ### Q:运行时文件存储在哪里?
145
145
 
146
- 在 `.agent-workspace/` 中,该目录已被 git ignore。只有 `.agents/` 中的模板和工作流定义受版本控制。
146
+ 在 `.agents/workspace/` 中,该目录已被 git ignore。只有 `.agents/` 中的模板和工作流定义受版本控制。
@@ -19,7 +19,7 @@ description: >
19
19
  ### 1. Verify Prerequisites
20
20
 
21
21
  Check required files:
22
- - `.agent-workspace/active/{task-id}/task.md` - Task file
22
+ - `.agents/workspace/active/{task-id}/task.md` - Task file
23
23
 
24
24
  Note: `{task-id}` format is `TASK-{yyyyMMdd-HHmmss}`, for example `TASK-20260306-143022`
25
25
 
@@ -27,7 +27,7 @@ If `task.md` is missing, tell the user to create or import the task first.
27
27
 
28
28
  ### 2. Determine the Analysis Round
29
29
 
30
- Scan `.agent-workspace/active/{task-id}/` for analysis artifact files:
30
+ Scan `.agents/workspace/active/{task-id}/` for analysis artifact files:
31
31
  - If neither `analysis.md` nor `analysis-r*.md` exists -> this is Round 1 and must create `analysis.md`
32
32
  - If `analysis.md` exists and no `analysis-r*.md` exists -> this is Round 2 and must create `analysis-r2.md`
33
33
  - If `analysis-r{N}.md` exists -> this is Round N+1 and must create `analysis-r{N+1}.md`
@@ -61,7 +61,7 @@ Follow the `analysis` step in `.agents/workflows/feature-development.yaml`:
61
61
 
62
62
  ### 5. Output Analysis Document
63
63
 
64
- Create `.agent-workspace/active/{task-id}/{analysis-artifact}`.
64
+ Create `.agents/workspace/active/{task-id}/{analysis-artifact}`.
65
65
 
66
66
  ## Output Template
67
67
 
@@ -109,7 +109,7 @@ Get the current time:
109
109
  date "+%Y-%m-%d %H:%M:%S"
110
110
  ```
111
111
 
112
- Update `.agent-workspace/active/{task-id}/task.md`:
112
+ Update `.agents/workspace/active/{task-id}/task.md`:
113
113
  - `current_step`: requirement-analysis
114
114
  - `assigned_to`: {current AI agent}
115
115
  - `updated_at`: {current time}
@@ -135,7 +135,7 @@ Summary:
135
135
  - Risk level: {assessment}
136
136
 
137
137
  Output file:
138
- - Analysis report: .agent-workspace/active/{task-id}/{analysis-artifact}
138
+ - Analysis report: .agents/workspace/active/{task-id}/{analysis-artifact}
139
139
 
140
140
  Next step - create technical plan:
141
141
  - Claude Code / OpenCode: /plan-task {task-id}
@@ -146,7 +146,7 @@ Next step - create technical plan:
146
146
  ## Completion Checklist
147
147
 
148
148
  - [ ] Read and understood the task file and source information
149
- - [ ] Created analysis document `.agent-workspace/active/{task-id}/{analysis-artifact}`
149
+ - [ ] Created analysis document `.agents/workspace/active/{task-id}/{analysis-artifact}`
150
150
  - [ ] Updated `current_step` to requirement-analysis in task.md
151
151
  - [ ] Updated `updated_at` to the current time in task.md
152
152
  - [ ] Updated `assigned_to` in task.md
@@ -18,7 +18,7 @@ description: >
18
18
  ### 1. 验证前置条件
19
19
 
20
20
  检查必要文件:
21
- - `.agent-workspace/active/{task-id}/task.md` - 任务文件
21
+ - `.agents/workspace/active/{task-id}/task.md` - 任务文件
22
22
 
23
23
  注意:`{task-id}` 格式为 `TASK-{yyyyMMdd-HHmmss}`,例如 `TASK-20260306-143022`
24
24
 
@@ -26,7 +26,7 @@ description: >
26
26
 
27
27
  ### 2. 确定分析轮次
28
28
 
29
- 扫描 `.agent-workspace/active/{task-id}/` 目录中的分析产物文件:
29
+ 扫描 `.agents/workspace/active/{task-id}/` 目录中的分析产物文件:
30
30
  - 如果不存在 `analysis.md` 且不存在 `analysis-r*.md` → 本轮为第 1 轮,产出 `analysis.md`
31
31
  - 如果存在 `analysis.md` 且不存在 `analysis-r*.md` → 本轮为第 2 轮,产出 `analysis-r2.md`
32
32
  - 如果存在 `analysis-r{N}.md` → 本轮为第 N+1 轮,产出 `analysis-r{N+1}.md`
@@ -60,7 +60,7 @@ description: >
60
60
 
61
61
  ### 5. 输出分析文档
62
62
 
63
- 创建 `.agent-workspace/active/{task-id}/{analysis-artifact}`。
63
+ 创建 `.agents/workspace/active/{task-id}/{analysis-artifact}`。
64
64
 
65
65
  ## 输出模板
66
66
 
@@ -108,7 +108,7 @@ description: >
108
108
  date "+%Y-%m-%d %H:%M:%S"
109
109
  ```
110
110
 
111
- 更新 `.agent-workspace/active/{task-id}/task.md`:
111
+ 更新 `.agents/workspace/active/{task-id}/task.md`:
112
112
  - `current_step`:requirement-analysis
113
113
  - `assigned_to`:{当前 AI 代理}
114
114
  - `updated_at`:{当前时间}
@@ -134,7 +134,7 @@ date "+%Y-%m-%d %H:%M:%S"
134
134
  - 风险等级:{评估}
135
135
 
136
136
  产出文件:
137
- - 分析报告:.agent-workspace/active/{task-id}/{analysis-artifact}
137
+ - 分析报告:.agents/workspace/active/{task-id}/{analysis-artifact}
138
138
 
139
139
  下一步 - 设计技术方案:
140
140
  - Claude Code / OpenCode:/plan-task {task-id}
@@ -145,7 +145,7 @@ date "+%Y-%m-%d %H:%M:%S"
145
145
  ## 完成检查清单
146
146
 
147
147
  - [ ] 阅读并理解了任务文件和来源信息
148
- - [ ] 创建了分析文档 `.agent-workspace/active/{task-id}/{analysis-artifact}`
148
+ - [ ] 创建了分析文档 `.agents/workspace/active/{task-id}/{analysis-artifact}`
149
149
  - [ ] 更新了 task.md 中的 `current_step` 为 requirement-analysis
150
150
  - [ ] 更新了 task.md 中的 `updated_at` 为当前时间
151
151
  - [ ] 更新了 task.md 中的 `assigned_to`
@@ -25,7 +25,7 @@ description: >
25
25
 
26
26
  ### 1. Verify Task Exists
27
27
 
28
- Check that the task exists in `.agent-workspace/active/{task-id}/`.
28
+ Check that the task exists in `.agents/workspace/active/{task-id}/`.
29
29
 
30
30
  Note: `{task-id}` format is `TASK-{yyyyMMdd-HHmmss}`, e.g. `TASK-20260306-143022`
31
31
 
@@ -47,7 +47,7 @@ Get the current time:
47
47
  date "+%Y-%m-%d %H:%M:%S"
48
48
  ```
49
49
 
50
- Update `.agent-workspace/active/{task-id}/task.md`:
50
+ Update `.agents/workspace/active/{task-id}/task.md`:
51
51
  - `status`: blocked
52
52
  - `blocked_at`: {current timestamp}
53
53
  - `updated_at`: {current timestamp}
@@ -61,13 +61,13 @@ Add a blocking information section to task.md.
61
61
  ### 4. Move Task to Blocked Directory
62
62
 
63
63
  ```bash
64
- mv .agent-workspace/active/{task-id} .agent-workspace/blocked/{task-id}
64
+ mv .agents/workspace/active/{task-id} .agents/workspace/blocked/{task-id}
65
65
  ```
66
66
 
67
67
  ### 5. Verify Move
68
68
 
69
69
  ```bash
70
- ls .agent-workspace/blocked/{task-id}/task.md
70
+ ls .agents/workspace/blocked/{task-id}/task.md
71
71
  ```
72
72
 
73
73
  ### 6. Sync to Issue (Optional)
@@ -93,10 +93,10 @@ Task {task-id} marked as blocked.
93
93
 
94
94
  Blocking reason: {summary}
95
95
  Required to unblock: {what's needed}
96
- Archived to: .agent-workspace/blocked/{task-id}/
96
+ Archived to: .agents/workspace/blocked/{task-id}/
97
97
 
98
98
  To unblock when the issue is resolved:
99
- mv .agent-workspace/blocked/{task-id} .agent-workspace/active/{task-id}
99
+ mv .agents/workspace/blocked/{task-id} .agents/workspace/active/{task-id}
100
100
  # Then update task.md: status -> active, remove blocked_at
101
101
  ```
102
102
 
@@ -133,7 +133,7 @@ Blocking information section to add to task.md:
133
133
 
134
134
  - [ ] Analyzed and documented the blocking reason
135
135
  - [ ] Updated task.md with blocked status and blocking information
136
- - [ ] Moved task directory to `.agent-workspace/blocked/`
136
+ - [ ] Moved task directory to `.agents/workspace/blocked/`
137
137
  - [ ] Verified move succeeded
138
138
  - [ ] Informed user how to unblock
139
139
 
@@ -143,7 +143,7 @@ When the blocking issue is resolved:
143
143
 
144
144
  ```bash
145
145
  # 1. Move back to active
146
- mv .agent-workspace/blocked/{task-id} .agent-workspace/active/{task-id}
146
+ mv .agents/workspace/blocked/{task-id} .agents/workspace/active/{task-id}
147
147
 
148
148
  # 2. Update task.md: set status to active, update timestamps
149
149
  # 3. Resume from where you left off (check current_step)
@@ -24,7 +24,7 @@ description: >
24
24
 
25
25
  ### 1. 验证任务存在
26
26
 
27
- 检查任务是否存在于 `.agent-workspace/active/{task-id}/`。
27
+ 检查任务是否存在于 `.agents/workspace/active/{task-id}/`。
28
28
 
29
29
  注意:`{task-id}` 格式为 `TASK-{yyyyMMdd-HHmmss}`,例如 `TASK-20260306-143022`
30
30
 
@@ -46,7 +46,7 @@ description: >
46
46
  date "+%Y-%m-%d %H:%M:%S"
47
47
  ```
48
48
 
49
- 更新 `.agent-workspace/active/{task-id}/task.md`:
49
+ 更新 `.agents/workspace/active/{task-id}/task.md`:
50
50
  - `status`:blocked
51
51
  - `blocked_at`:{当前时间戳}
52
52
  - `updated_at`:{当前时间戳}
@@ -60,13 +60,13 @@ date "+%Y-%m-%d %H:%M:%S"
60
60
  ### 4. 移动任务到 blocked 目录
61
61
 
62
62
  ```bash
63
- mv .agent-workspace/active/{task-id} .agent-workspace/blocked/{task-id}
63
+ mv .agents/workspace/active/{task-id} .agents/workspace/blocked/{task-id}
64
64
  ```
65
65
 
66
66
  ### 5. 验证移动
67
67
 
68
68
  ```bash
69
- ls .agent-workspace/blocked/{task-id}/task.md
69
+ ls .agents/workspace/blocked/{task-id}/task.md
70
70
  ```
71
71
 
72
72
  ### 6. 同步到 Issue(可选)
@@ -92,10 +92,10 @@ ls .agent-workspace/blocked/{task-id}/task.md
92
92
 
93
93
  阻塞原因:{摘要}
94
94
  解除阻塞所需:{需要什么}
95
- 归档路径:.agent-workspace/blocked/{task-id}/
95
+ 归档路径:.agents/workspace/blocked/{task-id}/
96
96
 
97
97
  解除阻塞时执行:
98
- mv .agent-workspace/blocked/{task-id} .agent-workspace/active/{task-id}
98
+ mv .agents/workspace/blocked/{task-id} .agents/workspace/active/{task-id}
99
99
  # 然后更新 task.md:status -> active,移除 blocked_at
100
100
  ```
101
101
 
@@ -132,7 +132,7 @@ ls .agent-workspace/blocked/{task-id}/task.md
132
132
 
133
133
  - [ ] 分析并记录了阻塞原因
134
134
  - [ ] 更新了 task.md 的阻塞状态和阻塞信息
135
- - [ ] 将任务目录移动到 `.agent-workspace/blocked/`
135
+ - [ ] 将任务目录移动到 `.agents/workspace/blocked/`
136
136
  - [ ] 验证了移动成功
137
137
  - [ ] 告知了用户如何解除阻塞
138
138
 
@@ -142,7 +142,7 @@ ls .agent-workspace/blocked/{task-id}/task.md
142
142
 
143
143
  ```bash
144
144
  # 1. 移回 active
145
- mv .agent-workspace/blocked/{task-id} .agent-workspace/active/{task-id}
145
+ mv .agents/workspace/blocked/{task-id} .agents/workspace/active/{task-id}
146
146
 
147
147
  # 2. 更新 task.md:设置 status 为 active,更新时间戳
148
148
  # 3. 从中断处继续(检查 current_step)
@@ -19,9 +19,9 @@ description: >
19
19
  ### 1. Locate Task
20
20
 
21
21
  Search for the task in this priority order:
22
- 1. `.agent-workspace/active/{task-id}/task.md`
23
- 2. `.agent-workspace/blocked/{task-id}/task.md`
24
- 3. `.agent-workspace/completed/{task-id}/task.md`
22
+ 1. `.agents/workspace/active/{task-id}/task.md`
23
+ 2. `.agents/workspace/blocked/{task-id}/task.md`
24
+ 3. `.agents/workspace/completed/{task-id}/task.md`
25
25
 
26
26
  Note: `{task-id}` format is `TASK-{yyyyMMdd-HHmmss}`, for example `TASK-20260306-143022`
27
27
 
@@ -17,9 +17,9 @@ description: >
17
17
  ### 1. 查找任务
18
18
 
19
19
  按以下优先顺序搜索任务:
20
- 1. `.agent-workspace/active/{task-id}/task.md`
21
- 2. `.agent-workspace/blocked/{task-id}/task.md`
22
- 3. `.agent-workspace/completed/{task-id}/task.md`
20
+ 1. `.agents/workspace/active/{task-id}/task.md`
21
+ 2. `.agents/workspace/blocked/{task-id}/task.md`
22
+ 3. `.agents/workspace/completed/{task-id}/task.md`
23
23
 
24
24
  注意:`{task-id}` 格式为 `TASK-{yyyyMMdd-HHmmss}`,例如 `TASK-20260306-143022`
25
25
 
@@ -90,7 +90,7 @@ Generate commit message in Conventional Commits format:
90
90
 
91
91
  ### Multi-Agent Co-Authorship (If Task-Related)
92
92
 
93
- If the commit belongs to an active task and `.agent-workspace/active/{task-id}/task.md` exists:
93
+ If the commit belongs to an active task and `.agents/workspace/active/{task-id}/task.md` exists:
94
94
 
95
95
  1. Read the `## Activity Log` section from `task.md`.
96
96
  2. Extract all unique agent names from entries matching `by {agent}`. A loose pattern such as `by (\S+)` is acceptable.
@@ -89,7 +89,7 @@ git log --oneline -5
89
89
 
90
90
  ### 多 Agent 协作署名(仅任务相关提交)
91
91
 
92
- 如果本次提交属于某个活动任务,且存在 `.agent-workspace/active/{task-id}/task.md`:
92
+ 如果本次提交属于某个活动任务,且存在 `.agents/workspace/active/{task-id}/task.md`:
93
93
 
94
94
  1. 读取 `task.md` 中的 `## Activity Log` 部分。
95
95
  2. 从符合 `by {agent}` 的条目中提取所有唯一 Agent 名称;可使用较宽松的匹配模式,例如 `by (\S+)`。
@@ -19,7 +19,7 @@ description: >
19
19
 
20
20
  ### 1. Verify Task Exists
21
21
 
22
- Check that the task exists in `.agent-workspace/active/{task-id}/`.
22
+ Check that the task exists in `.agents/workspace/active/{task-id}/`.
23
23
 
24
24
  Note: `{task-id}` format is `TASK-{yyyyMMdd-HHmmss}`, e.g. `TASK-20260306-143022`
25
25
 
@@ -61,7 +61,7 @@ Get the current time:
61
61
  date "+%Y-%m-%d %H:%M:%S"
62
62
  ```
63
63
 
64
- Update `.agent-workspace/active/{task-id}/task.md`:
64
+ Update `.agents/workspace/active/{task-id}/task.md`:
65
65
  - `status`: completed
66
66
  - `completed_at`: {current timestamp}
67
67
  - `updated_at`: {current timestamp}
@@ -76,13 +76,13 @@ Update `.agent-workspace/active/{task-id}/task.md`:
76
76
  Move the task directory from active to completed:
77
77
 
78
78
  ```bash
79
- mv .agent-workspace/active/{task-id} .agent-workspace/completed/{task-id}
79
+ mv .agents/workspace/active/{task-id} .agents/workspace/completed/{task-id}
80
80
  ```
81
81
 
82
82
  ### 5. Verify Archive
83
83
 
84
84
  ```bash
85
- ls .agent-workspace/completed/{task-id}/task.md
85
+ ls .agents/workspace/completed/{task-id}/task.md
86
86
  ```
87
87
 
88
88
  Confirm the task directory was successfully moved.
@@ -111,7 +111,7 @@ Task {task-id} completed and archived.
111
111
  Task info:
112
112
  - Title: {title}
113
113
  - Completed at: {timestamp}
114
- - Archived to: .agent-workspace/completed/{task-id}/
114
+ - Archived to: .agents/workspace/completed/{task-id}/
115
115
 
116
116
  Deliverables:
117
117
  - {List of key outputs: files modified, tests added, etc.}
@@ -121,7 +121,7 @@ Deliverables:
121
121
 
122
122
  - [ ] Verified all workflow steps are complete
123
123
  - [ ] Updated task.md with completed status and timestamp
124
- - [ ] Moved task directory to `.agent-workspace/completed/`
124
+ - [ ] Moved task directory to `.agents/workspace/completed/`
125
125
  - [ ] Verified archive succeeded
126
126
  - [ ] Informed user of completion
127
127
 
@@ -135,7 +135,7 @@ Deliverables:
135
135
 
136
136
  2. **Rollback**: If a task was archived incorrectly:
137
137
  ```bash
138
- mv .agent-workspace/completed/{task-id} .agent-workspace/active/{task-id}
138
+ mv .agents/workspace/completed/{task-id} .agents/workspace/active/{task-id}
139
139
  ```
140
140
  Then update task.md status back to `active`.
141
141
 
@@ -17,7 +17,7 @@ description: >
17
17
 
18
18
  ### 1. 验证任务存在
19
19
 
20
- 检查任务是否存在于 `.agent-workspace/active/{task-id}/`。
20
+ 检查任务是否存在于 `.agents/workspace/active/{task-id}/`。
21
21
 
22
22
  注意:`{task-id}` 格式为 `TASK-{yyyyMMdd-HHmmss}`,例如 `TASK-20260306-143022`
23
23
 
@@ -59,7 +59,7 @@ Please complete the missing steps first, or use --force to override.
59
59
  date "+%Y-%m-%d %H:%M:%S"
60
60
  ```
61
61
 
62
- 更新 `.agent-workspace/active/{task-id}/task.md`:
62
+ 更新 `.agents/workspace/active/{task-id}/task.md`:
63
63
  - `status`:completed
64
64
  - `completed_at`:{当前时间戳}
65
65
  - `updated_at`:{当前时间戳}
@@ -74,13 +74,13 @@ date "+%Y-%m-%d %H:%M:%S"
74
74
  将任务目录从 active 移动到 completed:
75
75
 
76
76
  ```bash
77
- mv .agent-workspace/active/{task-id} .agent-workspace/completed/{task-id}
77
+ mv .agents/workspace/active/{task-id} .agents/workspace/completed/{task-id}
78
78
  ```
79
79
 
80
80
  ### 5. 验证归档
81
81
 
82
82
  ```bash
83
- ls .agent-workspace/completed/{task-id}/task.md
83
+ ls .agents/workspace/completed/{task-id}/task.md
84
84
  ```
85
85
 
86
86
  确认任务目录已成功移动。
@@ -109,7 +109,7 @@ ls .agent-workspace/completed/{task-id}/task.md
109
109
  任务信息:
110
110
  - 标题:{title}
111
111
  - 完成时间:{timestamp}
112
- - 归档路径:.agent-workspace/completed/{task-id}/
112
+ - 归档路径:.agents/workspace/completed/{task-id}/
113
113
 
114
114
  交付物:
115
115
  - {关键产出列表:修改的文件、添加的测试等}
@@ -119,7 +119,7 @@ ls .agent-workspace/completed/{task-id}/task.md
119
119
 
120
120
  - [ ] 验证了所有工作流步骤已完成
121
121
  - [ ] 更新了 task.md 的完成状态和时间戳
122
- - [ ] 将任务目录移动到 `.agent-workspace/completed/`
122
+ - [ ] 将任务目录移动到 `.agents/workspace/completed/`
123
123
  - [ ] 验证了归档成功
124
124
  - [ ] 告知了用户完成情况
125
125
 
@@ -133,7 +133,7 @@ ls .agent-workspace/completed/{task-id}/task.md
133
133
 
134
134
  2. **回滚**:如果任务被错误归档:
135
135
  ```bash
136
- mv .agent-workspace/completed/{task-id} .agent-workspace/active/{task-id}
136
+ mv .agents/workspace/completed/{task-id} .agents/workspace/active/{task-id}
137
137
  ```
138
138
  然后将 task.md 中的状态改回 `active`。
139
139
 
@@ -20,7 +20,7 @@ description: >
20
20
  ### 1. Verify Prerequisites
21
21
 
22
22
  Check required file:
23
- - `.agent-workspace/active/{task-id}/task.md` - Task file
23
+ - `.agents/workspace/active/{task-id}/task.md` - Task file
24
24
 
25
25
  Check that GitHub CLI is available and authenticated:
26
26
 
@@ -234,7 +234,7 @@ Get the current time:
234
234
  date "+%Y-%m-%d %H:%M:%S"
235
235
  ```
236
236
 
237
- Update `.agent-workspace/active/{task-id}/task.md`:
237
+ Update `.agents/workspace/active/{task-id}/task.md`:
238
238
  - Add or update `issue_number`: `{issue-number}`
239
239
  - `updated_at`: {current time}
240
240
  - **Append** to `## Activity Log` (do NOT overwrite previous entries):
@@ -20,7 +20,7 @@ description: >
20
20
  ### 1. 验证前置条件
21
21
 
22
22
  检查必要文件:
23
- - `.agent-workspace/active/{task-id}/task.md` - 任务文件
23
+ - `.agents/workspace/active/{task-id}/task.md` - 任务文件
24
24
 
25
25
  检查 GitHub CLI 可用且已认证:
26
26
 
@@ -234,7 +234,7 @@ gh issue edit {issue-number} --add-label "in: {module}"
234
234
  date "+%Y-%m-%d %H:%M:%S"
235
235
  ```
236
236
 
237
- 更新 `.agent-workspace/active/{task-id}/task.md`:
237
+ 更新 `.agents/workspace/active/{task-id}/task.md`:
238
238
  - 添加或更新 `issue_number`:`{issue-number}`
239
239
  - `updated_at`:{当前时间}
240
240
  - **追加**到 `## Activity Log`(不要覆盖之前的记录):
@@ -204,7 +204,7 @@ Get the current time:
204
204
  date "+%Y-%m-%d %H:%M:%S"
205
205
  ```
206
206
 
207
- If there is an active task for this work, update `.agent-workspace/active/{task-id}/task.md`:
207
+ If there is an active task for this work, update `.agents/workspace/active/{task-id}/task.md`:
208
208
  - `pr_number`: {pr-number}
209
209
  - `updated_at`: {current time}
210
210
  - **Append** to `## Activity Log` (do NOT overwrite previous entries):
@@ -203,7 +203,7 @@ EOF
203
203
  date "+%Y-%m-%d %H:%M:%S"
204
204
  ```
205
205
 
206
- 如果有关联的活跃任务,更新 `.agent-workspace/active/{task-id}/task.md`:
206
+ 如果有关联的活跃任务,更新 `.agents/workspace/active/{task-id}/task.md`:
207
207
  - `pr_number`:{pr-number}
208
208
  - `updated_at`:{当前时间}
209
209
  - **追加**到 `## Activity Log`(不要覆盖之前的记录):