helloagents 3.1.2 → 3.1.4

package/scripts/workflow-recommendation.mjs

@@ -81,7 +81,7 @@ function buildQaAction(plan, qaMode) {
   if (visualRequirement.required) {
     extraChecks.push('完成视觉验收并写入当前会话 `artifacts/visual.json`')
   }
-  const gateSuffix = extraChecks.length > 0 ? ` ${extraChecks.join('，')}，再进入 CONSOLIDATE。` : ''
+  const gateSuffix = extraChecks.length > 0 ? ` ${extraChecks.join('，')}，再进入收尾与归档。` : ''
 
   if (qaMode.mode === 'metadata-first') {
     return {
@@ -89,8 +89,8 @@ function buildQaAction(plan, qaMode) {
       mode: qaMode.mode,
       routeHint: qaMode.guidance,
       gateHint: plan.contractIssues.length > 0
-        ? '交付把关：当前还不能进入 CONSOLIDATE；先补齐 `contract.json` 中的 `qaMode` 与 `qaFocus`，再进入 ~qa。'
-        : '交付把关：当前还不能进入 CONSOLIDATE；先补齐 tasks.md 中每个任务的“涉及文件”“完成标准”和“验证方式”，再进入 ~qa。',
+        ? '交付把关：当前还不能进入收尾与归档；先补齐 `contract.json` 中的 `qaMode` 与 `qaFocus`，再进入 ~qa。'
+        : '交付把关：当前还不能进入收尾与归档；先补齐 tasks.md 中每个任务的“涉及文件”“完成标准”和“验证方式”，再进入 ~qa。',
     }
   }
 
@@ -98,7 +98,7 @@ function buildQaAction(plan, qaMode) {
     phase: 'qa',
     mode: qaMode.mode,
     routeHint: qaMode.guidance,
-    gateHint: `交付把关：进入 CONSOLIDATE 前，必须完成 qa-review 全量质量闭环，并留下最新 qa-review 证据。${gateSuffix}`.trim(),
+    gateHint: `交付把关：进入收尾与归档前，必须完成 qa-review 全量质量闭环，并留下最新 qa-review 证据。${gateSuffix}`.trim(),
   }
 }
 
@@ -188,9 +188,9 @@ function buildClosedRecommendation(scopeLabel, plan, cwd, options = {}) {
       plan,
       status: 'closed',
       nextCommand: 'qa',
-      nextPath: '~qa -> CONSOLIDATE',
+      nextPath: '~qa -> 收尾与归档',
       summary: `${scopeLabel} "${plan.planName}" 的任务已闭合，但当前 UI 契约仍要求独立 advisor 复查与视觉验收。`,
-      guidance: '先在 ~qa 阶段完成独立 advisor / style advisor 复查，并写入当前会话 `artifacts/advisor.json`；再完成视觉验收并写入当前会话 `artifacts/visual.json`，记录 reason、tooling、screensChecked、statesChecked、status 与 summary；两项都通过后再进入 CONSOLIDATE。',
+      guidance: '先在 ~qa 阶段完成独立 advisor / style advisor 复查，并写入当前会话 `artifacts/advisor.json`；再完成视觉验收并写入当前会话 `artifacts/visual.json`，记录 reason、tooling、screensChecked、statesChecked、status 与 summary；两项都通过后再进入收尾与归档。',
     }
   }
 
@@ -200,9 +200,9 @@ function buildClosedRecommendation(scopeLabel, plan, cwd, options = {}) {
       plan,
       status: 'closed',
       nextCommand: 'qa',
-      nextPath: '~qa -> CONSOLIDATE',
+      nextPath: '~qa -> 收尾与归档',
       summary: `${scopeLabel} "${plan.planName}" 的任务已闭合，但当前契约仍要求独立 advisor 复查。`,
-      guidance: '先在 ~qa 阶段完成独立 advisor / style advisor 复查，并写入当前会话 `artifacts/advisor.json` 记录复查原因、focus、来源与结论；advisor 通过后再进入 CONSOLIDATE。',
+      guidance: '先在 ~qa 阶段完成独立 advisor / style advisor 复查，并写入当前会话 `artifacts/advisor.json` 记录复查原因、focus、来源与结论；advisor 通过后再进入收尾与归档。',
     }
   }
 
