helloagents 3.1.1 → 3.1.3
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/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +1 -1
- package/README.md +20 -9
- package/README_CN.md +21 -11
- package/bootstrap-lite.md +48 -34
- package/bootstrap.md +66 -52
- package/cli.mjs +1 -1
- package/gemini-extension.json +1 -1
- package/package.json +1 -1
- package/scripts/cli-branch.mjs +21 -3
- package/scripts/guard.mjs +4 -4
- package/scripts/notify-context.mjs +3 -3
- package/scripts/runtime-context.mjs +2 -2
- package/scripts/runtime-scope.mjs +26 -1
- package/scripts/workflow-recommendation.mjs +16 -16
- package/scripts/workflow-state.mjs +4 -4
- package/skills/commands/auto/SKILL.md +8 -5
- package/skills/commands/build/SKILL.md +1 -1
- package/skills/commands/commit/SKILL.md +2 -2
- package/skills/commands/help/SKILL.md +4 -1
- package/skills/commands/idea/SKILL.md +1 -0
- package/skills/commands/init/SKILL.md +1 -1
- package/skills/commands/loop/SKILL.md +1 -1
- package/skills/commands/office/SKILL.md +86 -0
- package/skills/commands/prd/SKILL.md +1 -1
- package/skills/commands/qa/SKILL.md +2 -2
- package/skills/hello-arch/SKILL.md +1 -1
- package/skills/hello-write/SKILL.md +2 -2
- package/skills/helloagents/SKILL.md +12 -9
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: ~auto
|
|
3
|
-
description: 自动执行命令 — 自动选择并依次执行 ~idea / ~plan / ~build / ~qa / ~prd,默认持续推进直到交付完成(~auto 命令)
|
|
3
|
+
description: 自动执行命令 — 自动选择并依次执行 ~idea / ~office / ~plan / ~build / ~qa / ~prd,默认持续推进直到交付完成(~auto 命令)
|
|
4
4
|
policy:
|
|
5
5
|
allow_implicit_invocation: false
|
|
6
6
|
---
|
|
7
7
|
Trigger: ~auto <任务描述>
|
|
8
8
|
|
|
9
|
-
`~auto` 是自动执行命令。它根据任务类型、复杂度、风险等级与项目状态,在 `~idea`、`~plan`、`~build`、`~qa`、`~prd` 之间选择合适主路径,并连续推进。
|
|
9
|
+
`~auto` 是自动执行命令。它根据任务类型、复杂度、风险等级与项目状态,在 `~idea`、`~office`、`~plan`、`~build`、`~qa`、`~prd` 之间选择合适主路径,并连续推进。
|
|
10
10
|
`~auto` 不止做一次选路;主路径一旦确定,就按需要继续执行后续阶段,默认持续推进直到完成交付,只有命中 HelloAGENTS 阻塞判定时才停下。
|
|
11
11
|
|
|
12
12
|
## 铁律
|
|
@@ -16,7 +16,7 @@ Trigger: ~auto <任务描述>
|
|
|
16
16
|
- 主路径一旦确定,立即读取对应 command skill,并在阶段完成后继续执行后续阶段,避免同一任务重复探索或重复等待
|
|
17
17
|
- 选路不替代授权;涉及外部副作用或高风险不可逆操作时,仍遵守 HelloAGENTS 阻塞判定与确认规则
|
|
18
18
|
- 用户显式使用 `~auto`,表示已授权在当前任务边界内沿选定主路径持续执行;若当前运行在 Codex `/goal` 下,`/goal` 只提供长程续跑与预算,`~auto` 仍按方案包、`state_path` 与验证契约推进;`~plan` / `~prd` 作为中间阶段时,不再额外询问“是否开始执行”,除非仍有真实阻塞;不得把 `🔄 下一步` 当作阶段交接或继续执行占位
|
|
19
|
-
-
|
|
19
|
+
- 优先消费当前上下文中已注入的“选路与分层”结果、当前工作流约束与项目状态;不要在 `~auto` 内另建一套关键词路由表
|
|
20
20
|
|
|
21
21
|
## 流程
|
|
22
22
|
|
|
@@ -32,10 +32,11 @@ Trigger: ~auto <任务描述>
|
|
|
32
32
|
|
|
33
33
|
### 1. 选路
|
|
34
34
|
|
|
35
|
-
-
|
|
35
|
+
- 先按当前上下文里已注入的“选路与分层”语义约束判断,不依赖关键词命中做机械分流
|
|
36
36
|
- 若当前上下文没有足够的注入约束,再结合以下信号补足判断:影响范围、风险等级、是否需要结构化产物、是否已有活跃方案包、用户是否只想先比较方向
|
|
37
37
|
- 选路优先级:
|
|
38
38
|
- 纯探索 / 点子 / 方向比较 → `~idea`
|
|
39
|
+
- 值得做与否 / 范围收缩 / 先做多大仍不清楚 → `~office`
|
|
39
40
|
- 明确要求质量审查 / 验真 / 跑检查 / 收尾 → `~qa`
|
|
40
41
|
- 0 到 1 / 产品级 / 多维规格 → `~prd`
|
|
41
42
|
- 多文件功能 / 架构变更 / 新项目规划 → `~plan`
|
|
@@ -43,7 +44,7 @@ Trigger: ~auto <任务描述>
|
|
|
43
44
|
|
|
44
45
|
### 2. 按 Tier 校正
|
|
45
46
|
|
|
46
|
-
- `T0` →
|
|
47
|
+
- `T0` → 在 `~idea` / `~office` 之间选择,不创建项目文件
|
|
47
48
|
- `T1` → 在 `~build` / `~qa` 间选择最短可交付路径
|
|
48
49
|
- `T2` → 需要结构化产物或范围未完全明确时优先 `~plan`
|
|
49
50
|
- `T3` → 纯质量审查/验真走 `~qa`;其余默认 `~plan` 或 `~prd`,待方案与风险边界明确后再进入实现
|
|
@@ -51,6 +52,7 @@ Trigger: ~auto <任务描述>
|
|
|
51
52
|
### 3. 读取对应命令并执行主路径
|
|
52
53
|
|
|
53
54
|
- 选中 `idea` → 读取 `skills/commands/idea/SKILL.md`
|
|
55
|
+
- 选中 `office` → 读取 `skills/commands/office/SKILL.md`
|
|
54
56
|
- 选中 `plan` → 读取 `skills/commands/plan/SKILL.md`
|
|
55
57
|
- 选中 `build` → 读取 `skills/commands/build/SKILL.md`
|
|
56
58
|
- 选中 `qa` → 读取 `skills/commands/qa/SKILL.md`
|
|
@@ -65,6 +67,7 @@ Trigger: ~auto <任务描述>
|
|
|
65
67
|
- 若主路径是 `~prd` → PRD / 任务 / 契约写入后,若当前任务来自 `~auto` 且未命中阻塞判定,按当前结果继续进入 `~build`,必要时先补一轮轻量 `~plan`
|
|
66
68
|
- 若主路径是 `~qa` → 完成质量闭环 / 收尾后结束
|
|
67
69
|
- 若主路径是 `~idea`,且用户本意就是探索/比较,则在探索输出后结束;若探索后已有明确方向且当前任务仍要求写文件或改代码,则继续进入 `~plan` 或 `~build`
|
|
70
|
+
- 若主路径是 `~office`,且用户本意就是先做价值/范围判断,则在评估输出后结束;若评估结论已经明确需要结构化方案或直接实现,则继续进入 `~plan` / `~build`
|
|
68
71
|
- 若 Codex active goal 的目标已满足 → 仍先完成 `~qa` 与 HelloAGENTS 收尾,再标记 goal complete;未满足时继续下一项可执行 AFK 任务
|
|
69
72
|
|
|
70
73
|
### 5. 何时允许停下
|
|
@@ -64,5 +64,5 @@ Trigger: ~build [description]
|
|
|
64
64
|
- 有方案包时,只同步本次实现直接影响的任务状态;未完成项保持打开
|
|
65
65
|
- 当前实现已闭合、且需要进入交付或收尾时,转入 `~qa`
|
|
66
66
|
- 若 Codex active goal 仍有未完成 AFK 任务,继续下一项可执行任务;若目标已满足,先转入 `~qa` 与 HelloAGENTS 收尾,再标记 goal complete
|
|
67
|
-
- 状态文件、知识库、`CHANGELOG.md`、modules 文档与归档边界,按当前已加载的 HelloAGENTS
|
|
67
|
+
- 状态文件、知识库、`CHANGELOG.md`、modules 文档与归档边界,按当前已加载的 HelloAGENTS 规则进入质量闭环 / 收尾与归档
|
|
68
68
|
- 不在 `~build` 内把仍未闭合的方案包整体报告为已完成
|
|
@@ -6,7 +6,7 @@ policy:
|
|
|
6
6
|
---
|
|
7
7
|
Trigger: ~commit [message]
|
|
8
8
|
|
|
9
|
-
执行 `~commit` 时,知识库同步与状态文件更新范围按当前已加载的 HelloAGENTS
|
|
9
|
+
执行 `~commit` 时,知识库同步与状态文件更新范围按当前已加载的 HelloAGENTS“收尾与归档”/ 流程状态要求执行;本命令只负责生成提交信息、读取提交归属配置并完成提交动作。
|
|
10
10
|
`auto_commit_enabled=false` 只关闭收尾阶段的自动提交,不影响显式 `~commit`。
|
|
11
11
|
|
|
12
12
|
## 流程
|
|
@@ -28,4 +28,4 @@ Trigger: ~commit [message]
|
|
|
28
28
|
- 0 = 跳过
|
|
29
29
|
- 1 = 知识库已存在时自动同步(默认)
|
|
30
30
|
- 2 = 编码任务在知识库已存在或当前项目已初始化时自动创建或同步
|
|
31
|
-
同步范围与更新格式按当前已加载的 HelloAGENTS
|
|
31
|
+
同步范围与更新格式按当前已加载的 HelloAGENTS“收尾与归档”阶段执行。
|
|
@@ -12,6 +12,7 @@ Trigger: ~help
|
|
|
12
12
|
| 命令 | 说明 |
|
|
13
13
|
|------|------|
|
|
14
14
|
| ~idea | 轻量点子探索与方向比较 |
|
|
15
|
+
| ~office | 价值与范围评估:先判断该不该做、该做多大、先做哪一小块 |
|
|
15
16
|
| ~auto | 自动执行:自动选主路径并持续推进到实现 / 质量闭环 / 收尾,除非命中真实阻塞 |
|
|
16
17
|
| ~plan | 结构化规划:需求澄清 + 方案确认 + 方案包 |
|
|
17
18
|
| ~build | 执行实现:按需求或方案包完成实现与局部验证 |
|
|
@@ -29,6 +30,8 @@ Trigger: ~help
|
|
|
29
30
|
- `~design` → 等同 `~plan`
|
|
30
31
|
- `~review` → 等同 `~qa`
|
|
31
32
|
|
|
33
|
+
核心规则默认生效:HelloAGENTS 会通过 `bootstrap.md` / `bootstrap-lite.md` 在运行时持续执行方案纠偏与语言纪律;这不是新增命令,也不是新增技能计数。
|
|
34
|
+
|
|
32
35
|
### 自动激活技能
|
|
33
36
|
以下技能仅在宿主全局模式或已初始化项目时自动激活(例如当前项目级规则文件已包含 `<!-- HELLOAGENTS_PROFILE: full -->`,通常由 `~init` 建立)。
|
|
34
37
|
纯标准模式、且项目未初始化时不会自动触发这些技能;但涉及 UI 的任务仍受 UI 质量基线约束。
|
|
@@ -45,7 +48,7 @@ Trigger: ~help
|
|
|
45
48
|
| output_language | "" | 空=跟随用户语言/填写则指定(如 zh-CN、en) | Claude Code + Gemini CLI + Codex CLI |
|
|
46
49
|
| output_format | true | true=主代理最终回复必须使用 HelloAGENTS 格式,流式/中间输出及子代理输出保持自然;false=自然输出 | Claude Code + Gemini CLI + Codex CLI |
|
|
47
50
|
| notify_level | 0 | 0=关闭/1=桌面通知/2=声音/3=两者 | Claude Code + Gemini CLI + Codex CLI |
|
|
48
|
-
| ralph_loop_enabled | true | 收尾 QA
|
|
51
|
+
| ralph_loop_enabled | true | 收尾 QA 门禁(显式 ~qa / ~loop 或收尾要求时触发审查、lint/test/build) | Claude Code + Gemini CLI + Codex CLI |
|
|
49
52
|
| guard_enabled | true | 阻断危险命令与写入后的安全扫描 | Claude Code + Gemini CLI + Codex CLI |
|
|
50
53
|
| kb_create_mode | 1 | 0=关闭/1=知识库已存在时自动同步/2=编码任务在知识库已存在或当前项目已初始化时自动创建或同步 | Claude Code + Gemini CLI + Codex CLI |
|
|
51
54
|
| project_store_mode | "local" | "local"=知识库/方案包保留在项目本地 `.helloagents/`;"repo-shared"=本地 `.helloagents/` 仅保留项目本地状态/运行态,知识库与方案包改写到 `~/.helloagents/projects/<repo-key>/` | Claude Code + Gemini CLI + Codex CLI |
|
|
@@ -8,7 +8,7 @@ Trigger: ~init
|
|
|
8
8
|
|
|
9
9
|
`~init` 是用户显式命令,用来初始化或刷新当前项目的完整工作流。
|
|
10
10
|
它不受 `kb_create_mode` 限制。
|
|
11
|
-
执行 `~init` 时,按当前规则模板创建或更新项目本地 `.helloagents
|
|
11
|
+
执行 `~init` 时,按当前规则模板创建或更新项目本地 `.helloagents/`,同步知识库,并为支持的宿主写入项目级完整规则标记:`<!-- HELLOAGENTS_PROFILE: full -->`。
|
|
12
12
|
`.helloagents/` 在本 skill 中统一按项目级存储路径理解:项目本地 `.helloagents/` 继续承担项目本地存储目录;状态文件只使用 `state_path`;若 `project_store_mode=repo-shared`,知识库、`DESIGN.md` 与方案包按当前上下文中已注入的项目知识/方案目录写入。
|
|
13
13
|
|
|
14
14
|
## 流程
|
|
@@ -71,5 +71,5 @@ Trigger: ~loop <目标描述>
|
|
|
71
71
|
|
|
72
72
|
## 完成判定
|
|
73
73
|
|
|
74
|
-
- 只有当长任务链路已经走到 `~qa`,并且质量闭环通过、收尾证据完整、HelloAGENTS
|
|
74
|
+
- 只有当长任务链路已经走到 `~qa`,并且质量闭环通过、收尾证据完整、HelloAGENTS 允许进入收尾与归档时,`~loop` 才算完成
|
|
75
75
|
- 若当前任务来自 Codex active goal,还要满足:当前 goal 的可执行 `AFK` 任务已全部完成,才允许标记 goal complete
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ~office
|
|
3
|
+
description: 价值与范围评估命令 — 先判断事情该不该做、该做多大、先做哪一小块(~office 命令)
|
|
4
|
+
policy:
|
|
5
|
+
allow_implicit_invocation: false
|
|
6
|
+
---
|
|
7
|
+
Trigger: ~office [description]
|
|
8
|
+
|
|
9
|
+
`~office` 是范围收缩命令,用于在不写文件、不进入实现、不激活完整项目流程的前提下,先帮用户判断一件事是否值得做、是否做得过大、最小可验证切口应该落在哪里。
|
|
10
|
+
|
|
11
|
+
## 铁律
|
|
12
|
+
- 只讨论,不编写实现代码,不创建项目文件,不执行实现操作
|
|
13
|
+
- 不创建 `.helloagents/`
|
|
14
|
+
- 不创建或更新当前项目存储中的 `state_path`;同样禁止更新知识库文件、方案包或项目级规则文件
|
|
15
|
+
- 不生成方案包
|
|
16
|
+
- 不执行会改变工作区或外部状态的命令
|
|
17
|
+
- 不默认使用子代理
|
|
18
|
+
- 输出重点不是“还能做什么”,而是“要不要做、该做多大、先做哪块”
|
|
19
|
+
|
|
20
|
+
## 流程
|
|
21
|
+
|
|
22
|
+
### 1. 快速锁定待判断事项
|
|
23
|
+
|
|
24
|
+
- 先用一句话重述当前用户真正想判断的事情
|
|
25
|
+
- 明确判断目标:是评估“值不值得做”、还是评估“要不要现在做”、还是评估“要不要做这么大”
|
|
26
|
+
- 若任务是已有项目中的连续工作,可按需读取少量相关上下文;不要为了做 office 评估而展开完整项目流程
|
|
27
|
+
|
|
28
|
+
### 2. 从关键维度拷问
|
|
29
|
+
|
|
30
|
+
- 只选当前最相关的 3-5 个维度,不机械全问
|
|
31
|
+
- 可用维度包括:
|
|
32
|
+
- 真实需求是否存在
|
|
33
|
+
- 当前替代方案/现状是什么
|
|
34
|
+
- 最痛的人是谁,痛到什么程度
|
|
35
|
+
- 最小可验证切口是什么
|
|
36
|
+
- 当前最大假设是什么
|
|
37
|
+
- 现在做和以后做的时机差异是什么
|
|
38
|
+
- 做大后的主要成本、风险或返工点是什么
|
|
39
|
+
- 问题必须直指判断,不做泛化 brainstorm
|
|
40
|
+
|
|
41
|
+
### 3. 挑战前提
|
|
42
|
+
|
|
43
|
+
- 明确指出 1-3 条最值得怀疑的前提
|
|
44
|
+
- 每条前提都说明:
|
|
45
|
+
- 它为什么可疑
|
|
46
|
+
- 如果这条前提不成立,会导致什么
|
|
47
|
+
- 最省成本的验证方式是什么
|
|
48
|
+
|
|
49
|
+
### 4. 强制给出不同范围方案
|
|
50
|
+
|
|
51
|
+
- 至少给出 3 档范围:
|
|
52
|
+
- 不做 / 暂缓
|
|
53
|
+
- 最小切口
|
|
54
|
+
- 标准推进
|
|
55
|
+
- 如确有必要,可再补一个“做大方案”,但不默认鼓励
|
|
56
|
+
- 每档都给出:
|
|
57
|
+
- 核心动作
|
|
58
|
+
- 主要收益
|
|
59
|
+
- 主要代价或风险
|
|
60
|
+
- 适用前提
|
|
61
|
+
|
|
62
|
+
### 5. 给出明确判断
|
|
63
|
+
|
|
64
|
+
- 必须明确落到以下结论之一:
|
|
65
|
+
- 不建议做
|
|
66
|
+
- 建议先验证,不建议直接做
|
|
67
|
+
- 值得做,但先做最小切口
|
|
68
|
+
- 值得按当前范围推进
|
|
69
|
+
- 解释理由,不使用空泛形容词
|
|
70
|
+
|
|
71
|
+
### 6. 给出升级路径
|
|
72
|
+
|
|
73
|
+
- 如果用户希望继续推进,实现层升级路径为:
|
|
74
|
+
- 想比较几个做法方向 → `~idea`
|
|
75
|
+
- 想形成结构化方案 → `~plan`
|
|
76
|
+
- 想直接进入实现 → `~build`
|
|
77
|
+
- 需要重型产品规格 → `~prd`
|
|
78
|
+
- 想让 AI 自动执行完整流程 → `~auto`
|
|
79
|
+
- 如果用户在 `~office` 过程中转而明确要求写文件、改代码、创建知识库或执行命令,不在 `~office` 内偷偷写文件;改为按最合适的升级路径继续
|
|
80
|
+
|
|
81
|
+
## 输出要求
|
|
82
|
+
|
|
83
|
+
- 必须先给结论,再给判断依据
|
|
84
|
+
- 不做“点子堆砌”
|
|
85
|
+
- 不把尚未验证的假设伪装成事实
|
|
86
|
+
- 不把“可以做很大”默认当成推荐答案
|
|
@@ -127,7 +127,7 @@ c. AI 总结该维度的决策结果,进入下一个维度
|
|
|
127
127
|
|
|
128
128
|
按 tasks.md 逐项完成,每项进入当前已加载的 HelloAGENTS 统一执行流程,完成后同步重写 `state_path`。
|
|
129
129
|
任务状态标记仅写入 tasks.md、验收清单或验证结果;普通说明、方案解释、状态汇报不用 [√] / [-] / [ ]。
|
|
130
|
-
所有任务完成后进入当前已加载的 HelloAGENTS
|
|
130
|
+
所有任务完成后进入当前已加载的 HelloAGENTS 质量闭环 / 收尾与归档阶段。
|
|
131
131
|
可并行的任务标记后用子代理并行执行(不同子代理不改同一文件)。
|
|
132
132
|
执行过程中遇到阻塞(依赖缺失、指令不清、验证反复失败)→ 立即停下询问用户,不猜测。
|
|
133
133
|
执行过程中遇到高风险操作(删除文件/修改配置/数据库变更)→ 暂停确认。
|
|
@@ -41,9 +41,9 @@ Trigger: ~qa [scope]
|
|
|
41
41
|
- ✅ 通过的审查项 / 命令
|
|
42
42
|
- ❌ 失败的审查项 / 命令 + 修复结果
|
|
43
43
|
- 仍未满足的阻断项
|
|
44
|
-
-
|
|
44
|
+
- 是否已满足进入收尾与归档的条件
|
|
45
45
|
|
|
46
46
|
## 失败处理
|
|
47
47
|
|
|
48
48
|
- 有失败 → 逐个修复,修复后重新运行对应审查或验证
|
|
49
|
-
- 全部通过 → 按当前已加载的 HelloAGENTS
|
|
49
|
+
- 全部通过 → 按当前已加载的 HelloAGENTS 规则进入收尾与归档;若 Codex active goal 的目标也已满足,再标记 goal complete,并按交付边界报告完成
|
|
@@ -28,7 +28,7 @@ description: 重构代码、调整模块结构、管理依赖、拆分文件、
|
|
|
28
28
|
## 变更策略
|
|
29
29
|
- 评估变更的影响范围(blast radius)
|
|
30
30
|
- 大重构分步进行,每步可独立验证和回滚
|
|
31
|
-
-
|
|
31
|
+
- 区分真实外部契约与内部实现惯性:公开 API、持久化数据、已文档化集成、用户承诺等真实契约要评估兼容与迁移;内部调用方、旧命名、旧目录结构和历史兼容层不自动保留,必要时先按核心规则判断目标模型,再按分阶段路径落地
|
|
32
32
|
|
|
33
33
|
## 交付检查
|
|
34
34
|
- [ ] 无循环依赖
|
|
@@ -4,7 +4,7 @@ description: 撰写文档、README、技术方案、分析报告、用户指南
|
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
文本产出遵循通用交付规则中的执行纪律与表达与语气要求;本技能补充结构、表达与格式要求。
|
|
7
|
-
|
|
7
|
+
默认交付一个可直接使用的最终文本;这里的“一个”只限制版本数量,不限制完成当前请求所需的必要篇幅、说明深度和结构。只有用户明确要求时,才提供多版本、多语气或多长度变体。
|
|
8
8
|
|
|
9
9
|
文本产出必须遵循以下规范。
|
|
10
10
|
|
|
@@ -25,7 +25,7 @@ description: 撰写文档、README、技术方案、分析报告、用户指南
|
|
|
25
25
|
- 避免模糊词("一些"、"可能"、"大概")→ 用具体数据
|
|
26
26
|
- 不重复同一结论,不堆叠近义句
|
|
27
27
|
- 不为追求简短省略必要条件、边界和风险说明
|
|
28
|
-
- 未明确要求多版本时,只给一个最终版本,不主动追加另一版、另一种语气或更短 /
|
|
28
|
+
- 未明确要求多版本时,只给一个最终版本,不主动追加另一版、另一种语气或更短 / 更口语版本;但必要背景、条件、边界、风险、步骤和示例不得省略
|
|
29
29
|
- 文本已满足请求时直接结束,不加无执行价值的邀约式收尾
|
|
30
30
|
|
|
31
31
|
## 格式
|
|
@@ -3,12 +3,14 @@ name: helloagents
|
|
|
3
3
|
description: 按任务类型适用 — 建立质量驱动工作流,通过技能标准、流程纪律和检查清单保障交付质量
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
+
【子代理短路】
|
|
7
|
+
若当前任务属于上级代理分派的局部任务、由宿主协作/委派机制创建,或当前输出会交回上级代理、控制器或其他代理继续汇总、决策、复述或等待后续动作,则立即跳过本 skill 后续仅面向主代理的规则。只返回结果、证据或阻塞项;不得包装 HelloAGENTS 外层输出格式,不得输出 `【HelloAGENTS】` 外层格式、`🔄 下一步:`、turn-state 或面向最终用户的收尾。安全、质量、验证和失败处理规则仍持续生效。
|
|
8
|
+
|
|
6
9
|
# HelloAGENTS
|
|
7
10
|
|
|
8
|
-
主代理触发或读取任意 skill
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
普通问答、解释、分析、改写、邮件回复和其他一次性交付虽然不进入完整实现、验证或收尾流程,但仍属于交付:默认只交付与当前请求直接对应的一版最终结果;请求已满足时直接结束,不主动追加无执行价值的延伸、派生版本、不同写法、第二版或邀约式收尾,除非用户明确要求。
|
|
11
|
+
主代理触发或读取任意 skill 时,只有直接面向最终用户、且当前对话已经结束的终局交付,才按通用输出格式包装;流式内容、进度或状态汇报、中间文本,以及任何当前对话尚未结束的文本,都保持自然输出。最终回复中的 `🔄 下一步` 写真实动作,不写当前状态;等待用户授权时使用等待输入态收尾,已获授权且可继续执行时不得收尾。同一条最终回复只包装一次;若需要分段,在同一个外层块内展开,不在正文里再次输出 `【HelloAGENTS】` 或第二个 `🔄 下一步`。
|
|
12
|
+
只有运行时必须识别当前对话“完成 / 等待输入 / 阻塞”时,主代理才写 turn-state;普通问候、普通问答、T0 只读分析和一次性解释不调用。必须调用场景:显式 `~auto` / `~loop`、非只读任务完成验证并进入收尾、需要让运行时识别当前对话已完成、等待输入或已阻塞时、已进入项目连续流程或方案包闭环。首选 `helloagents-turn-state write --kind complete --role main`;等待或阻塞时写 `kind=waiting` / `kind=blocked`,并同时写 `reasonCategory` 与 `reason`。显式 `~auto` / `~loop` 下,还必须写入 `blocker.target`、`blocker.evidence`、`blocker.requiredAction`。不要查找、读取或拼接 `turn-state.mjs` 源码路径。
|
|
13
|
+
普通问答、解释、分析、改写、邮件回复和其他一次性交付虽然不进入完整实现、验证或收尾流程,但仍属于交付:默认只交付与当前请求直接对应的一版最终结果;“一版”只限制版本数量,不限制完成当前请求所需的必要内容;请求已满足时直接结束,不主动追加无执行价值的延伸、派生版本、不同写法、第二版或邀约式收尾,除非用户明确要求。
|
|
12
14
|
|
|
13
15
|
`.helloagents/` 在所有 skill 中都统一按项目级存储路径理解:项目本地 `.helloagents/` 负责知识、方案和会话运行态,不作为项目是否已初始化的判定信号;状态文件只使用 `state_path`(实际位于 `sessions/{workspace}/{session}/STATE.md`);会话证据使用当前 `state_path` 所在目录下的 `artifacts/*.json`;`sessions/active.json` 只作为当前活跃会话索引;若 `project_store_mode=repo-shared`,`context.md`、`guidelines.md`、`DESIGN.md`、`verify.yaml`、`modules/`、`plans/`、`archive/` 按当前上下文中已注入的“当前项目存储”/“项目知识/方案目录”解析,不要假定这些文件一定实际位于当前工作树中。
|
|
14
16
|
|
|
@@ -22,7 +24,7 @@ description: 按任务类型适用 — 建立质量驱动工作流,通过技
|
|
|
22
24
|
|
|
23
25
|
### 流程纪律(执行时)
|
|
24
26
|
- 执行 command skill 时,公共阶段边界以当前已加载的 HelloAGENTS 规则为准;command skill 只补充该命令的专属动作和边界
|
|
25
|
-
-
|
|
27
|
+
- 统一执行流程的六个阶段(选路与分层→目标澄清→规划→实现→质量闭环→收尾与归档)按当前任务分层和实际任务推进;未进入的阶段不强行补齐,已进入的阶段不可跳过
|
|
26
28
|
- 所有 UI 任务先受当前已加载的 HelloAGENTS UI 质量基线约束;已初始化项目、宿主全局模式或显式 UI 工作流中的设计约束优先级固定为:当前 `plan.md` / PRD UI 决策 → `.helloagents/DESIGN.md`(按当前项目存储模式解析) → 已读取的 `hello-ui` 具体规则
|
|
27
29
|
- 方案包存在 `contract.json` 时,`qaMode`、`qaFocus`、可选 style advisor / visual validation 与交付检查优先按它执行,不再从自然语言总结里回推
|
|
28
30
|
- 因阻塞判定而必须等待用户输入时,按当前已加载的 HelloAGENTS 规则处理,不得把等待输入包装成完成态
|
|
@@ -48,7 +50,7 @@ description: 按任务类型适用 — 建立质量驱动工作流,通过技
|
|
|
48
50
|
- 技能引用的 `templates/`、`modules/*.md` 等文件,只在技能明确要求时再读
|
|
49
51
|
|
|
50
52
|
禁止行为:
|
|
51
|
-
-
|
|
53
|
+
- 禁止在选路分层、目标澄清阶段读取实现类技能(hello-ui/hello-test/qa-review 等)
|
|
52
54
|
- 禁止因为"可能用到"就提前读取技能文件——等到真正需要时再读
|
|
53
55
|
- 同一会话内,同一路径的配置文件、模块、SKILL、模板只读一次并跨轮复用;缺少所需内容、读取失败、用户要求刷新或本次修改后才重新读取
|
|
54
56
|
- ~command 命令只读取对应的 command SKILL.md,不连带读取其他技能
|
|
@@ -77,7 +79,7 @@ description: 按任务类型适用 — 建立质量驱动工作流,通过技
|
|
|
77
79
|
|
|
78
80
|
## 技能索引(仅元数据)
|
|
79
81
|
|
|
80
|
-
###
|
|
82
|
+
### 编码时(实现阶段按需读取)
|
|
81
83
|
- hello-ui — 深层 UI 规划/实现/验收时
|
|
82
84
|
- hello-api — 构建/修改 API 时
|
|
83
85
|
- hello-data — 数据库/迁移/事务时
|
|
@@ -85,7 +87,7 @@ description: 按任务类型适用 — 建立质量驱动工作流,通过技
|
|
|
85
87
|
- hello-errors — 错误处理/日志/重试时
|
|
86
88
|
- hello-perf — 性能优化/查询/缓存时
|
|
87
89
|
- hello-arch — 重构/架构决策时
|
|
88
|
-
- hello-test — 编写测试时(TDD
|
|
90
|
+
- hello-test — 编写测试时(TDD:实现阶段开始时读取)
|
|
89
91
|
|
|
90
92
|
### 特定场景(触发时读取)
|
|
91
93
|
- hello-debug — 调试错误/修复 bug/排查失败时
|
|
@@ -93,7 +95,7 @@ description: 按任务类型适用 — 建立质量驱动工作流,通过技
|
|
|
93
95
|
- hello-write — 撰写文档/报告/方案等非编码文本时
|
|
94
96
|
- qa-review — 统一质量审查、验证、修复与收尾时
|
|
95
97
|
|
|
96
|
-
###
|
|
98
|
+
### 完成时(质量闭环 / 收尾与归档阶段读取)
|
|
97
99
|
- hello-reflect — 符合触发条件时(详见 hello-reflect SKILL.md)
|
|
98
100
|
|
|
99
101
|
## 命令路由
|
|
@@ -101,6 +103,7 @@ description: 按任务类型适用 — 建立质量驱动工作流,通过技
|
|
|
101
103
|
用户使用 `~command` 时,只读取对应的 command skill,路径按上方“~command 命令技能”规则查找:
|
|
102
104
|
- `~auto`
|
|
103
105
|
- `~idea`
|
|
106
|
+
- `~office`
|
|
104
107
|
- `~plan`
|
|
105
108
|
- `~build`
|
|
106
109
|
- `~prd`
|