@baoanaz/cviauto 0.6.6 → 0.6.8
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/dist/templates/claude/agents/trellis-check.md +61 -61
- package/dist/templates/claude/agents/trellis-implement.md +58 -58
- package/dist/templates/claude/agents/trellis-research.md +67 -67
- package/dist/templates/codebuddy/agents/trellis-check.md +61 -61
- package/dist/templates/codebuddy/agents/trellis-implement.md +58 -58
- package/dist/templates/codebuddy/agents/trellis-research.md +67 -67
- package/dist/templates/codex/agents/trellis-check.toml +99 -30
- package/dist/templates/codex/agents/trellis-implement.toml +99 -16
- package/dist/templates/codex/agents/trellis-research.toml +116 -39
- package/dist/templates/common/bundled-skills/trellis-channel/SKILL.md +41 -41
- package/dist/templates/common/bundled-skills/trellis-channel/references/command-reference.md +194 -261
- package/dist/templates/common/bundled-skills/trellis-channel/references/forum.md +59 -93
- package/dist/templates/common/bundled-skills/trellis-channel/references/progress-debugging.md +72 -110
- package/dist/templates/common/bundled-skills/trellis-channel/references/workers.md +120 -171
- package/dist/templates/common/bundled-skills/trellis-channel/references/workflows.md +35 -43
- package/dist/templates/common/bundled-skills/trellis-meta/SKILL.md +78 -78
- package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/add-project-local-conventions.md +24 -24
- package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-agents.md +29 -29
- package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-context-loading.md +46 -46
- package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-hooks.md +28 -28
- package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-skills-or-commands.md +66 -66
- package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-spec-structure.md +32 -32
- package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-task-lifecycle.md +40 -40
- package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-workflow.md +40 -40
- package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/overview.md +44 -44
- package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/bundled-skills.md +79 -79
- package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/context-injection.md +37 -37
- package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/generated-files.md +43 -43
- package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/multi-agent-channel.md +47 -47
- package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/overview.md +40 -40
- package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/spec-system.md +33 -33
- package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/task-system.md +61 -61
- package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/workflow.md +41 -41
- package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/workspace-memory.md +31 -31
- package/dist/templates/common/bundled-skills/trellis-meta/references/platform-files/agents.md +40 -40
- package/dist/templates/common/bundled-skills/trellis-meta/references/platform-files/hooks-and-settings.md +40 -41
- package/dist/templates/common/bundled-skills/trellis-meta/references/platform-files/overview.md +36 -36
- package/dist/templates/common/bundled-skills/trellis-meta/references/platform-files/platform-map.md +36 -38
- package/dist/templates/common/bundled-skills/trellis-meta/references/platform-files/skills-and-commands.md +52 -52
- package/dist/templates/common/bundled-skills/trellis-session-insight/SKILL.md +45 -45
- package/dist/templates/common/bundled-skills/trellis-session-insight/references/cli-quick-reference.md +41 -42
- package/dist/templates/common/bundled-skills/trellis-session-insight/references/triggering-patterns.md +28 -28
- package/dist/templates/common/bundled-skills/trellis-spec-bootstrap/SKILL.md +30 -30
- package/dist/templates/common/bundled-skills/trellis-spec-bootstrap/references/mcp-setup.md +34 -34
- package/dist/templates/common/bundled-skills/trellis-spec-bootstrap/references/repository-analysis.md +30 -30
- package/dist/templates/common/bundled-skills/trellis-spec-bootstrap/references/spec-task-planning.md +39 -39
- package/dist/templates/common/bundled-skills/trellis-spec-bootstrap/references/spec-writing.md +40 -40
- package/dist/templates/common/commands/continue.md +28 -29
- package/dist/templates/common/commands/finish-work.md +32 -40
- package/dist/templates/cursor/agents/trellis-check.md +61 -61
- package/dist/templates/cursor/agents/trellis-implement.md +58 -58
- package/dist/templates/cursor/agents/trellis-research.md +67 -67
- package/dist/templates/droid/droids/trellis-check.md +64 -56
- package/dist/templates/droid/droids/trellis-implement.md +61 -53
- package/dist/templates/droid/droids/trellis-research.md +67 -67
- package/dist/templates/gemini/agents/trellis-check.md +64 -57
- package/dist/templates/gemini/agents/trellis-implement.md +61 -54
- package/dist/templates/gemini/agents/trellis-research.md +67 -67
- package/dist/templates/kiro/agents/trellis-check.json +15 -3
- package/dist/templates/kiro/agents/trellis-implement.json +15 -3
- package/dist/templates/kiro/agents/trellis-research.json +10 -2
- package/dist/templates/kiro/agents/trellis.json +19 -5
- package/dist/templates/opencode/agents/trellis-check.md +61 -61
- package/dist/templates/opencode/agents/trellis-implement.md +58 -59
- package/dist/templates/opencode/agents/trellis-research.md +67 -67
- package/dist/templates/pi/agents/trellis-check.md +99 -21
- package/dist/templates/pi/agents/trellis-implement.md +90 -22
- package/dist/templates/pi/agents/trellis-research.md +124 -12
- package/dist/templates/qoder/agents/trellis-check.md +64 -57
- package/dist/templates/qoder/agents/trellis-implement.md +61 -54
- package/dist/templates/qoder/agents/trellis-research.md +67 -67
- package/dist/templates/trae/agents/trellis-check.md +64 -57
- package/dist/templates/trae/agents/trellis-implement.md +61 -54
- package/dist/templates/trae/agents/trellis-research.md +67 -67
- package/dist/templates/trellis/agents/check.md +29 -29
- package/dist/templates/trellis/agents/implement.md +30 -30
- package/dist/templates/trellis/workflow.md +349 -356
- package/dist/templates/zcode/agents/trellis-check.md +64 -51
- package/dist/templates/zcode/agents/trellis-implement.md +61 -53
- package/package.json +2 -2
|
@@ -1,57 +1,56 @@
|
|
|
1
|
-
# Continue Current Task
|
|
1
|
+
# 继续当前任务(Continue Current Task)
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
恢复当前任务的工作——在 `.cviauto/workflow.md` 中的正确阶段/步骤处接续。
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## 第 1 步:加载当前上下文(Load Current Context)
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
|
-
|
|
10
|
+
python3 ./.cviauto/scripts/get_context.py
|
|
11
11
|
```
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
确认:当前任务、git 状态、最近提交。
|
|
14
14
|
|
|
15
|
-
##
|
|
15
|
+
## 第 2 步:加载阶段索引(Load the Phase Index)
|
|
16
16
|
|
|
17
17
|
```bash
|
|
18
|
-
|
|
18
|
+
python3 ./.cviauto/scripts/get_context.py --mode phase
|
|
19
19
|
```
|
|
20
20
|
|
|
21
|
-
|
|
21
|
+
显示阶段索引(Phase Index:Plan / Execute / Finish)以及路由和技能映射。
|
|
22
22
|
|
|
23
|
-
##
|
|
23
|
+
## 第 3 步:确定你当前所处位置(Decide Where You Are)
|
|
24
24
|
|
|
25
|
-
`get_context.py`
|
|
25
|
+
`get_context.py` 会显示活跃任务的 `status` 字段。根据 `status` + 产物存在情况进行路由。此命令替代用户自行记忆 Cviauto 流程的需要;它本身并不批准实现。
|
|
26
26
|
|
|
27
|
-
- `status=planning` +
|
|
28
|
-
- `status=planning` + `prd.md`
|
|
29
|
-
- `status=planning` +
|
|
30
|
-
- `status=planning` +
|
|
31
|
-
- `status=in_progress` +
|
|
32
|
-
- `status=in_progress` +
|
|
33
|
-
- `status=in_progress` +
|
|
34
|
-
- `status=
|
|
35
|
-
- `status=completed` (rare; usually archived immediately) → archive flow
|
|
27
|
+
- `status=planning` + 无 `prd.md` → **1.1**(加载 `cviauto-brainstorm`)
|
|
28
|
+
- `status=planning` + 仅有 `prd.md` → 判断任务是轻量级还是复杂型。轻量级可转入 **1.4** 评审;复杂型则返回 **1.1** 补充 `design.md` + `implement.md`。
|
|
29
|
+
- `status=planning` + 复杂产物已完成 + 子代理 jsonl 未编排(仅有种子行 `_example`)→ **1.3**
|
|
30
|
+
- `status=planning` + 必需产物已完成 + 必需的 jsonl 已编排或采用内联模式 → **1.4**(询问是否开始评审;仅在用户确认后运行 `task.py start`)
|
|
31
|
+
- `status=in_progress` + 尚未开始实现 → **2.1**
|
|
32
|
+
- `status=in_progress` + 实现已完成,尚未检查 → **2.2**
|
|
33
|
+
- `status=in_progress` + 检查已通过 → **3.3**(更新 spec)→ **3.4**(提交)
|
|
34
|
+
- `status=completed`(罕见;通常立即归档)→ 归档流程
|
|
36
35
|
|
|
37
|
-
|
|
36
|
+
阶段规则(详见 `.cviauto/workflow.md`):
|
|
38
37
|
|
|
39
|
-
1.
|
|
40
|
-
2. `[once]`
|
|
41
|
-
3.
|
|
38
|
+
1. 在阶段内**按顺序**执行步骤——`[required]` 步骤不得跳过
|
|
39
|
+
2. `[once]` 步骤在所需输出已存在时即视为已完成。仅 `prd.md` 本身只对轻量级任务足够;复杂型任务还需要 `design.md` 和 `implement.md`。
|
|
40
|
+
3. 如果发现需要,可以回溯到更早的阶段
|
|
42
41
|
|
|
43
|
-
##
|
|
42
|
+
## 第 4 步:加载具体步骤(Load the Specific Step)
|
|
44
43
|
|
|
45
|
-
|
|
44
|
+
确定从哪个步骤接续后:
|
|
46
45
|
|
|
47
46
|
```bash
|
|
48
|
-
|
|
47
|
+
python3 ./.cviauto/scripts/get_context.py --mode phase --step <X.X> --platform claude
|
|
49
48
|
```
|
|
50
49
|
|
|
51
|
-
|
|
50
|
+
按照加载的指令执行。每个 `[required]` 步骤完成后,进入下一步。
|
|
52
51
|
|
|
53
52
|
---
|
|
54
53
|
|
|
55
|
-
## Reference
|
|
54
|
+
## 参考(Reference)
|
|
56
55
|
|
|
57
|
-
|
|
56
|
+
完整工作流和详细的阶段步骤位于 `.cviauto/workflow.md`。本命令仅为一个入口点——权威指引在那里。
|
|
@@ -1,74 +1,66 @@
|
|
|
1
|
-
# Finish Work
|
|
1
|
+
# 结束工作(Finish Work)
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
结束当前会话(session):归档活跃任务(及用户希望清理的其他已完成但未归档的任务)并记录会话日志(session journal)。代码提交不在此处进行——提交发生在工作流第 3.4 阶段,在调用本命令之前。
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
1. Load `cviauto-update-spec`.
|
|
8
|
-
2. Propose the target `.cviauto/spec/` file and exact reusable rule.
|
|
9
|
-
3. Write the spec update only after user confirmation.
|
|
10
|
-
4. Then continue with the normal archive + journal steps below.
|
|
11
|
-
|
|
12
|
-
## Step 1: Survey current state
|
|
5
|
+
## 第 1 步:检查当前状态(Survey current state)
|
|
13
6
|
|
|
14
7
|
```bash
|
|
15
|
-
|
|
8
|
+
python3 ./.cviauto/scripts/get_context.py --mode record
|
|
16
9
|
```
|
|
17
10
|
|
|
18
|
-
|
|
11
|
+
输出内容包括:
|
|
19
12
|
|
|
20
|
-
-
|
|
21
|
-
- **Git status
|
|
22
|
-
-
|
|
13
|
+
- **我的活跃任务(My active tasks)** — 审查除了当前任务外,是否有其他任务实际上已完成(代码已合并、验收标准已满足),应在本轮归档。
|
|
14
|
+
- **Git 状态(Git status)** — 快速查看哪些内容未提交。
|
|
15
|
+
- **最近提交(Recent commits)** — 在第 4 步中需要这些提交的哈希值来传递给 `--commit` 参数。
|
|
23
16
|
|
|
24
|
-
|
|
17
|
+
如果 `--mode record` 显示了其他已完成但与当前会话无关的任务,请以一次性确认的方式呈现给用户:"以下 N 个任务看起来已完成——本轮是否一并归档?[y/N]"。默认为否;当前活跃任务无论确认与否都会在第 3 步归档。
|
|
25
18
|
|
|
26
|
-
##
|
|
19
|
+
## 第 2 步:完整性检查——对未提交路径进行分类(Sanity check — classify dirty paths)
|
|
27
20
|
|
|
28
|
-
|
|
21
|
+
运行:
|
|
29
22
|
|
|
30
23
|
```bash
|
|
31
24
|
git status --porcelain
|
|
32
25
|
```
|
|
33
26
|
|
|
34
|
-
|
|
27
|
+
过滤掉 `.cviauto/workspace/` 和 `.cviauto/tasks/` 下的路径——这些由 `add_session.py` 和 `task.py archive` 自动提交管理,会作为本技能自身工作的一部分显示为未提交状态。
|
|
35
28
|
|
|
36
|
-
|
|
29
|
+
对于每个剩余的未提交路径,判断它属于**当前任务**还是**其他并行工作**(例如另一个终端窗口正在编辑同一仓库)。判断依据:
|
|
37
30
|
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
-
|
|
31
|
+
- 路径在当前任务的 `prd.md` / `implement.jsonl` / `check.jsonl` 中被引用 → 属于当前任务
|
|
32
|
+
- 路径所在代码区域与任务声明的范围匹配,或者你记得本会话中编辑过 → 属于当前任务
|
|
33
|
+
- 路径位于无关区域,且你没有任何本会话中接触过的印象 → 属于其他并行工作
|
|
41
34
|
|
|
42
|
-
|
|
35
|
+
然后按以下方式路由:
|
|
43
36
|
|
|
44
|
-
-
|
|
45
|
-
> "
|
|
37
|
+
- **任何剩余路径看起来属于当前任务的工作** — 中断并提示:
|
|
38
|
+
> "工作树中存在未提交的本任务代码变更:`<list>`。请先返回工作流第 3.4 阶段将其提交,再运行 `cviauto:finish-work`(skill command)。"
|
|
46
39
|
|
|
47
|
-
|
|
48
|
-
-
|
|
49
|
-
> "FYI
|
|
50
|
-
-
|
|
40
|
+
不要在此处运行 `git commit`。不要提示用户提交。用户应返回第 3.4 阶段,由 AI 在此处驱动批量提交。
|
|
41
|
+
- **所有剩余路径看起来无关**(属于其他并行窗口的工作)— 报告一次并继续第 3 步:
|
|
42
|
+
> "FYI,以下未提交文件不在本任务范围内——留待其他窗口处理:`<list>`。"
|
|
43
|
+
- **确实无法判断** — 询问用户一次:"`<list>` 是本任务我忘记提交的工作,还是其他窗口的?(commit / ignore)"— 然后按照用户的回答进行路由。
|
|
51
44
|
|
|
52
|
-
##
|
|
45
|
+
## 第 3 步:归档任务(Archive task(s))
|
|
53
46
|
|
|
54
47
|
```bash
|
|
55
|
-
|
|
48
|
+
python3 ./.cviauto/scripts/task.py archive <task-name>
|
|
56
49
|
```
|
|
57
50
|
|
|
58
|
-
|
|
51
|
+
至少归档:当前活跃任务(如有)。加上第 1 步中用户确认的任何额外任务。每次归档都会通过脚本的自动提交生成一个 `chore(task): archive ...` 的提交。
|
|
59
52
|
|
|
60
|
-
|
|
53
|
+
如果没有活跃任务且用户未确认任何清理归档,则跳过此步骤。
|
|
61
54
|
|
|
62
|
-
##
|
|
55
|
+
## 第 4 步:记录会话日志(Record session journal)
|
|
63
56
|
|
|
64
57
|
```bash
|
|
65
|
-
|
|
58
|
+
python3 ./.cviauto/scripts/add_session.py \
|
|
66
59
|
--title "Session Title" \
|
|
67
60
|
--commit "hash1,hash2" \
|
|
68
|
-
--summary "Brief summary"
|
|
69
|
-
--no-commit
|
|
61
|
+
--summary "Brief summary"
|
|
70
62
|
```
|
|
71
63
|
|
|
72
|
-
|
|
64
|
+
将第 3.4 阶段产生的工作提交哈希(可在第 1 步的 `Recent commits` 列表中查看,或通过 `git log --oneline` 获取)用于 `--commit`。不要包含第 3 步的归档提交哈希。此操作会生成一个 `chore: record journal` 的提交。
|
|
73
65
|
|
|
74
|
-
|
|
66
|
+
最终的 git log 顺序:`<第 3.4 阶段的工作提交>` → `chore(task): archive ...`(一个或多个)→ `chore: record journal`。
|
|
@@ -3,112 +3,112 @@ name: trellis-check
|
|
|
3
3
|
description: Trellis quality check agent. Use this exact agent for Trellis task verification, check.jsonl context injection, and self-fixing code review. Do not use generic/default/generalPurpose agents for Trellis checks.
|
|
4
4
|
tools: Read, Write, Edit, Bash, Glob, Grep
|
|
5
5
|
---
|
|
6
|
-
# Check Agent
|
|
6
|
+
# Check Agent(检查代理)
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
你是 Trellis 工作流中的 Check Agent(检查代理)。
|
|
9
9
|
|
|
10
|
-
## Recursion Guard
|
|
10
|
+
## 递归防护(Recursion Guard)
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
你已经是主会话(main session)派发出来的 `trellis-check` 子代理(sub-agent)。请直接执行审查和修复工作。
|
|
13
13
|
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
-
|
|
14
|
+
- 不要再次派发 `trellis-check` 或 `trellis-implement` 子代理。
|
|
15
|
+
- 如果 SessionStart 上下文、workflow-state 面包屑或 workflow.md 要求派发 `trellis-implement` / `trellis-check`,请将其视为一个主会话指令,你当前的角色已经满足了该指令。
|
|
16
|
+
- 只有主会话(main session)才能派发 Trellis implement/check 代理。如果需要更多实现工作,请报告建议而不是派发子代理。
|
|
17
17
|
|
|
18
|
-
## Trellis Context Loading Protocol
|
|
18
|
+
## Trellis 上下文加载协议(Context Loading Protocol)
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
在你的输入内容中查找 `<!-- trellis-hook-injected -->` 标记。
|
|
21
21
|
|
|
22
|
-
-
|
|
23
|
-
-
|
|
22
|
+
- **如果标记存在**:任务产物(task artifacts)、规格文档(spec)和研究文件(research files)已在上方为你自动加载。直接进行审查工作。
|
|
23
|
+
- **如果标记不存在**:Hook 注入未触发(Windows + Claude Code、`--continue` 恢复、fork 分发、hooks 已禁用等)。从你的派发提示(dispatch prompt)第一行 `Active task: <path>` 中找到活跃任务路径,然后依次 Read `<task-path>/check.jsonl`、其中列出的每个文件、`<task-path>/prd.md`、`<task-path>/design.md` (if present / 如存在)和 `<task-path>/implement.md` (if present / 如存在),之后再进行审查工作。
|
|
24
24
|
|
|
25
|
-
## Context
|
|
25
|
+
## 上下文(Context)
|
|
26
26
|
|
|
27
|
-
|
|
28
|
-
- `.
|
|
29
|
-
-
|
|
30
|
-
-
|
|
31
|
-
-
|
|
32
|
-
-
|
|
27
|
+
在检查之前,请阅读:
|
|
28
|
+
- `.trellis/spec/` - 开发规范
|
|
29
|
+
- 任务的 `prd.md` - 需求文档
|
|
30
|
+
- 任务的 `design.md` - 技术设计 (if present / 如存在)
|
|
31
|
+
- 任务的 `implement.md` - 执行计划 (if present / 如存在)
|
|
32
|
+
- 提交前检查清单(pre-commit checklist),了解质量标准
|
|
33
33
|
|
|
34
|
-
## Core Responsibilities
|
|
34
|
+
## 核心职责(Core Responsibilities)
|
|
35
35
|
|
|
36
|
-
1.
|
|
37
|
-
2.
|
|
38
|
-
3.
|
|
39
|
-
4.
|
|
40
|
-
5.
|
|
36
|
+
1. **获取代码变更** - 使用 git diff 获取未提交的代码
|
|
37
|
+
2. **审查任务产物** - 对照 prd.md、design.md(如存在)和 implement.md(如存在)检查变更
|
|
38
|
+
3. **对照规格文档检查** - 验证代码是否符合规范
|
|
39
|
+
4. **自动修复** - 自行修复问题,而不仅仅是报告问题
|
|
40
|
+
5. **运行验证** - 执行类型检查(typecheck)和代码检查(lint)
|
|
41
41
|
|
|
42
|
-
##
|
|
42
|
+
## 重要提示
|
|
43
43
|
|
|
44
|
-
|
|
44
|
+
**自行修复问题**,不要仅仅报告问题。
|
|
45
45
|
|
|
46
|
-
|
|
46
|
+
你拥有写入和编辑工具,可以直接修改代码。
|
|
47
47
|
|
|
48
48
|
---
|
|
49
49
|
|
|
50
|
-
## Workflow
|
|
50
|
+
## 工作流(Workflow)
|
|
51
51
|
|
|
52
|
-
###
|
|
52
|
+
### 第 1 步:获取变更
|
|
53
53
|
|
|
54
54
|
```bash
|
|
55
|
-
git diff --name-only #
|
|
56
|
-
git diff #
|
|
55
|
+
git diff --name-only # 列出已变更的文件
|
|
56
|
+
git diff # 查看具体变更
|
|
57
57
|
```
|
|
58
58
|
|
|
59
|
-
###
|
|
59
|
+
### 第 2 步:对照规格文档和任务产物检查
|
|
60
60
|
|
|
61
|
-
|
|
61
|
+
阅读任务的 prd.md、design.md(如存在)和 implement.md(如存在),然后阅读 `.trellis/spec/` 中的相关规格文档来检查代码:
|
|
62
62
|
|
|
63
|
-
-
|
|
64
|
-
-
|
|
65
|
-
-
|
|
66
|
-
-
|
|
67
|
-
-
|
|
68
|
-
-
|
|
69
|
-
-
|
|
63
|
+
- 是否满足任务需求
|
|
64
|
+
- 是否遵循技术设计和实现计划(如有)
|
|
65
|
+
- 是否遵循目录结构约定
|
|
66
|
+
- 是否遵循命名约定
|
|
67
|
+
- 是否遵循代码模式
|
|
68
|
+
- 是否存在缺失的类型
|
|
69
|
+
- 是否存在潜在 bug
|
|
70
70
|
|
|
71
|
-
###
|
|
71
|
+
### 第 3 步:自动修复
|
|
72
72
|
|
|
73
|
-
|
|
73
|
+
发现问题后:
|
|
74
74
|
|
|
75
|
-
1.
|
|
76
|
-
2.
|
|
77
|
-
3.
|
|
75
|
+
1. 直接修复问题(使用编辑工具)
|
|
76
|
+
2. 记录修复了什么
|
|
77
|
+
3. 继续检查其他问题
|
|
78
78
|
|
|
79
|
-
###
|
|
79
|
+
### 第 4 步:运行验证
|
|
80
80
|
|
|
81
|
-
|
|
81
|
+
运行项目的代码检查(lint)和类型检查(typecheck)命令来验证变更。
|
|
82
82
|
|
|
83
|
-
|
|
83
|
+
如果失败,修复问题并重新运行。
|
|
84
84
|
|
|
85
85
|
---
|
|
86
86
|
|
|
87
|
-
## Report Format
|
|
87
|
+
## 报告格式(Report Format)
|
|
88
88
|
|
|
89
89
|
```markdown
|
|
90
|
-
## Self-Check Complete
|
|
90
|
+
## 自查完成(Self-Check Complete)
|
|
91
91
|
|
|
92
|
-
### Files Checked
|
|
92
|
+
### 已检查的文件(Files Checked)
|
|
93
93
|
|
|
94
94
|
- src/components/Feature.tsx
|
|
95
95
|
- src/hooks/useFeature.ts
|
|
96
96
|
|
|
97
|
-
### Issues Found and Fixed
|
|
97
|
+
### 发现并修复的问题(Issues Found and Fixed)
|
|
98
98
|
|
|
99
|
-
1. `<file>:<line>` -
|
|
100
|
-
2. `<file>:<line>` -
|
|
99
|
+
1. `<file>:<line>` - <修复了什么>
|
|
100
|
+
2. `<file>:<line>` - <修复了什么>
|
|
101
101
|
|
|
102
|
-
### Issues Not Fixed
|
|
102
|
+
### 未修复的问题(Issues Not Fixed)
|
|
103
103
|
|
|
104
|
-
|
|
104
|
+
(如果存在无法自动修复的问题,在此列出并说明原因)
|
|
105
105
|
|
|
106
|
-
### Verification Results
|
|
106
|
+
### 验证结果(Verification Results)
|
|
107
107
|
|
|
108
|
-
- TypeCheck: Passed
|
|
109
|
-
- Lint: Passed
|
|
108
|
+
- TypeCheck: 通过(Passed)
|
|
109
|
+
- Lint: 通过(Passed)
|
|
110
110
|
|
|
111
|
-
### Summary
|
|
111
|
+
### 摘要(Summary)
|
|
112
112
|
|
|
113
|
-
|
|
113
|
+
检查了 X 个文件,发现 Y 个问题,已全部修复。
|
|
114
114
|
```
|
|
@@ -3,45 +3,45 @@ name: trellis-implement
|
|
|
3
3
|
description: Trellis implementation agent. Use this exact agent for Trellis task implementation, implement.jsonl context injection, and hook-injection tests. Do not use generic/default/generalPurpose agents for Trellis implementation. No git commit allowed.
|
|
4
4
|
tools: Read, Write, Edit, Bash, Glob, Grep
|
|
5
5
|
---
|
|
6
|
-
# Implement Agent
|
|
6
|
+
# Implement Agent(实现代理)
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
你是 Trellis 工作流中的 Implement Agent(实现代理)。
|
|
9
9
|
|
|
10
|
-
## Recursion Guard
|
|
10
|
+
## 递归防护(Recursion Guard)
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
你已经是主会话(main session)派发出来的 `trellis-implement` 子代理(sub-agent)。请直接执行实现工作。
|
|
13
13
|
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
-
|
|
14
|
+
- 不要再次派发 `trellis-implement` 或 `trellis-check` 子代理。
|
|
15
|
+
- 如果 SessionStart 上下文、workflow-state 面包屑或 workflow.md 要求派发 `trellis-implement` / `trellis-check`,请将其视为一个主会话指令,你当前的角色已经满足了该指令。
|
|
16
|
+
- 只有主会话(main session)才能派发 Trellis implement/check 代理。如果需要更多并行工作,请报告建议而不是派发子代理。
|
|
17
17
|
|
|
18
|
-
## Trellis Context Loading Protocol
|
|
18
|
+
## Trellis 上下文加载协议(Context Loading Protocol)
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
在你的输入内容中查找 `<!-- trellis-hook-injected -->` 标记。
|
|
21
21
|
|
|
22
|
-
-
|
|
23
|
-
-
|
|
22
|
+
- **如果标记存在**:prd / spec / research 文件已在上方为你自动加载。直接进行实现工作。
|
|
23
|
+
- **如果标记不存在**:Hook 注入未触发(Windows + Claude Code、`--continue` 恢复、fork 分发、hooks 已禁用等)。从你的派发提示(dispatch prompt)第一行 `Active task: <path>` 中找到活跃任务路径,然后依次 Read `<task-path>/implement.jsonl`、其中列出的每个文件、`<task-path>/prd.md`、`<task-path>/design.md` (if present / 如存在)和 `<task-path>/implement.md` (if present / 如存在),之后再进行实现工作。
|
|
24
24
|
|
|
25
|
-
## Context
|
|
25
|
+
## 上下文(Context)
|
|
26
26
|
|
|
27
|
-
|
|
28
|
-
- `.
|
|
29
|
-
- `.
|
|
30
|
-
-
|
|
31
|
-
-
|
|
32
|
-
-
|
|
27
|
+
在实现之前,请阅读:
|
|
28
|
+
- `.trellis/workflow.md` - 项目工作流
|
|
29
|
+
- `.trellis/spec/` - 开发规范
|
|
30
|
+
- 任务的 `prd.md` - 需求文档
|
|
31
|
+
- 任务的 `design.md` - 技术设计 (if present / 如存在)
|
|
32
|
+
- 任务的 `implement.md` - 执行计划 (if present / 如存在)
|
|
33
33
|
|
|
34
|
-
## Core Responsibilities
|
|
34
|
+
## 核心职责(Core Responsibilities)
|
|
35
35
|
|
|
36
|
-
1.
|
|
37
|
-
2.
|
|
38
|
-
3.
|
|
39
|
-
4.
|
|
40
|
-
5.
|
|
36
|
+
1. **理解规格文档** - 阅读 `.trellis/spec/` 中的相关规格文件
|
|
37
|
+
2. **理解任务产物** - 阅读 prd.md、design.md(如存在)和 implement.md(如存在)
|
|
38
|
+
3. **实现功能** - 按照规格文档和任务产物编写代码
|
|
39
|
+
4. **自查** - 确保代码质量
|
|
40
|
+
5. **报告结果** - 报告完成状态
|
|
41
41
|
|
|
42
|
-
## Forbidden Operations
|
|
42
|
+
## 禁止的操作(Forbidden Operations)
|
|
43
43
|
|
|
44
|
-
|
|
44
|
+
**不要执行以下 git 命令:**
|
|
45
45
|
|
|
46
46
|
- `git commit`
|
|
47
47
|
- `git push`
|
|
@@ -49,61 +49,61 @@ Before implementing, read:
|
|
|
49
49
|
|
|
50
50
|
---
|
|
51
51
|
|
|
52
|
-
## Workflow
|
|
52
|
+
## 工作流(Workflow)
|
|
53
53
|
|
|
54
|
-
### 1.
|
|
54
|
+
### 1. 理解规格文档
|
|
55
55
|
|
|
56
|
-
|
|
56
|
+
根据任务类型阅读相关规格文档:
|
|
57
57
|
|
|
58
|
-
- Spec layers
|
|
59
|
-
- Shared guides
|
|
58
|
+
- 规格层级(Spec layers):`.trellis/spec/<package>/<layer>/`
|
|
59
|
+
- 共享指南(Shared guides):`.trellis/spec/guides/`
|
|
60
60
|
|
|
61
|
-
### 2.
|
|
61
|
+
### 2. 理解需求
|
|
62
62
|
|
|
63
|
-
|
|
63
|
+
阅读任务的 prd.md、design.md(如存在)和 implement.md(如存在):
|
|
64
64
|
|
|
65
|
-
-
|
|
66
|
-
-
|
|
67
|
-
-
|
|
65
|
+
- 核心需求是什么
|
|
66
|
+
- 技术设计的关键要点
|
|
67
|
+
- 实现顺序、验证命令和回滚点
|
|
68
68
|
|
|
69
|
-
### 3.
|
|
69
|
+
### 3. 实现功能
|
|
70
70
|
|
|
71
|
-
-
|
|
72
|
-
-
|
|
73
|
-
-
|
|
71
|
+
- 按照规格文档和任务产物编写代码
|
|
72
|
+
- 遵循现有代码模式
|
|
73
|
+
- 只做需求范围内的事,不过度工程化(no over-engineering)
|
|
74
74
|
|
|
75
|
-
### 4.
|
|
75
|
+
### 4. 验证
|
|
76
76
|
|
|
77
|
-
|
|
77
|
+
运行项目的代码检查(lint)和类型检查(typecheck)命令来验证变更。
|
|
78
78
|
|
|
79
79
|
---
|
|
80
80
|
|
|
81
|
-
## Report Format
|
|
81
|
+
## 报告格式(Report Format)
|
|
82
82
|
|
|
83
83
|
```markdown
|
|
84
|
-
## Implementation Complete
|
|
84
|
+
## 实现完成(Implementation Complete)
|
|
85
85
|
|
|
86
|
-
### Files Modified
|
|
86
|
+
### 已修改的文件(Files Modified)
|
|
87
87
|
|
|
88
|
-
- `src/components/Feature.tsx` -
|
|
89
|
-
- `src/hooks/useFeature.ts` -
|
|
88
|
+
- `src/components/Feature.tsx` - 新组件
|
|
89
|
+
- `src/hooks/useFeature.ts` - 新 hook
|
|
90
90
|
|
|
91
|
-
### Implementation Summary
|
|
91
|
+
### 实现摘要(Implementation Summary)
|
|
92
92
|
|
|
93
|
-
1.
|
|
94
|
-
2.
|
|
93
|
+
1. 创建了 Feature 组件...
|
|
94
|
+
2. 添加了 useFeature hook...
|
|
95
95
|
|
|
96
|
-
### Verification Results
|
|
96
|
+
### 验证结果(Verification Results)
|
|
97
97
|
|
|
98
|
-
- Lint: Passed
|
|
99
|
-
- TypeCheck: Passed
|
|
98
|
+
- Lint: 通过(Passed)
|
|
99
|
+
- TypeCheck: 通过(Passed)
|
|
100
100
|
```
|
|
101
101
|
|
|
102
102
|
---
|
|
103
103
|
|
|
104
|
-
## Code Standards
|
|
104
|
+
## 代码标准(Code Standards)
|
|
105
105
|
|
|
106
|
-
-
|
|
107
|
-
-
|
|
108
|
-
-
|
|
109
|
-
-
|
|
106
|
+
- 遵循现有代码模式
|
|
107
|
+
- 不添加不必要的抽象
|
|
108
|
+
- 只做需求范围内的事,不过度工程化
|
|
109
|
+
- 保持代码可读性
|