@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.
- package/README.md +18 -33
- package/README.zh-CN.md +18 -33
- package/lib/defaults.json +3 -12
- package/lib/init.js +13 -24
- package/lib/paths.js +3 -42
- package/lib/update.js +98 -32
- package/package.json +2 -1
- package/templates/.agents/QUICKSTART.md +7 -7
- package/templates/.agents/QUICKSTART.zh-CN.md +7 -7
- package/templates/.agents/README.md +4 -4
- package/templates/.agents/README.zh-CN.md +4 -4
- package/templates/.agents/skills/analyze-task/SKILL.md +6 -6
- package/templates/.agents/skills/analyze-task/SKILL.zh-CN.md +6 -6
- package/templates/.agents/skills/block-task/SKILL.md +8 -8
- package/templates/.agents/skills/block-task/SKILL.zh-CN.md +8 -8
- package/templates/.agents/skills/check-task/SKILL.md +3 -3
- package/templates/.agents/skills/check-task/SKILL.zh-CN.md +3 -3
- package/templates/.agents/skills/commit/SKILL.md +1 -1
- package/templates/.agents/skills/commit/SKILL.zh-CN.md +1 -1
- package/templates/.agents/skills/complete-task/SKILL.md +7 -7
- package/templates/.agents/skills/complete-task/SKILL.zh-CN.md +7 -7
- package/templates/.agents/skills/create-issue/SKILL.md +2 -2
- package/templates/.agents/skills/create-issue/SKILL.zh-CN.md +2 -2
- package/templates/.agents/skills/create-pr/SKILL.md +1 -1
- package/templates/.agents/skills/create-pr/SKILL.zh-CN.md +1 -1
- package/templates/.agents/skills/create-task/SKILL.md +4 -4
- package/templates/.agents/skills/create-task/SKILL.zh-CN.md +4 -4
- package/templates/.agents/skills/implement-task/SKILL.md +8 -8
- package/templates/.agents/skills/implement-task/SKILL.zh-CN.md +8 -8
- package/templates/.agents/skills/import-codescan/SKILL.md +1 -1
- package/templates/.agents/skills/import-codescan/SKILL.zh-CN.md +1 -1
- package/templates/.agents/skills/import-dependabot/SKILL.md +3 -3
- package/templates/.agents/skills/import-dependabot/SKILL.zh-CN.md +3 -3
- package/templates/.agents/skills/import-issue/SKILL.md +5 -5
- package/templates/.agents/skills/import-issue/SKILL.zh-CN.md +5 -5
- package/templates/.agents/skills/plan-task/SKILL.md +6 -6
- package/templates/.agents/skills/plan-task/SKILL.zh-CN.md +6 -6
- package/templates/.agents/skills/refine-task/SKILL.md +3 -3
- package/templates/.agents/skills/refine-task/SKILL.zh-CN.md +3 -3
- package/templates/.agents/skills/release/SKILL.md +55 -14
- package/templates/.agents/skills/release/SKILL.zh-CN.md +55 -14
- package/templates/.agents/skills/review-task/SKILL.md +9 -9
- package/templates/.agents/skills/review-task/SKILL.zh-CN.md +9 -9
- package/templates/.agents/skills/sync-issue/SKILL.md +8 -8
- package/templates/.agents/skills/sync-issue/SKILL.zh-CN.md +8 -8
- package/templates/.agents/skills/sync-pr/SKILL.md +3 -3
- package/templates/.agents/skills/sync-pr/SKILL.zh-CN.md +3 -3
- package/templates/.agents/skills/update-agent-infra/SKILL.md +6 -6
- package/templates/.agents/skills/update-agent-infra/SKILL.zh-CN.md +6 -6
- package/templates/.agents/skills/update-agent-infra/scripts/sync-templates.js +61 -116
- package/templates/.agents/templates/handoff.md +1 -1
- package/templates/.agents/templates/handoff.zh-CN.md +1 -1
- package/templates/.agents/workflows/bug-fix.yaml +71 -71
- package/templates/.agents/workflows/bug-fix.zh-CN.yaml +1 -1
- package/templates/.agents/workflows/feature-development.yaml +71 -71
- package/templates/.agents/workflows/feature-development.zh-CN.yaml +1 -1
- package/templates/.agents/workflows/refactoring.yaml +76 -76
- package/templates/.agents/workflows/refactoring.zh-CN.yaml +1 -1
- package/templates/{.agent-workspace → .agents/workspace}/README.md +1 -1
- package/templates/{.agent-workspace → .agents/workspace}/README.zh-CN.md +1 -1
- package/templates/.claude/CLAUDE.md +1 -1
- package/templates/.claude/CLAUDE.zh-CN.md +1 -1
- package/templates/.claude/hooks/check-version-format.sh +44 -0
- package/templates/.claude/settings.json +14 -0
- package/templates/.opencode/COMMAND_STYLE_GUIDE.md +6 -6
- package/templates/.opencode/COMMAND_STYLE_GUIDE.zh-CN.md +6 -6
- package/templates/AGENTS.md +1 -1
- package/templates/AGENTS.zh-CN.md +1 -1
- package/templates/.editorconfig +0 -15
- package/templates/.github/ISSUE_TEMPLATE/01_bug_report.yml +0 -149
- package/templates/.github/ISSUE_TEMPLATE/02_question.yml +0 -101
- package/templates/.github/ISSUE_TEMPLATE/03_feature_request.yml +0 -131
- package/templates/.github/ISSUE_TEMPLATE/04_documentation.yml +0 -165
- package/templates/.github/ISSUE_TEMPLATE/05_other.yml +0 -147
- package/templates/.github/ISSUE_TEMPLATE/config.yml +0 -11
- package/templates/.github/PULL_REQUEST_TEMPLATE.md +0 -123
- package/templates/.github/dependabot.yml +0 -17
- package/templates/.github/hooks/check-utf8-encoding.sh +0 -25
- package/templates/.github/release.yml +0 -27
- package/templates/.github/workflows/pr-title-check.yml +0 -42
- package/templates/.mailmap +0 -4
- package/templates/CONTRIBUTING.md +0 -126
- package/templates/CONTRIBUTING.zh-CN.md +0 -124
- package/templates/SECURITY.md +0 -131
- 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 .
|
|
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 .
|
|
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 .
|
|
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 .
|
|
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 .
|
|
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 .
|
|
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 .
|
|
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 .
|
|
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
|
-
# "基于 .
|
|
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
|
-
# "实现 .
|
|
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 .
|
|
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 .
|
|
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 .
|
|
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 .
|
|
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
|
-
.
|
|
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 `.
|
|
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 `.
|
|
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 `.
|
|
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
|
-
.
|
|
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` 复制到 `.
|
|
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
|
-
通过存储在 `.
|
|
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
|
-
在 `.
|
|
146
|
+
在 `.agents/workspace/` 中,该目录已被 git ignore。只有 `.agents/` 中的模板和工作流定义受版本控制。
|
|
@@ -19,7 +19,7 @@ description: >
|
|
|
19
19
|
### 1. Verify Prerequisites
|
|
20
20
|
|
|
21
21
|
Check required files:
|
|
22
|
-
- `.
|
|
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 `.
|
|
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 `.
|
|
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 `.
|
|
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: .
|
|
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 `.
|
|
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
|
-
- `.
|
|
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
|
-
扫描 `.
|
|
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
|
-
创建 `.
|
|
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
|
-
更新 `.
|
|
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
|
-
- 分析报告:.
|
|
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
|
-
- [ ] 创建了分析文档 `.
|
|
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 `.
|
|
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 `.
|
|
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 .
|
|
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 .
|
|
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: .
|
|
96
|
+
Archived to: .agents/workspace/blocked/{task-id}/
|
|
97
97
|
|
|
98
98
|
To unblock when the issue is resolved:
|
|
99
|
-
mv .
|
|
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 `.
|
|
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 .
|
|
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
|
-
检查任务是否存在于 `.
|
|
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
|
-
更新 `.
|
|
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 .
|
|
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 .
|
|
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
|
-
归档路径:.
|
|
95
|
+
归档路径:.agents/workspace/blocked/{task-id}/
|
|
96
96
|
|
|
97
97
|
解除阻塞时执行:
|
|
98
|
-
mv .
|
|
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
|
-
- [ ] 将任务目录移动到 `.
|
|
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 .
|
|
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. `.
|
|
23
|
-
2. `.
|
|
24
|
-
3. `.
|
|
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. `.
|
|
21
|
-
2. `.
|
|
22
|
-
3. `.
|
|
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 `.
|
|
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
|
-
如果本次提交属于某个活动任务,且存在 `.
|
|
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 `.
|
|
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 `.
|
|
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 .
|
|
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 .
|
|
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: .
|
|
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 `.
|
|
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 .
|
|
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
|
-
检查任务是否存在于 `.
|
|
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
|
-
更新 `.
|
|
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 .
|
|
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 .
|
|
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
|
-
- 归档路径:.
|
|
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
|
-
- [ ] 将任务目录移动到 `.
|
|
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 .
|
|
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
|
-
- `.
|
|
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 `.
|
|
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
|
-
- `.
|
|
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
|
-
更新 `.
|
|
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 `.
|
|
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
|
-
如果有关联的活跃任务,更新 `.
|
|
206
|
+
如果有关联的活跃任务,更新 `.agents/workspace/active/{task-id}/task.md`:
|
|
207
207
|
- `pr_number`:{pr-number}
|
|
208
208
|
- `updated_at`:{当前时间}
|
|
209
209
|
- **追加**到 `## Activity Log`(不要覆盖之前的记录):
|