@@ -212,9 +212,9 @@ function buildClosedRecommendation(scopeLabel, plan, cwd, options = {}) {
       plan,
       status: 'closed',
       nextCommand: 'qa',
-      nextPath: '~qa -> CONSOLIDATE',
+      nextPath: '~qa -> 收尾与归档',
       summary: `${scopeLabel} "${plan.planName}" 的任务已闭合，但当前 UI 契约仍要求视觉验收。`,
-      guidance: '先在 ~qa 阶段完成视觉验收，并写入当前会话 `artifacts/visual.json` 记录 reason、tooling、screensChecked、statesChecked、status 与 summary；视觉验收通过后再进入 CONSOLIDATE。',
+      guidance: '先在 ~qa 阶段完成视觉验收，并写入当前会话 `artifacts/visual.json` 记录 reason、tooling、screensChecked、statesChecked、status 与 summary；视觉验收通过后再进入收尾与归档。',
     }
   }
 
@@ -226,13 +226,13 @@ function buildClosedRecommendation(scopeLabel, plan, cwd, options = {}) {
       stage: 'consolidate',
       mode: closedPlanEvidence.closeoutReady ? 'ready' : 'closeout-pending',
       nextCommand: 'qa',
-      nextPath: 'CONSOLIDATE',
+      nextPath: '收尾与归档',
       summary: closedPlanEvidence.closeoutReady
         ? `${scopeLabel} "${plan.planName}" 的任务与交付证据已闭合。`
         : `${scopeLabel} "${plan.planName}" 的任务与 qa-review 已闭合。`,
       guidance: closedPlanEvidence.closeoutReady
-        ? '当前进入 CONSOLIDATE：更新 `state_path`、知识文件并归档方案后即可交付；不要无故重开新的方案包或重新跑一遍无关验证。'
-        : '当前进入 CONSOLIDATE：先写当前会话 `artifacts/closeout.json` 记录需求覆盖与交付清单，再更新 `state_path` 并归档后交付。',
+        ? '当前进入收尾与归档：更新 `state_path`、知识文件并归档方案后即可交付；不要无故重开新的方案包或重新跑一遍无关验证。'
+        : '当前进入收尾与归档：先写当前会话 `artifacts/closeout.json` 记录需求覆盖与交付清单，再更新 `state_path` 并归档后交付。',
     }
   }
 
@@ -241,9 +241,9 @@ function buildClosedRecommendation(scopeLabel, plan, cwd, options = {}) {
     plan,
     status: 'closed',
     nextCommand: 'qa',
-    nextPath: '~qa -> CONSOLIDATE',
+    nextPath: '~qa -> 收尾与归档',
     summary: `${scopeLabel} "${plan.planName}" 的任务已全部闭合。`,
-    guidance: '若用户是在做收尾、验真、复查或准备交付，优先走 ~qa 或 CONSOLIDATE；不要无故重开新的方案包。',
+    guidance: '若用户是在做收尾、验真、复查或准备交付，优先走 ~qa 或收尾与归档；不要无故重开新的方案包。',
   }
 }
 
