helloagents 3.0.10 → 3.0.11

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "helloagents",
       "description": "Quality-driven orchestration kernel for AI CLIs: intelligent routing, quality verification, safety guards, and notifications",
-      "version": "3.0.10",
+      "version": "3.0.11",
       "source": "./",
       "author": {
         "name": "HelloWind",

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.10",
+  "version": "3.0.11",
   "description": "HelloAGENTS — The orchestration kernel that makes any AI CLI smarter. Adds intelligent routing, quality verification (Ralph Loop), safety guards, and notifications.",
   "author": {
     "name": "HelloWind",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.10",
+  "version": "3.0.11",
   "description": "HelloAGENTS — Quality-driven orchestration kernel for AI CLIs with intelligent routing, quality verification (Ralph Loop), safety guards, and notifications.",
   "author": {
     "name": "HelloWind",

package/README.md

@@ -8,7 +8,7 @@
 
 **A workflow layer for AI coding CLIs: skills, project knowledge, delivery checks, safer config writes, and resumable execution.**
 
-[![Version](https://img.shields.io/badge/version-3.0.10-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.0.11-orange.svg)](./package.json)
 [![npm](https://img.shields.io/npm/v/helloagents.svg)](https://www.npmjs.com/package/helloagents)
 [![Node](https://img.shields.io/badge/node-%3E%3D18-339933.svg)](./package.json)
 [![Skills](https://img.shields.io/badge/skills-14-6366f1.svg)](./skills)
@@ -79,8 +79,12 @@ HelloAGENTS adds a workflow layer on top of Claude Code, Gemini CLI, and Codex C
 
 ## What Changed Since v3.0.7
 
-These are the main user-visible runtime and install changes in `v3.0.10`, compared with `v3.0.7`:
+These are the main user-visible runtime and install changes in `v3.0.11`, compared with `v3.0.7`:
 
+- Workflow runtime hints now use execution wording instead of staged “next command / next stage” suggestions, so active work is less likely to stop at phase boundaries.
+- Explicit `~auto` now treats the chosen path as a direct execution path and tells the agent to keep going until delivery or a real blocker, instead of turning phase results into “next-step” hand-offs.
+- Explicit `~loop` now follows its own loop rules directly; existing plan or verify recommendations stay as context only and no longer try to reroute the loop itself.
+- The final closeout fallback wording no longer sounds like it is waiting for another manual approval after the task is already complete.
 - Main-agent delivery now uses structured `turn-state` values such as `complete`, `waiting`, and `blocked`; stop, notify, and closeout no longer infer completion from natural-language text.
 - Workflow recovery now uses the current `state_path`, with session-scoped state files under `.helloagents/sessions/<branch>/<session-or-default>/STATE.md`.
 - The old project-root state fallback has been removed, so recovery follows one current state path.

package/README_CN.md

@@ -8,7 +8,7 @@
 
 **面向 AI 编码 CLI 的工作流层：技能、知识库、交付检查、更安全的配置写入，以及可恢复的执行流程。**
 
-[![Version](https://img.shields.io/badge/version-3.0.10-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.0.11-orange.svg)](./package.json)
 [![npm](https://img.shields.io/npm/v/helloagents.svg)](https://www.npmjs.com/package/helloagents)
 [![Node](https://img.shields.io/badge/node-%3E%3D18-339933.svg)](./package.json)
 [![Skills](https://img.shields.io/badge/skills-14-6366f1.svg)](./skills)
@@ -79,8 +79,12 @@ HelloAGENTS 叠加在 Claude Code、Gemini CLI 和 Codex CLI 之上，帮助模
 
 ## 相对 v3.0.7 的真实变化
 
-下面是当前 `v3.0.10` 相对 `v3.0.7` 的主要运行时和安装变化：
+下面是当前 `v3.0.11` 相对 `v3.0.7` 的主要运行时和安装变化：
 
+- 运行时工作流提示改成执行型表述，不再用“下一命令 / 下一阶段”这类分阶段建议去强化停顿感。
+- 显式使用 `~auto` 时，当前主路径会被当成直接执行路径；除非命中真实阻塞，否则不会把阶段结果改写成“下一步”交接。
+- 显式使用 `~loop` 时，当前循环按 `~loop` 自己的规则直接执行；现有方案包和验证建议只作为上下文，不再把循环本身带偏到别的命令。
+- 最终收尾的兜底文案不再写成“等待下一步指示”，避免任务已经完成时仍表现得像在等人工批准。
 - 主代理交付改用结构化 `turn-state`，明确区分 `complete`、`waiting`、`blocked`；stop、notify、收尾流程不再从自然语言里猜完成态。
 - 工作流恢复改为读取当前 `state_path`，状态文件按会话写入 `.helloagents/sessions/<branch>/<session-or-default>/STATE.md`。
 - 移除旧的项目根状态文件回退逻辑，恢复流程只走当前状态路径。

package/bootstrap-lite.md

@@ -1,6 +1,6 @@
 # HelloAGENTS (Standby)
 
-子代理执行子任务时，仅跳过路由、统一执行流程、输出格式和完成声明，直接执行并返回结果。不使用 `~command`，不包装 HelloAGENTS 外层格式；其余规则持续生效。
+子代理执行子任务时，仅跳过输出格式、交互规则、统一执行流程、交付分层、完成约束、路由和流程状态，直接执行并返回结果。不使用 `~command`，不包装 HelloAGENTS 外层格式；其余规则持续生效。
 
 ## 配置
 配置文件: ~/.helloagents/helloagents.json
@@ -27,10 +27,17 @@
 - 非编码任务：逻辑严密、结构清晰、表达专业、格式规范
 - 禁止以“能用就行”的标准交付
 
+### 语言与表述（强制）
+- 所有用户可见文本，包括回复、生成文件、CLI 输出、运行时提示、模板内容、文档与说明，都必须遵守：简洁、自然、准确、合理、不赘述、不冗余、不过度精简
+- 准确优先于压缩：不得为了更短而省略必要的条件、边界、风险、状态、路径、验证结论或下一步动作
+- 不写黑话、营销话、内部化表述或空泛形容；源码字段名、协议名、命令、路径、配置键等必须保留原名时除外
+- 不写无执行价值的客套、邀约、重复确认、能力陈述或空泛建议
+- 同一概念前后用语保持一致；先给结论再给细节，避免同义反复、重复解释和堆砌近义句
+
 ### 完整交付（强制）
 - 一次做完：用户需求明确且已获得执行授权时，必须一次性完成所有步骤再回复。只有符合下文“阻塞判定”的情况，才可中途停下
 - 授权优先执行：用户已明确同意当前方案、修改方向或继续执行时，直接继续。不得把已授权的后续动作改写为建议、可选项或等待确认
-- 禁止套话：回复末尾禁止添加无执行价值的客套、邀约或能力陈述。完成就结束；可直接继续执行时直接继续，不用“下一步建议”代替实际执行
+- 直接推进：可直接继续执行时直接继续，不用“下一步建议”代替实际执行
 
 ### 技术选型原则（全阶段生效）
 选择技术栈时，遵循以下思维框架而非固定方案：
@@ -110,8 +117,8 @@
 
 使用约束：
 - 状态图标与收尾内容必须一致。等待用户输入、确认、授权或补充信息时，只能使用 `❓等待输入`；仅在本轮执行已完成且不再等待用户输入时，才能使用 `✅完成`。
-- `🔄 下一步` 必须填写当前最合适的下一步动作。若存在自然后续动作，直接给出明确引导；若当前任务已完整结束且确无合理后续，可填写“当前任务已完成，等待您的下一步指示。”
-- 禁止在主体内容或 `🔄 下一步` 中加入无意义的客套、邀约、重复确认、能力陈述或空泛建议；不得把可直接给出的后续动作改写成条件式能力表述或询问句。
+- `🔄 下一步` 必须填写当前最合适的下一步动作。若存在自然后续动作，直接给出明确引导；若当前任务已完整结束且确无合理后续，可填写“当前任务已完成；无后续动作。”
+- `🔄 下一步` 只写真实下一步，不改写成条件式能力表述或询问句。
 
 ### 收尾状态信号
 - 为避免运行时从自然语言、图标或格式反推“完成 / 等待输入”，主代理在本轮最终收尾前必须先调用 `scripts/turn-state.mjs write`
@@ -203,7 +210,7 @@ templates/ 查找路径（按优先级；首次确定模板根目录后，本轮
 - 状态文件（`state_path`）— ≤70 行，用来记录“上次做到哪里”。判断当前任务时，当前用户消息、显式命令、活跃方案包 / PRD、代码与验证证据优先于状态文件
   内容：主线目标、正在做什么、关键上下文（决策/变更/假设）、下一步（具体可执行动作含文件路径）、阻塞项
   适用边界：
-  - 强制创建并持续更新：`~wiki`、`~init`、`~plan`、`~build`、`~auto`、`~prd`、`~loop`，以及进入统一执行流程/已激活项目的连续任务
+  - 强制创建并持续更新：`~wiki`、`~init`、`~plan`、`~build`、`~auto`、`~prd`、`~loop`，以及已激活项目的连续任务
   - 强制更新，不要求首次创建：`~clean`，主代理汇总子代理结果后
   - 已有则更新：`~verify`、`~review`（兼容别名）、`~test`、`~commit`
   - 不创建：`~help`、`~idea`、普通问答、一次性只读任务、子代理自身执行过程、压缩/恢复钩子

package/bootstrap.md

@@ -1,6 +1,6 @@
 # HelloAGENTS
 
-子代理执行子任务时，仅跳过路由、统一执行流程、输出格式和完成声明，直接执行并返回结果。不使用 `~command`，不包装 HelloAGENTS 外层格式；其余规则持续生效。
+子代理执行子任务时，仅跳过输出格式、交互规则、统一执行流程、交付分层、完成约束、路由和流程状态，直接执行并返回结果。不使用 `~command`，不包装 HelloAGENTS 外层格式；其余规则持续生效。
 
 ## 配置
 配置文件: ~/.helloagents/helloagents.json
@@ -27,10 +27,17 @@
 - 非编码任务：逻辑严密、结构清晰、表达专业、格式规范
 - 禁止以“能用就行”的标准交付
 
+### 语言与表述（强制）
+- 所有用户可见文本，包括回复、生成文件、CLI 输出、运行时提示、模板内容、文档与说明，都必须遵守：简洁、自然、准确、合理、不赘述、不冗余、不过度精简
+- 准确优先于压缩：不得为了更短而省略必要的条件、边界、风险、状态、路径、验证结论或下一步动作
+- 不写黑话、营销话、内部化表述或空泛形容；源码字段名、协议名、命令、路径、配置键等必须保留原名时除外
+- 不写无执行价值的客套、邀约、重复确认、能力陈述或空泛建议
+- 同一概念前后用语保持一致；先给结论再给细节，避免同义反复、重复解释和堆砌近义句
+
 ### 完整交付（强制）
 - 一次做完：用户需求明确且已获得执行授权时，必须一次性完成所有步骤再回复。只有符合下文“阻塞判定”的情况，才可中途停下
 - 授权优先执行：用户已明确同意当前方案、修改方向或继续执行时，直接继续。不得把已授权的后续动作改写为建议、可选项或等待确认
-- 禁止套话：回复末尾禁止添加无执行价值的客套、邀约或能力陈述。完成就结束；可直接继续执行时直接继续，不用“下一步建议”代替实际执行
+- 直接推进：可直接继续执行时直接继续，不用“下一步建议”代替实际执行
 
 ### 技术选型原则（全阶段生效）
 选择技术栈时，遵循以下思维框架而非固定方案：
@@ -110,8 +117,8 @@
 
 使用约束：
 - 状态图标与收尾内容必须一致。等待用户输入、确认、授权或补充信息时，只能使用 `❓等待输入`；仅在本轮执行已完成且不再等待用户输入时，才能使用 `✅完成`。
-- `🔄 下一步` 必须填写当前最合适的下一步动作。若存在自然后续动作，直接给出明确引导；若当前任务已完整结束且确无合理后续，可填写“当前任务已完成，等待您的下一步指示。”
-- 禁止在主体内容或 `🔄 下一步` 中加入无意义的客套、邀约、重复确认、能力陈述或空泛建议；不得把可直接给出的后续动作改写成条件式能力表述或询问句。
+- `🔄 下一步` 必须填写当前最合适的下一步动作。若存在自然后续动作，直接给出明确引导；若当前任务已完整结束且确无合理后续，可填写“当前任务已完成；无后续动作。”
+- `🔄 下一步` 只写真实下一步，不改写成条件式能力表述或询问句。
 
 ### 收尾状态信号
 - 为避免运行时从自然语言、图标或格式反推“完成 / 等待输入”，主代理在本轮最终收尾前必须先调用 `scripts/turn-state.mjs write`

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.10",
+  "version": "3.0.11",
   "description": "Quality-driven orchestration kernel for AI CLIs",
   "contextFileName": "bootstrap.md",
   "author": "HelloWind",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.10",
+  "version": "3.0.11",
   "type": "module",
   "description": "HelloAGENTS — The orchestration kernel that makes any AI CLI smarter. Adds intelligent routing, quality verification (Ralph Loop), safety guards, and notifications.",
   "author": "HelloWind",

package/scripts/workflow-state.mjs

@@ -49,42 +49,45 @@ 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} 当前应直接进入 CONSOLIDATE。执行路径：${recommendation.nextPath}。${recommendation.guidance}${suffix ? ` ${suffix}` : ''}`
   }
-  return `${recommendation.summary} 当前建议下一命令：~${recommendation.nextCommand}。推荐路径：${recommendation.nextPath}。${recommendation.guidance}${suffix ? ` ${suffix}` : ''}`
+  return `${recommendation.summary} 当前应执行 ~${recommendation.nextCommand}。执行路径：${recommendation.nextPath}。${recommendation.guidance}${suffix ? ` ${suffix}` : ''}`
 }
 
 function buildCommandRouteMessage(skillName, recommendation, verifyModeHint) {
   if (skillName === 'auto') {
     return recommendation.stage === 'consolidate'
-      ? `当前工作流约束：${recommendation.summary} 当前建议下一阶段：CONSOLIDATE。${recommendation.guidance} 若本次明确使用 ~auto，则在未命中阻塞判定时直接完成当前收尾，不再额外停下询问。`
-      : `当前工作流约束：${recommendation.summary} 当前建议主路径：${recommendation.nextPath}。${recommendation.guidance} 若本次明确使用 ~auto，则命中主路径后继续执行后续阶段，除非触发阻塞判定，否则不要在方案/PRD 阶段额外停下。`
+      ? `当前工作流约束：${recommendation.summary} 本次 ~auto 应直接完成当前收尾。${recommendation.guidance} 未命中阻塞判定前不要停下，也不要把收尾动作写成“下一步建议”。`
+      : `当前工作流约束：${recommendation.summary} 本次 ~auto 的执行主路径：${recommendation.nextPath}。${recommendation.guidance} 命中主路径后继续执行后续阶段；未触发阻塞判定前不要停下，也不要把阶段结果写成“下一步建议”。`
+  }
+  if (skillName === 'loop') {
+    return `当前工作流约束：用户已显式使用 ~loop，应按 ~loop 的循环规则直接执行。现有工作流只作上下文参考：${recommendation.summary} ${recommendation.guidance} 除非达到迭代上限、达成目标或命中阻塞判定，否则不要停下，也不要把单轮结果写成“下一步建议”。`
   }
   if (skillName === 'plan') {
     if (recommendation.stage === 'consolidate') {
-      return `当前工作流约束：${recommendation.summary} 当前更推荐的下一阶段其实是 CONSOLIDATE。只有在用户明确要求重规划、改方向或新增范围时，才继续 ~plan。`
+      return `当前工作流约束：${recommendation.summary} 当前不该重开 ~plan；除非用户明确要求重规划、改方向或新增范围，否则直接进入 CONSOLIDATE。`
     }
     return recommendation.nextCommand === 'plan'
-      ? `当前工作流约束：${recommendation.summary} 当前建议下一命令：~plan。${recommendation.guidance}`
-      : `当前工作流约束：${recommendation.summary} 当前更推荐的下一命令其实是 ~${recommendation.nextCommand}。只有在用户明确要求重规划、改方向或新增范围时，才继续 ~plan。`
+      ? `当前工作流约束：${recommendation.summary} 当前应执行 ~plan。${recommendation.guidance}`
+      : `当前工作流约束：${recommendation.summary} 当前不该继续 ~plan；先按 ~${recommendation.nextCommand} 处理。只有在用户明确要求重规划、改方向或新增范围时，才继续 ~plan。`
   }
   if (skillName === 'build') {
     if (recommendation.stage === 'consolidate') {
-      return `当前工作流约束：${recommendation.summary} 当前更推荐的下一阶段其实是 CONSOLIDATE。只有在用户明确提出新增实现范围时，才继续 ~build。`
+      return `当前工作流约束：${recommendation.summary} 当前不该继续 ~build；除非用户明确提出新增实现范围，否则直接进入 CONSOLIDATE。`
     }
     return recommendation.nextCommand === 'build'
-      ? `当前工作流约束：${recommendation.summary} 当前建议下一命令：~build。${recommendation.guidance}`
-      : `当前工作流约束：${recommendation.summary} 当前更推荐的下一命令其实是 ~${recommendation.nextCommand}。只有在用户明确提出新增实现范围时，才继续 ~build。`
+      ? `当前工作流约束：${recommendation.summary} 当前应执行 ~build。${recommendation.guidance}`
+      : `当前工作流约束：${recommendation.summary} 当前不该继续 ~build；先按 ~${recommendation.nextCommand} 处理。只有在用户明确提出新增实现范围时，才继续 ~build。`
   }
   if (skillName === 'verify') {
     if (recommendation.stage === 'consolidate') {
-      return `当前工作流约束：${recommendation.summary} 当前建议下一阶段：CONSOLIDATE。${recommendation.guidance}`
+      return `当前工作流约束：${recommendation.summary} 当前应直接进入 CONSOLIDATE。${recommendation.guidance}`
     }
     return recommendation.nextCommand === 'verify'
-      ? `当前工作流约束：${recommendation.summary} 当前建议下一命令：~verify。${recommendation.guidance}`
-      : `当前工作流约束：${recommendation.summary} 当前更推荐的下一命令其实是 ~${recommendation.nextCommand}。即使执行 ~verify，也不能越过当前工作流边界。${verifyModeHint ? ` 若本次仅做阶段内审查或验真，${verifyModeHint}` : ''}`
+      ? `当前工作流约束：${recommendation.summary} 当前应执行 ~verify。${recommendation.guidance}`
+      : `当前工作流约束：${recommendation.summary} 当前不该把 ~verify 当成越级入口；先按 ~${recommendation.nextCommand} 处理。即使执行 ~verify，也不能越过当前工作流边界。${verifyModeHint ? ` 若本次仅做阶段内审查或验真，${verifyModeHint}` : ''}`
   }
-  return `当前工作流约束：${recommendation.summary} 当前建议下一命令：~${recommendation.nextCommand}。${recommendation.guidance}`
+  return `当前工作流约束：${recommendation.summary} 当前应执行 ~${recommendation.nextCommand}。${recommendation.guidance}`
 }
 
 export function buildCommandRouteHint(skillName, cwd, options = {}) {

package/skills/hello-write/SKILL.md

@@ -3,6 +3,8 @@ name: hello-write
 description: 撰写文档、README、技术方案、分析报告、用户指南，或任何需要专业文本产出的任务时使用。
 ---
 
+文本产出先遵守当前 bootstrap 的通用语言规则：简洁、自然、准确、合理、不赘述、不冗余、不过度精简；准确优先于压缩，不写黑话、空话、营销话和无执行价值的客套。
+
 文本产出必须遵循以下规范。
 
 ## 编码前
@@ -19,6 +21,8 @@ description: 撰写文档、README、技术方案、分析报告、用户指南
 - 短句优于长句（中文 ≤40 字/句，英文 ≤25 词/句）
 - 技术术语首次出现时解释
 - 避免模糊词（"一些"、"可能"、"大概"）→ 用具体数据
+- 不重复同一结论，不堆叠近义句
+- 不为追求简短省略必要条件、边界和风险说明
 
 ## 格式
 - 代码块标注语言