@@ -320,7 +320,7 @@ export function buildOrchestrationHintFromSnapshot(snapshot, cwd, recommendation
   if (recommendation.stage === 'consolidate') {
     const action = buildDeliveryActionFromSnapshot(snapshot, cwd, recommendation)
     if (action?.phase === 'consolidate') {
-      return `编排提示：当前已进入 CONSOLIDATE；${[action.routeHint, action.gateHint].filter(Boolean).join(' ')}`
+      return `编排提示：当前已进入收尾与归档；${[action.routeHint, action.gateHint].filter(Boolean).join(' ')}`
     }
   }
   return ''

package/scripts/workflow-state.mjs

@@ -49,7 +49,7 @@ export function buildWorkflowRouteHint(cwd, options = {}) {
 
   const suffix = [stateRoleHint, stateSyncHint, orchestrationHint, uiContractHint].filter(Boolean).join(' ')
   if (recommendation.stage === 'consolidate') {
-    return `${recommendation.summary} 当前应直接进入 CONSOLIDATE。执行路径：${recommendation.nextPath}。${recommendation.guidance}${suffix ? ` ${suffix}` : ''}`
+    return `${recommendation.summary} 当前应直接进入收尾与归档。执行路径：${recommendation.nextPath}。${recommendation.guidance}${suffix ? ` ${suffix}` : ''}`
   }
   return `${recommendation.summary} 当前应执行 ~${recommendation.nextCommand}。执行路径：${recommendation.nextPath}。${recommendation.guidance}${suffix ? ` ${suffix}` : ''}`
 }
@@ -65,7 +65,7 @@ function buildCommandRouteMessage(skillName, recommendation, qaFocusHint) {
   }
   if (skillName === 'plan') {
     if (recommendation.stage === 'consolidate') {
-      return `当前工作流约束：${recommendation.summary} 当前不该重开 ~plan；除非用户明确要求重规划、改方向或新增范围，否则直接进入 CONSOLIDATE。`
+      return `当前工作流约束：${recommendation.summary} 当前不该重开 ~plan；除非用户明确要求重规划、改方向或新增范围，否则直接进入收尾与归档。`
     }
     return recommendation.nextCommand === 'plan'
       ? `当前工作流约束：${recommendation.summary} 当前应执行 ~plan。${recommendation.guidance}`
@@ -73,7 +73,7 @@ function buildCommandRouteMessage(skillName, recommendation, qaFocusHint) {
   }
   if (skillName === 'build') {
     if (recommendation.stage === 'consolidate') {
-      return `当前工作流约束：${recommendation.summary} 当前不该继续 ~build；除非用户明确提出新增实现范围，否则直接进入 CONSOLIDATE。`
+      return `当前工作流约束：${recommendation.summary} 当前不该继续 ~build；除非用户明确提出新增实现范围，否则直接进入收尾与归档。`
     }
     return recommendation.nextCommand === 'build'
       ? `当前工作流约束：${recommendation.summary} 当前应执行 ~build。${recommendation.guidance}`
@@ -81,7 +81,7 @@ function buildCommandRouteMessage(skillName, recommendation, qaFocusHint) {
   }
   if (skillName === 'qa') {
     if (recommendation.stage === 'consolidate') {
-      return `当前工作流约束：${recommendation.summary} 当前应直接进入 CONSOLIDATE。${recommendation.guidance}`
+      return `当前工作流约束：${recommendation.summary} 当前应直接进入收尾与归档。${recommendation.guidance}`
     }
     return recommendation.nextCommand === 'qa'
       ? `当前工作流约束：${recommendation.summary} 当前应执行 ~qa。${recommendation.guidance}`

package/skills/commands/auto/SKILL.md

@@ -16,7 +16,7 @@ Trigger: ~auto <任务描述>
 - 主路径一旦确定，立即读取对应 command skill，并在阶段完成后继续执行后续阶段，避免同一任务重复探索或重复等待
 - 选路不替代授权；涉及外部副作用或高风险不可逆操作时，仍遵守 HelloAGENTS 阻塞判定与确认规则
 - 用户显式使用 `~auto`，表示已授权在当前任务边界内沿选定主路径持续执行；若当前运行在 Codex `/goal` 下，`/goal` 只提供长程续跑与预算，`~auto` 仍按方案包、`state_path` 与验证契约推进；`~plan` / `~prd` 作为中间阶段时，不再额外询问“是否开始执行”，除非仍有真实阻塞；不得把 `🔄 下一步` 当作阶段交接或继续执行占位
-- 优先消费当前上下文中已注入的 ROUTE / TIER、当前工作流约束与项目状态；不要在 `~auto` 内另建一套关键词路由表
+- 优先消费当前上下文中已注入的“选路与分层”结果、当前工作流约束与项目状态；不要在 `~auto` 内另建一套关键词路由表
 
 ## 流程
 
@@ -32,7 +32,7 @@ Trigger: ~auto <任务描述>
 
 ### 1. 选路
 
-- 先按当前上下文里已注入的 ROUTE / TIER 语义约束判断，不依赖关键词命中做机械分流
+- 先按当前上下文里已注入的“选路与分层”语义约束判断，不依赖关键词命中做机械分流
 - 若当前上下文没有足够的注入约束，再结合以下信号补足判断：影响范围、风险等级、是否需要结构化产物、是否已有活跃方案包、用户是否只想先比较方向
 - 选路优先级：
   - 纯探索 / 点子 / 方向比较 → `~idea`

package/skills/commands/build/SKILL.md

@@ -64,5 +64,5 @@ Trigger: ~build [description]
 - 有方案包时，只同步本次实现直接影响的任务状态；未完成项保持打开
 - 当前实现已闭合、且需要进入交付或收尾时，转入 `~qa`
 - 若 Codex active goal 仍有未完成 AFK 任务，继续下一项可执行任务；若目标已满足，先转入 `~qa` 与 HelloAGENTS 收尾，再标记 goal complete
-- 状态文件、知识库、`CHANGELOG.md`、modules 文档与归档边界，按当前已加载的 HelloAGENTS 规则进入 QA / CONSOLIDATE
+- 状态文件、知识库、`CHANGELOG.md`、modules 文档与归档边界，按当前已加载的 HelloAGENTS 规则进入质量闭环 / 收尾与归档
 - 不在 `~build` 内把仍未闭合的方案包整体报告为已完成

package/skills/commands/commit/SKILL.md

@@ -6,7 +6,7 @@ policy:
 ---
 Trigger: ~commit [message]
 
-执行 `~commit` 时，知识库同步与状态文件更新范围按当前已加载的 HelloAGENTS CONSOLIDATE / 流程状态要求执行；本命令只负责生成提交信息、读取提交归属配置并完成提交动作。
+执行 `~commit` 时，知识库同步与状态文件更新范围按当前已加载的 HelloAGENTS“收尾与归档”/ 流程状态要求执行；本命令只负责生成提交信息、读取提交归属配置并完成提交动作。
 `auto_commit_enabled=false` 只关闭收尾阶段的自动提交，不影响显式 `~commit`。
 
 ## 流程
@@ -28,4 +28,4 @@ Trigger: ~commit [message]
 - 0 = 跳过
 - 1 = 知识库已存在时自动同步（默认）
 - 2 = 编码任务在知识库已存在或当前项目已初始化时自动创建或同步
-同步范围与更新格式按当前已加载的 HelloAGENTS CONSOLIDATE 阶段执行。
+同步范围与更新格式按当前已加载的 HelloAGENTS“收尾与归档”阶段执行。

package/skills/commands/help/SKILL.md

@@ -30,6 +30,8 @@ Trigger: ~help
 - `~design` → 等同 `~plan`
 - `~review` → 等同 `~qa`
 
+核心规则默认生效：HelloAGENTS 会通过 `bootstrap.md` / `bootstrap-lite.md` 在运行时持续执行方案纠偏与语言纪律；这不是新增命令，也不是新增技能计数。
+
 ### 自动激活技能
 以下技能仅在宿主全局模式或已初始化项目时自动激活（例如当前项目级规则文件已包含 `<!-- HELLOAGENTS_PROFILE: full -->`，通常由 `~init` 建立）。
 纯标准模式、且项目未初始化时不会自动触发这些技能；但涉及 UI 的任务仍受 UI 质量基线约束。
@@ -46,7 +48,7 @@ Trigger: ~help
 | output_language | "" | 空=跟随用户语言/填写则指定（如 zh-CN、en） | Claude Code + Gemini CLI + Codex CLI |
 | output_format | true | true=主代理最终回复必须使用 HelloAGENTS 格式，流式/中间输出及子代理输出保持自然；false=自然输出 | Claude Code + Gemini CLI + Codex CLI |
 | notify_level | 0 | 0=关闭/1=桌面通知/2=声音/3=两者 | Claude Code + Gemini CLI + Codex CLI |
-| ralph_loop_enabled | true | 收尾 QA gate（显式 ~qa / ~loop 或收尾要求时触发审查、lint/test/build） | Claude Code + Gemini CLI + Codex CLI |
+| ralph_loop_enabled | true | 收尾 QA 门禁（显式 ~qa / ~loop 或收尾要求时触发审查、lint/test/build） | Claude Code + Gemini CLI + Codex CLI |
 | guard_enabled | true | 阻断危险命令与写入后的安全扫描 | Claude Code + Gemini CLI + Codex CLI |
 | kb_create_mode | 1 | 0=关闭/1=知识库已存在时自动同步/2=编码任务在知识库已存在或当前项目已初始化时自动创建或同步 | Claude Code + Gemini CLI + Codex CLI |
 | project_store_mode | "local" | "local"=知识库/方案包保留在项目本地 `.helloagents/`；"repo-shared"=本地 `.helloagents/` 仅保留项目本地状态/运行态，知识库与方案包改写到 `~/.helloagents/projects/<repo-key>/` | Claude Code + Gemini CLI + Codex CLI |

package/skills/commands/init/SKILL.md

@@ -8,7 +8,7 @@ Trigger: ~init
 
 `~init` 是用户显式命令，用来初始化或刷新当前项目的完整工作流。
 它不受 `kb_create_mode` 限制。
-执行 `~init` 时，按当前规则模板创建或更新项目本地 `.helloagents/`，同步知识库，并为支持的宿主写入项目级 full carrier 标记：`<!-- HELLOAGENTS_PROFILE: full -->`。
+执行 `~init` 时，按当前规则模板创建或更新项目本地 `.helloagents/`，同步知识库，并为支持的宿主写入项目级完整规则标记：`<!-- HELLOAGENTS_PROFILE: full -->`。
 `.helloagents/` 在本 skill 中统一按项目级存储路径理解：项目本地 `.helloagents/` 继续承担项目本地存储目录；状态文件只使用 `state_path`；若 `project_store_mode=repo-shared`，知识库、`DESIGN.md` 与方案包按当前上下文中已注入的项目知识/方案目录写入。
 
 ## 流程

package/skills/commands/loop/SKILL.md

@@ -71,5 +71,5 @@ Trigger: ~loop <目标描述>
 
 ## 完成判定
 
-- 只有当长任务链路已经走到 `~qa`，并且质量闭环通过、收尾证据完整、HelloAGENTS 允许进入 CONSOLIDATE 时，`~loop` 才算完成
+- 只有当长任务链路已经走到 `~qa`，并且质量闭环通过、收尾证据完整、HelloAGENTS 允许进入收尾与归档时，`~loop` 才算完成
 - 若当前任务来自 Codex active goal，还要满足：当前 goal 的可执行 `AFK` 任务已全部完成，才允许标记 goal complete

package/skills/commands/prd/SKILL.md

@@ -127,7 +127,7 @@ c. AI 总结该维度的决策结果，进入下一个维度
 
 按 tasks.md 逐项完成，每项进入当前已加载的 HelloAGENTS 统一执行流程，完成后同步重写 `state_path`。
 任务状态标记仅写入 tasks.md、验收清单或验证结果；普通说明、方案解释、状态汇报不用 [√] / [-] / [ ]。
-所有任务完成后进入当前已加载的 HelloAGENTS QA / CONSOLIDATE 收尾阶段。
+所有任务完成后进入当前已加载的 HelloAGENTS 质量闭环 / 收尾与归档阶段。
 可并行的任务标记后用子代理并行执行（不同子代理不改同一文件）。
 执行过程中遇到阻塞（依赖缺失、指令不清、验证反复失败）→ 立即停下询问用户，不猜测。
 执行过程中遇到高风险操作（删除文件/修改配置/数据库变更）→ 暂停确认。

package/skills/commands/qa/SKILL.md

@@ -41,9 +41,9 @@ Trigger: ~qa [scope]
    - ✅ 通过的审查项 / 命令
    - ❌ 失败的审查项 / 命令 + 修复结果
    - 仍未满足的阻断项
-   - 是否已满足进入 CONSOLIDATE 的条件
+   - 是否已满足进入收尾与归档的条件
 
 ## 失败处理
 
 - 有失败 → 逐个修复，修复后重新运行对应审查或验证
-- 全部通过 → 按当前已加载的 HelloAGENTS 规则进入 CONSOLIDATE 收尾；若 Codex active goal 的目标也已满足，再标记 goal complete，并按交付边界报告完成
+- 全部通过 → 按当前已加载的 HelloAGENTS 规则进入收尾与归档；若 Codex active goal 的目标也已满足，再标记 goal complete，并按交付边界报告完成

package/skills/hello-arch/SKILL.md

@@ -28,7 +28,7 @@ description: 重构代码、调整模块结构、管理依赖、拆分文件、
 ## 变更策略
 - 评估变更的影响范围（blast radius）
 - 大重构分步进行，每步可独立验证和回滚
-- 保持向后兼容，除非明确要求破坏性变更
+- 区分真实外部契约与内部实现惯性：公开 API、持久化数据、已文档化集成、用户承诺等真实契约要评估兼容与迁移；内部调用方、旧命名、旧目录结构和历史兼容层不自动保留，必要时先按核心规则判断目标模型，再按分阶段路径落地
 
 ## 交付检查
 - [ ] 无循环依赖

package/skills/hello-write/SKILL.md

@@ -4,7 +4,7 @@ description: 撰写文档、README、技术方案、分析报告、用户指南
 ---
 
 文本产出遵循通用交付规则中的执行纪律与表达与语气要求；本技能补充结构、表达与格式要求。
-默认交付一个可直接使用的最终文本；只有用户明确要求时，才提供多版本、多语气或多长度变体。
+默认交付一个可直接使用的最终文本；这里的“一个”只限制版本数量，不限制完成当前请求所需的必要篇幅、说明深度和结构。只有用户明确要求时，才提供多版本、多语气或多长度变体。
 
 文本产出必须遵循以下规范。
 
@@ -25,7 +25,7 @@ description: 撰写文档、README、技术方案、分析报告、用户指南
 - 避免模糊词（"一些"、"可能"、"大概"）→ 用具体数据
 - 不重复同一结论，不堆叠近义句
 - 不为追求简短省略必要条件、边界和风险说明
-- 未明确要求多版本时，只给一个最终版本，不主动追加另一版、另一种语气或更短 / 更口语版本
+- 未明确要求多版本时，只给一个最终版本，不主动追加另一版、另一种语气或更短 / 更口语版本；但必要背景、条件、边界、风险、步骤和示例不得省略
 - 文本已满足请求时直接结束，不加无执行价值的邀约式收尾
 
 ## 格式

package/skills/helloagents/SKILL.md

@@ -3,12 +3,14 @@ name: helloagents
 description: 按任务类型适用 — 建立质量驱动工作流，通过技能标准、流程纪律和检查清单保障交付质量
 ---
 
+【子代理短路】
+若当前任务属于上级代理分派的局部任务、由宿主协作/委派机制创建，或当前输出会交回上级代理、控制器或其他代理继续汇总、决策、复述或等待后续动作，则立即跳过本 skill 后续仅面向主代理的规则。只返回结果、证据或阻塞项；不得包装 HelloAGENTS 外层输出格式，不得输出 `【HelloAGENTS】` 外层格式、`🔄 下一步:`、turn-state 或面向最终用户的收尾。安全、质量、验证和失败处理规则仍持续生效。
+
 # HelloAGENTS
 
-主代理触发或读取任意 skill 时，只有直接面向最终用户、且当前对话已经结束的终局交付，才按通用输出格式包装；流式内容、进度或状态汇报、中间文本，以及任何仍将继续执行或会交回上级代理继续消费的文本，都保持自然输出。最终回复中的 `🔄 下一步` 写真实动作，不写当前状态；等待用户授权时使用等待输入态收尾，已获授权且可继续执行时不得收尾。同一条最终回复只包装一次；若需要分段，在同一个外层块内展开，不在正文里再次输出 `【HelloAGENTS】` 或第二个 `🔄 下一步`。
-若当前输出会交回上级代理、控制器或其他代理继续汇总、决策、复述或等待后续动作，或当前任务由宿主协作/委派机制创建（包括 spawn_agent、worker / explorer、并行代理、Codex agent/delegate/wait 等），则一律按子代理处理：只豁免输出格式、交互确认与停顿、统一执行流程、任务分层、完成判定、命令路由和流程状态，直接执行任务；安全、质量、验证和失败处理规则仍持续生效。子代理只返回结果、证据或阻塞项；不得包装 HelloAGENTS 外层输出格式，不写 `🔄 下一步:`，不做面向最终用户的收尾。
-只有运行时必须识别当前对话“完成 / 等待输入 / 阻塞”时，主代理才写 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` 源码路径。子代理不得写 turn-state。
-普通问答、解释、分析、改写、邮件回复和其他一次性交付虽然不进入完整实现、验证或收尾流程，但仍属于交付：默认只交付与当前请求直接对应的一版最终结果；请求已满足时直接结束，不主动追加无执行价值的延伸、派生版本、不同写法、第二版或邀约式收尾，除非用户明确要求。
+主代理触发或读取任意 skill 时，只有直接面向最终用户、且当前对话已经结束的终局交付，才按通用输出格式包装；流式内容、进度或状态汇报、中间文本，以及任何当前对话尚未结束的文本，都保持自然输出。最终回复中的 `🔄 下一步` 写真实动作，不写当前状态；等待用户授权时使用等待输入态收尾，已获授权且可继续执行时不得收尾。同一条最终回复只包装一次；若需要分段，在同一个外层块内展开，不在正文里再次输出 `【HelloAGENTS】` 或第二个 `🔄 下一步`。
+只有运行时必须识别当前对话“完成 / 等待输入 / 阻塞”时，主代理才写 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` 源码路径。
+普通问答、解释、分析、改写、邮件回复和其他一次性交付虽然不进入完整实现、验证或收尾流程，但仍属于交付：默认只交付与当前请求直接对应的一版最终结果；“一版”只限制版本数量，不限制完成当前请求所需的必要内容；请求已满足时直接结束，不主动追加无执行价值的延伸、派生版本、不同写法、第二版或邀约式收尾，除非用户明确要求。
 
 `.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/` 按当前上下文中已注入的“当前项目存储”/“项目知识/方案目录”解析，不要假定这些文件一定实际位于当前工作树中。
 
@@ -22,7 +24,7 @@ description: 按任务类型适用 — 建立质量驱动工作流，通过技
 
 ### 流程纪律（执行时）
 - 执行 command skill 时，公共阶段边界以当前已加载的 HelloAGENTS 规则为准；command skill 只补充该命令的专属动作和边界
-- 统一执行流程的六个阶段（ROUTE/TIER→SPEC→PLAN→BUILD→QA→CONSOLIDATE）按当前 Delivery Tier 和实际任务推进；未进入的阶段不强行补齐，已进入的阶段不可跳过
+- 统一执行流程的六个阶段（选路与分层→目标澄清→规划→实现→质量闭环→收尾与归档）按当前任务分层和实际任务推进；未进入的阶段不强行补齐，已进入的阶段不可跳过
 - 所有 UI 任务先受当前已加载的 HelloAGENTS UI 质量基线约束；已初始化项目、宿主全局模式或显式 UI 工作流中的设计约束优先级固定为：当前 `plan.md` / PRD UI 决策 → `.helloagents/DESIGN.md`（按当前项目存储模式解析） → 已读取的 `hello-ui` 具体规则
 - 方案包存在 `contract.json` 时，`qaMode`、`qaFocus`、可选 style advisor / visual validation 与交付检查优先按它执行，不再从自然语言总结里回推
 - 因阻塞判定而必须等待用户输入时，按当前已加载的 HelloAGENTS 规则处理，不得把等待输入包装成完成态
@@ -48,7 +50,7 @@ description: 按任务类型适用 — 建立质量驱动工作流，通过技
 - 技能引用的 `templates/`、`modules/*.md` 等文件，只在技能明确要求时再读
 
 禁止行为：
-- 禁止在 ROUTE / TIER / SPEC 阶段读取实现类技能（hello-ui/hello-test/qa-review 等）
+- 禁止在选路分层、目标澄清阶段读取实现类技能（hello-ui/hello-test/qa-review 等）
 - 禁止因为"可能用到"就提前读取技能文件——等到真正需要时再读
 - 同一会话内，同一路径的配置文件、模块、SKILL、模板只读一次并跨轮复用；缺少所需内容、读取失败、用户要求刷新或本次修改后才重新读取
 - ~command 命令只读取对应的 command SKILL.md，不连带读取其他技能
@@ -77,7 +79,7 @@ description: 按任务类型适用 — 建立质量驱动工作流，通过技
 
 ## 技能索引（仅元数据）
 
-### 编码时（BUILD 阶段按需读取）
+### 编码时（实现阶段按需读取）
 - hello-ui — 深层 UI 规划/实现/验收时
 - hello-api — 构建/修改 API 时
 - hello-data — 数据库/迁移/事务时
@@ -85,7 +87,7 @@ description: 按任务类型适用 — 建立质量驱动工作流，通过技
 - hello-errors — 错误处理/日志/重试时
 - hello-perf — 性能优化/查询/缓存时
 - hello-arch — 重构/架构决策时
-- hello-test — 编写测试时（TDD：BUILD 开始时读取）
+- hello-test — 编写测试时（TDD：实现阶段开始时读取）
 
 ### 特定场景（触发时读取）
 - hello-debug — 调试错误/修复 bug/排查失败时
@@ -93,7 +95,7 @@ description: 按任务类型适用 — 建立质量驱动工作流，通过技
 - hello-write — 撰写文档/报告/方案等非编码文本时
 - qa-review — 统一质量审查、验证、修复与收尾时
 
-### 完成时（QA / CONSOLIDATE 阶段读取）
+### 完成时（质量闭环 / 收尾与归档阶段读取）
 - hello-reflect — 符合触发条件时（详见 hello-reflect SKILL.md）
 
 ## 命令路由