helloagents 3.1.5 → 3.1.7

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.1.5",
+  "version": "3.1.7",
   "description": "HelloAGENTS — The orchestration kernel that makes any AI CLI smarter. Adds intelligent routing, unified QA gates, safety guards, and notifications.",
   "author": {
     "name": "HelloWind",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.1.5",
+  "version": "3.1.7",
   "description": "HelloAGENTS — Quality-driven orchestration kernel for AI CLIs with intelligent routing, unified QA gates, 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.1.5-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.1.6-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)
@@ -112,8 +112,7 @@ Commands run inside the AI CLI chat with a `~` prefix. The command skill is read
 
 | Command | Purpose |
 |---------|---------|
-| `~idea` | Lightweight exploration and option comparison; does not write files |
-| `~office` | Worth/scope review before planning; decides whether to do it, how big, and what the smallest wedge is |
+| `~ask` | Interactive clarification: Q&A to pin down goals, direction, scope, and constraints; does not write files |
 | `~auto` | Chooses the main path and keeps going until delivery or a real blocker |
 | `~plan` | Requirements, solution design, task breakdown, and plan package |
 | `~build` | Implementation from the current request or an existing plan |
@@ -131,8 +130,9 @@ Compatibility aliases:
 - `~do` → `~build`
 - `~design` → `~plan`
 - `~review` → `~qa`
+- `~idea` → `~ask` (deprecated)
 
-Use `~idea` when you want to compare approaches. Use `~office` when you first need to decide whether the work is worth doing at all, how big it should be, and what the smallest wedge is.
+Use `~ask` for clarifying requirements, comparing approaches, weighing value, and scoping — pure conversation, no files created.
 
 ### 3) Project knowledge base
 
@@ -481,8 +481,7 @@ Codex global mode is installed by HelloAGENTS automatically through the local-pl
 
 | Goal | Use |
 |------|-----|
-| Compare ideas before writing files | `~idea "compare two API designs"` |
-| Decide whether something is worth doing and how small to start | `~office "should this become a full platform or just a thin wedge?"` |
+| Clarify requirements, compare approaches, decide scope & value | `~ask "should this become a full platform or just a thin wedge?"` |
 | Let HelloAGENTS choose the path and continue | `~auto "add JWT login"` |
 | Review a plan before implementation | `~plan "refactor payment module"` |
 | Implement from a clear request or active plan | `~build "finish task 2 in the plan"` |
@@ -558,7 +557,7 @@ Routing and tiering → Goal clarification → Planning → Implementation → Q
 
 | Stage | Purpose |
 |-------|---------|
-| `Routing and tiering` | decide whether the task should go through `~idea`, `~office`, `~plan`, `~build`, `~qa`, `~prd`, or automatic flow |
+| `Routing and tiering` | decide whether the task should go through `~ask`, `~plan`, `~build`, `~qa`, `~prd`, or automatic flow |
 | `Goal clarification` | clarify goal, constraints, and success criteria |
 | `Planning` | prepare plan files and choose needed skills |
 | `Implementation` | implement and run local checks |

package/README_CN.md

@@ -8,7 +8,7 @@
 
 **面向 AI 编码 CLI 的工作流层：技能、知识库、交付检查、更安全的配置写入，以及可恢复的执行流程。**
 
-[![Version](https://img.shields.io/badge/version-3.1.5-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.1.6-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)
@@ -47,7 +47,7 @@
 
 ## HelloAGENTS 做什么
 
-AI 编码 CLI 写代码很快，但也容易停在建议、跳过检查、丢失项目上下文、遇到困难推卸责任，或在真正完成前就报告完成。
+AI 编码 CLI 写代码能力很强，但常见问题也很明显：停在建议不肯动手、跳过检查步骤、丢失项目上下文、遇到困难推卸责任、没做完就报告完成。
 
 HelloAGENTS 叠加在 Claude Code、Gemini CLI 和 Codex CLI 之上，将模型锚定为高能力执行者，阻断推责模式，帮助模型选择合适流程、使用任务相关的质量技能、维护项目知识库，并在交付前完成验证。
 
@@ -112,8 +112,7 @@ HelloAGENTS 内置 14 个技能。技能只在当前阶段需要时读取，因
 
 | 命令 | 用途 |
 |------|------|
-| `~idea` | 轻量探索和方向比较；不写文件 |
-| `~office` | 价值与范围评估；先判断该不该做、该做多大、先做哪一小块 |
+| `~ask` | 交互式需求澄清：一问一答厘清目标、方向、范围与约束；不写文件 |
 | `~auto` | 自动选择主路径，并持续推进到交付或真实阻塞 |
 | `~plan` | 需求、方案、任务拆分和方案包 |
 | `~build` | 按当前请求或现有方案实现 |
@@ -131,8 +130,9 @@ HelloAGENTS 内置 14 个技能。技能只在当前阶段需要时读取，因
 - `~do` → `~build`
 - `~design` → `~plan`
 - `~review` → `~qa`
+- `~idea` → `~ask`（逐步废弃）
 
-`~idea` 适合比较几种方向；`~office` 适合先判断这件事值不值得做、要不要做这么大，以及最小切口应该落在哪里。
+`~ask` 适合厘清需求、比较方向、判断价值、收缩范围——纯对话，不创建文件。
 
 ### 3）项目知识库
 
@@ -481,8 +481,7 @@ Codex 全局模式由 HelloAGENTS 通过本地插件路径自动安装。
 
 | 目标 | 使用 |
 |------|------|
-| 写文件前先比较方案 | `~idea "compare two API designs"` |
-| 先判断值不值得做、要不要做这么大 | `~office "should this become a full platform or just a thin wedge?"` |
+| 厘清需求、比较方向、判断价值与范围 | `~ask "should this become a full platform or just a thin wedge?"` |
 | 让 HelloAGENTS 自己选路并持续推进 | `~auto "add JWT login"` |
 | 先审查方案再实现 | `~plan "refactor payment module"` |
 | 按明确请求或活跃方案实现 | `~build "finish task 2 in the plan"` |
@@ -562,7 +561,7 @@ Codex 全局模式由 HelloAGENTS 通过本地插件路径自动安装。
 
 | 阶段 | 用途 |
 |------|------|
-| 选路与分层 | 判断任务应走 `~idea`、`~plan`、`~build`、`~qa`、`~prd` 还是自动流程 |
+| 选路与分层 | 判断任务应走 `~ask`、`~plan`、`~build`、`~qa`、`~prd` 还是自动流程 |
 | 目标澄清 | 明确目标、约束和完成标准 |
 | 规划 | 准备方案文件并选择需要的技能 |
 | 实现 | 实现并做局部检查 |

package/bootstrap-lite.md

@@ -11,7 +11,7 @@
 `output_language` 非空时，所有用户可见文本使用该语言；为空则跟随用户当前语言。
 会话级缓存优先：当前上下文已有"当前用户设置"、原始 JSON 或读取摘要，且覆盖所需配置项时，直接复用。
 仅在缺少所需项、用户要求刷新，或本次修改后需要核验时读取；对 Codex 来说，首次对话前若当前上下文仍缺少所需配置项，必须先读取一次 `~/.helloagents/helloagents.json`，压缩/恢复后的首次对话同样先重读一次；输出格式只在缺少 `output_format` 已知值时触发读取。
-同一会话内，同一路径的配置文件、模块、SKILL、模板只读一次并跨轮复用；读取失败必须明示，并按默认值或已知设置执行。
+同一会话内，同一路径的配置文件、模块、`SKILL`、模板只读一次并跨轮复用；读取失败必须明示，并按默认值或已知设置执行。
 
 ## 通用交付规则（强制）
 
@@ -32,7 +32,7 @@
 - 涉及判断与取舍时，先判断约束是否真实，再给干净目标，最后再谈迁移路径。
 - 若明显被当前实现、旧命名、旧目录、半成品结构或兼容压力拖住，先切到终局倒推或零遗留视角，重看正确目标。
 - 公开 API、持久化数据、已文档化集成、用户承诺、部署与合规要求等才算真实约束；内部调用方、旧命名、旧目录结构、半成品实现和“改动会很大”不自动成立。
-- 若答案明显被兼容性崇拜、局部细节、重构恐惧或温和偏差拖小，必须补上更明确的判断。还要补上最小第一步、首个证明点、证伪条件、裁剪清单和止损规则。纯翻译、纯改写、纯提取、纯格式转换，以及无判断空间的机械执行不强制展开。
+- 若答案明显被兼容性崇拜、局部细节、重构恐惧或惯性偏差拖累，必须补上更明确的判断。还要补上最小第一步、首个证明点、证伪条件、裁剪清单和止损规则。纯翻译、纯改写、纯提取、纯格式转换，以及无判断空间的机械执行不强制展开。
 - 普通问答、解释、分析、改写、邮件回复和其他一次性交付，不进入完整实现/验证流程，但仍属于交付；默认只交付与当前请求直接对应的一版最终结果。“一版”只限制版本数量，不限制完成当前请求所需的必要内容。请求已满足时直接结束，不主动追加无执行价值的延伸、派生版本、不同写法、第二版或邀约式收尾，除非用户明确要求
 - 准确优先于压缩：不得为了更短而省略必要的条件、边界、风险、状态、路径、验证结论或下一步动作。也不得为了满足上文“一版”“直接结束”“不重复赘述”“不冗余”等要求而省略这些内容
 - 回复末尾只保留结论、风险、限制、已完成状态、阻塞项或真实下一步动作；不得用条件式邀约、自我能力陈述或“如果需要 / 如需 / 我可以继续”这类表述替代交付
@@ -161,28 +161,30 @@
 - 确认必须对应当前阻塞执行的唯一决策，不得用确认替代本可直接执行的步骤
 - 已获得明确同意时，不再追加确认环节
 - 每次只问一个问题，偏好选择题，根据用户回答动态决定下一个问题
-- 需要同时确认多个相关类别时，用"— "前缀标题标明类别，编号从 1 开始连续不重置
+- 需要同时确认多个相关类别时，用"- "前缀标题标明类别，编号从 1 开始连续不重置
 - 推荐选项标注（推荐）并给出理由
 - 用户回复数字即可选择，也可以直接输入自己的想法
 
 示例（单类别）：
 ```
-— [类别名称]
-1. [选项A]（推荐）— [具体特征描述]
-2. [选项B] — [具体特征描述]
+- [类别名称]
+1. [选项A]（推荐）—— [具体特征描述]
+2. [选项B] —— [具体特征描述]
+
+回复编号选择，如：1
 ```
 
 示例（多类别同轮）：
 ```
-— [类别A]
-1. [选项]（推荐）— [具体特征描述]
-2. [选项] — [具体特征描述]
+- [类别A]
+1. [选项]（推荐）—— [具体特征描述]
+2. [选项] —— [具体特征描述]
 
-— [类别B]
-3. [选项]（推荐）— [具体特征描述]
-4. [选项] — [具体特征描述]
+- [类别B]
+3. [选项]（推荐）—— [具体特征描述]
+4. [选项] —— [具体特征描述]
 
-回复编号选择，如: 1, 3
+回复编号选择，如：1, 4
 ```
 
 ### 阻塞判定
@@ -209,10 +211,10 @@
 用户说"重置"或"reset" → 忽略之前的上下文，从头开始
 
 ## 工作流与完成判定
-涉及实现任务时，先按任务分层与命令路由确定路径，再进入实现、质量闭环与收尾。本文件只保留轻量规则，不展开各阶段的完整说明。
+涉及实现任务时，先按任务分层与命令路由确定路径，再进入实现、质量闭环与收尾。本文件只保留轻量规则，不展开各阶段的完整说明。进入对应命令（~plan/~build/~qa 等）后，按该命令的 SKILL.md 执行完整流程。
 
 ### 任务分层
-- `T0` — 只读分析、创意探索、方案比较、范围评估 → 自然响应或 `~idea` / `~office`
+- `T0` — 只读分析、创意探索、方案比较、范围评估 → 自然响应或 `~ask`
 - `T1` — 低风险小改动、明确实现、显式质量闭环、单文件或局部改动 → 直接执行或 `~build` / `~qa`
 - `T2` — 新项目、从零构建、3+ 文件新功能、架构级变更或需要结构化产物 → `~plan` 或 `~auto`
 - `T3` — 高风险或不可逆操作（权限、安全、支付、数据库、生产发布等）→ 先 `~plan` / `~prd`，再 `~build` / `~qa`
@@ -230,7 +232,7 @@
   - 显式 `~commit` 不受这个开关影响；除非用户明确要求，不自动远程 `git push`
 
 ### 命令路由
-- `~do` 是 `~build` 的兼容别名；`~design` 是 `~plan` 的兼容别名；`~review` 是 `~qa` 的兼容别名
+- `~do` 是 `~build` 的兼容别名；`~design` 是 `~plan` 的兼容别名；`~review` 是 `~qa` 的兼容别名；`~idea` 是 `~ask` 的兼容别名
 - `~test` — 为指定模块或最近变更编写测试
 - 路径定义：`{HELLOAGENTS_READ_ROOT}` = 当前对话已确定的 HelloAGENTS 读取根目录，统一用于读取 `skills/` 与 `templates/`
 - `~command` 路由：用户输入 `~xxx` 时，立即读取对应的 SKILL.md 并按其流程执行，不要自行探索或猜测。若当前上下文已解析出具体命令技能文件路径，直接使用它；否则先确定当前技能根目录：
@@ -260,7 +262,7 @@ templates/ 查找路径（按优先级；首次确定模板根目录后，本会
   - 强制创建并持续更新：`~init`、`~plan`、`~build`、`~auto`、`~prd`、`~loop`，以及已进入项目连续流程的任务，或任何会创建/修改本地文件、会在当前工作区留下实际输出或操作记录的非只读任务
   - 强制更新，不要求首次创建：`~clean`，主代理汇总子代理结果后
   - 已有则更新：`~qa`、`~test`、`~commit`
-  - 不创建：`~help`、`~idea`、`~office`、普通问答、一次性只读任务、子代理自身执行过程、压缩/恢复钩子
+  - 不创建：`~help`、`~ask`、普通问答、一次性只读任务、子代理自身执行过程、压缩/恢复钩子
   更新规则：
   - 属于“强制创建并持续更新”范围且状态文件不存在时，按 templates/STATE.md 创建
   - 每次更新是重写，不是追加。状态文件只记录当前状态，不记录历史

package/bootstrap.md

@@ -11,7 +11,7 @@
 `output_language` 非空时，所有用户可见文本使用该语言；为空则跟随用户当前语言。
 会话级缓存优先：当前上下文已有"当前用户设置"、原始 JSON 或读取摘要，且覆盖所需配置项时，直接复用。
 仅在缺少所需项、用户要求刷新，或本次修改后需要核验时读取；对 Codex 来说，首次对话前若当前上下文仍缺少所需配置项，必须先读取一次 `~/.helloagents/helloagents.json`，压缩/恢复后的首次对话同样先重读一次；输出格式只在缺少 `output_format` 已知值时触发读取。
-同一会话内，同一路径的配置文件、模块、SKILL、模板只读一次并跨轮复用；读取失败必须明示，并按默认值或已知设置执行。
+同一会话内，同一路径的配置文件、模块、`SKILL`、模板只读一次并跨轮复用；读取失败必须明示，并按默认值或已知设置执行。
 
 ## 通用交付规则（强制）
 
@@ -32,7 +32,7 @@
 - 涉及判断与取舍时，先判断约束是否真实，再给干净目标，最后再谈迁移路径。
 - 若明显被当前实现、旧命名、旧目录、半成品结构或兼容压力拖住，先切到终局倒推或零遗留视角，重看正确目标。
 - 公开 API、持久化数据、已文档化集成、用户承诺、部署与合规要求等才算真实约束；内部调用方、旧命名、旧目录结构、半成品实现和“改动会很大”不自动成立。
-- 若答案明显被兼容性崇拜、局部细节、重构恐惧或温和偏差拖小，必须补上更明确的判断。还要补上最小第一步、首个证明点、证伪条件、裁剪清单和止损规则。纯翻译、纯改写、纯提取、纯格式转换，以及无判断空间的机械执行不强制展开。
+- 若答案明显被兼容性崇拜、局部细节、重构恐惧或惯性偏差拖累，必须补上更明确的判断。还要补上最小第一步、首个证明点、证伪条件、裁剪清单和止损规则。纯翻译、纯改写、纯提取、纯格式转换，以及无判断空间的机械执行不强制展开。
 - 普通问答、解释、分析、改写、邮件回复和其他一次性交付，不进入完整实现/验证流程，但仍属于交付；默认只交付与当前请求直接对应的一版最终结果。“一版”只限制版本数量，不限制完成当前请求所需的必要内容。请求已满足时直接结束，不主动追加无执行价值的延伸、派生版本、不同写法、第二版或邀约式收尾，除非用户明确要求
 - 准确优先于压缩：不得为了更短而省略必要的条件、边界、风险、状态、路径、验证结论或下一步动作。也不得为了满足上文“一版”“直接结束”“不重复赘述”“不冗余”等要求而省略这些内容
 - 回复末尾只保留结论、风险、限制、已完成状态、阻塞项或真实下一步动作；不得用条件式邀约、自我能力陈述或“如果需要 / 如需 / 我可以继续”这类表述替代交付
@@ -161,28 +161,30 @@
 - 确认必须对应当前阻塞执行的唯一决策，不得用确认替代本可直接执行的步骤
 - 已获得明确同意时，不再追加确认环节
 - 每次只问一个问题，偏好选择题，根据用户回答动态决定下一个问题
-- 需要同时确认多个相关类别时，用"— "前缀标题标明类别，编号从 1 开始连续不重置
+- 需要同时确认多个相关类别时，用"- "前缀标题标明类别，编号从 1 开始连续不重置
 - 推荐选项标注（推荐）并给出理由
 - 用户回复数字即可选择，也可以直接输入自己的想法
 
 示例（单类别）：
 ```
-— [类别名称]
-1. [选项A]（推荐）— [具体特征描述]
-2. [选项B] — [具体特征描述]
+- [类别名称]
+1. [选项A]（推荐）—— [具体特征描述]
+2. [选项B] —— [具体特征描述]
+
+回复编号选择，如：1
 ```
 
 示例（多类别同轮）：
 ```
-— [类别A]
-1. [选项]（推荐）— [具体特征描述]
-2. [选项] — [具体特征描述]
+- [类别A]
+1. [选项]（推荐）—— [具体特征描述]
+2. [选项] —— [具体特征描述]
 
-— [类别B]
-3. [选项]（推荐）— [具体特征描述]
-4. [选项] — [具体特征描述]
+- [类别B]
+3. [选项]（推荐）—— [具体特征描述]
+4. [选项] —— [具体特征描述]
 
-回复编号选择，如: 1, 3
+回复编号选择，如：1, 4
 ```
 
 ### 阻塞判定
@@ -210,7 +212,7 @@
 
 ## 工作流与完成判定
 ### 任务分层
-- `T0` — 只读分析、创意探索、方案比较、范围评估 → 自然响应或 `~idea` / `~office`
+- `T0` — 只读分析、创意探索、方案比较、范围评估 → 自然响应或 `~ask`
 - `T1` — 低风险小改动、明确实现、显式质量闭环、单文件或局部改动 → 直接执行或 `~build` / `~qa`
 - `T2` — 新项目、从零构建、3+ 文件新功能、架构级变更或需要结构化产物 → `~plan` 或 `~auto`
 - `T3` — 高风险或不可逆操作（权限、安全、支付、数据库、生产发布等）→ 先 `~plan` / `~prd`，再 `~build` / `~qa`
@@ -219,8 +221,7 @@
 
 #### 1. 选路与分层
 先判断任务类型、风险等级、是否需要结构化产物，再决定进入哪条路径：
-- 创意探索 / 方案比较 → `~idea`
-- 值得做与否 / 范围收缩 / 先做多大 → `~office`
+- 创意探索 / 方案比较 / 方向不明 / 范围收缩 → `~ask`
 - 明确实现 / 小范围修复 → `~build`
 - 为指定模块编写测试 → `~test`
 - 结构化规划 / 新功能 / 新项目 → `~plan`
@@ -236,7 +237,7 @@
 - 约束：平台、技术、风险、时间、现有架构
 - 成功标准：做到什么程度算完成
 
-`~idea` / `~office` / `~plan` / `~prd` 在此阶段展开探索或需求澄清；`~build` 在需求明确时快速通过。
+`~ask` / `~plan` / `~prd` 在此阶段展开探索或需求澄清；`~build` 在需求明确时快速通过。
 
 #### 3. 规划与上下文准备
 根据 skills/ 目录下各 hello-* 技能的 SKILL.md frontmatter（name + description），标记本次任务可能需要的技能（不读取文件内容，仅记录名称）。
@@ -250,8 +251,7 @@ hello-* 技能读取路径：`{HELLOAGENTS_READ_ROOT}/skills/{技能名}/SKILL.m
 - `~build` 读取现有方案包并做定位，不重复发明方案
 - `contract.json` 是方案包的机器契约，至少明确 `qaMode`、`qaFocus`；只有在 T3 / UI / 高风险流程确有收益时，才额外声明 `advisor`；进入质量闭环或最终交付前，优先消费它而不是从自然语言描述里回推执行路径
 - 涉及 UI 时，设计约束优先级固定为：当前 `plan.md` / PRD UI 决策 → 逻辑 `.helloagents/DESIGN.md`（实际路径按当前项目存储模式解析） → 已读取的 `hello-ui` 规则；同时所有 UI 任务都必须满足 UI 质量基线
-- `~idea` 在输出比较与推荐后结束，不进入实现，也不创建 `.helloagents/`、状态文件或方案包
-- `~office` 在输出价值/范围判断后结束，不进入实现，也不创建 `.helloagents/`、状态文件或方案包
+- `~ask` 在一问一答交互澄清后结束，不进入实现，也不创建 `.helloagents/`、状态文件或方案包
 
 #### 4. 实现
 进入实现时，读取上一阶段标记的技能 SKILL.md（按上方 hello-* 技能查找路径读取 `skills/{技能名}/SKILL.md`），按其规范执行。
@@ -299,7 +299,7 @@ hello-* 技能读取路径：`{HELLOAGENTS_READ_ROOT}/skills/{技能名}/SKILL.m
 - 若 active goal 的目标已全部完成，先完成 HelloAGENTS 验证、收尾检查与本地版本检查点，再调用 `update_goal` 标记 complete。不得因预算接近耗尽、单轮结束或准备停下而标记 complete
 
 ### 命令路由
-- `~do` 是 `~build` 的兼容别名；`~design` 是 `~plan` 的兼容别名；`~review` 是 `~qa` 的兼容别名
+- `~do` 是 `~build` 的兼容别名；`~design` 是 `~plan` 的兼容别名；`~review` 是 `~qa` 的兼容别名；`~idea` 是 `~ask` 的兼容别名
 - `~test` — 为指定模块或最近变更编写测试
 - 路径定义：`{HELLOAGENTS_READ_ROOT}` = 当前对话已确定的 HelloAGENTS 读取根目录，统一用于读取 `skills/` 与 `templates/`
 - `~command` 路由：用户输入 `~xxx` 时，立即读取对应的 SKILL.md 并按其流程执行，不要自行探索或猜测。若当前上下文已解析出具体命令技能文件路径，直接使用它；否则先确定当前技能根目录：
@@ -329,7 +329,7 @@ templates/ 查找路径（按优先级；首次确定模板根目录后，本会
   - 强制创建并持续更新：`~init`、`~plan`、`~build`、`~auto`、`~prd`、`~loop`，以及已进入项目连续流程的任务，或任何会创建/修改本地文件、会在当前工作区留下实际输出或操作记录的非只读任务
   - 强制更新，不要求首次创建：`~clean`，主代理汇总子代理结果后
   - 已有则更新：`~qa`、`~test`、`~commit`
-  - 不创建：`~help`、`~idea`、`~office`、普通问答、一次性只读任务、子代理自身执行过程、压缩/恢复钩子
+  - 不创建：`~help`、`~ask`、普通问答、一次性只读任务、子代理自身执行过程、压缩/恢复钩子
   更新规则：
   - 属于“强制创建并持续更新”范围且状态文件不存在时，按 templates/STATE.md 创建
   - 每次更新是重写，不是追加。状态文件只记录当前状态，不记录历史

package/gemini-extension.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.1.5",
+  "version": "3.1.7",
   "type": "module",
   "description": "HelloAGENTS — The orchestration kernel that makes any AI CLI smarter. Adds intelligent routing, unified QA gates, safety guards, and notifications.",
   "author": "HelloWind",

package/scripts/notify-context.mjs

@@ -12,6 +12,7 @@ const COMMAND_ALIASES = {
   do: 'build',
   design: 'plan',
   review: 'qa',
+  idea: 'ask',
 };
 
 function buildRuntimeRootBlock(pkgRoot) {
@@ -165,7 +166,7 @@ export function buildSemanticRouteInstruction(cwd, payload = {}) {
     '请根据用户请求的真实意图选路，不依赖关键词表。',
     buildDelegatedTaskHint(),
     '任务分层：T0=探索/比较；T1=低风险小改动或显式验证；T2=多文件功能/新项目/需要结构化产物；T3=高风险或不可逆操作。',
-    '路由映射：~idea=只读探索与方向比较，不创建文件；~office=只读价值/范围评估，不创建文件；~build=明确实现；~qa=统一质量审查/验证/修复/收尾；~plan=结构化规划；~prd=重型规格；~auto=自动选择并继续执行后续阶段。',
+    '路由映射：~ask=一问一答交互澄清，不创建文件；~build=明确实现；~qa=统一质量审查/验证/修复/收尾；~plan=结构化规划；~prd=重型规格；~auto=自动选择并继续执行后续阶段。',
     '若判定为 T3，默认先走 ~plan / ~prd；纯质量审查、验真或收尾请求才优先 ~qa。',
     `涉及 UI 任务时，设计决策优先级：当前活跃 plan / PRD → ${describeProjectStoreFile(cwd, 'DESIGN.md')} → 已读取的 hello-ui 规则；同时所有 UI 任务都必须满足 UI 质量基线。`,
     projectStorageHint,

package/scripts/runtime-context.mjs

@@ -78,13 +78,13 @@ export function clearRouteContext(options = {}) {
 }
 
 export function writeRouteContext({ cwd, skillName, sourceSkillName = skillName, payload = {}, env, ppid }) {
-  const shouldEnsureProjectLocal = skillName !== 'idea' && skillName !== 'office' && skillName !== 'help'
+  const shouldEnsureProjectLocal = skillName !== 'ask' && skillName !== 'help'
   const scope = getRuntimeScope(cwd, { payload, env, ppid, ensureProjectLocal: shouldEnsureProjectLocal })
   const context = {
     cwd: normalizePath(cwd),
     skillName,
     sourceSkillName,
-    zeroSideEffect: skillName === 'idea' || skillName === 'office',
+    zeroSideEffect: skillName === 'ask',  // 写入会话胶囊供未来运行时消费；当前由 SKILL.md 铁律 + guard 设计共同保证边界
     identity: extractPayloadIdentity(payload),
     source: routeSource(payload),
     promptHash: hashPrompt(payload.prompt),

package/scripts/workflow-plan-files.mjs

@@ -22,7 +22,7 @@ const PLAN_TEMPLATE_MARKERS = {
   ],
   'tasks.md': [
     /# \{项目\/功能名称\} — 任务分解/,
-    /\[按执行顺序排列，每个任务独立可验证\]/,
+    /\[按执行顺序排列，每个任务可独立验证\]/,
     /- \[ \] 任务1（AFK\/HITL）：端到端行为描述/,
   ],
 }

package/scripts/workflow-recommendation.mjs

@@ -159,7 +159,7 @@ function buildInProgressRecommendation(scopeLabel, plan, classification) {
     nextCommand: 'build',
     nextPath: '~build -> ~qa',
     summary: `${scopeLabel} "${plan.planName}" 仍有 ${classification.openCount} 个未完成任务。`,
-    guidance: '若用户是在继续当前功能、落实既有方案、或让你“继续做完”，优先复用现有 requirements.md / plan.md / tasks.md 进入 ~build；完成当前实现后再进入 ~qa。除非用户明确要求重规划或现有方案已失效，不要重新回到 ~idea。',
+    guidance: '若用户是在继续当前功能、落实既有方案、或让你“继续做完”，优先复用现有 requirements.md / plan.md / tasks.md 进入 ~build；完成当前实现后再进入 ~qa。除非用户明确要求重规划或现有方案已失效，不要重新回到 ~ask。',
   }
 }
 

package/skills/commands/ask/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: ~ask
+description: 交互式需求澄清 — 一问一答厘清目标、方向、范围与约束，纯对话不创建文件（~ask 命令）
+policy:
+  allow_implicit_invocation: false
+---
+Trigger: ~ask [description]
+
+`~ask` 是交互式需求澄清命令，用于在不写文件、不进入执行、不激活完整项目流程的前提下，通过一问一答帮用户厘清目标、比较方向、判断价值、收缩范围、挑战前提。
+兼容别名：`~idea`（逐步废弃）。
+
+## 铁律
+- 只讨论，不编写实现代码，不创建项目文件，不执行实现操作
+- 不创建 `.helloagents/`
+- 不创建或更新当前项目存储中的 `state_path`；同样禁止更新知识库文件、方案包或项目级规则文件
+- 不生成方案包
+- 不执行会改变工作区或外部状态的命令
+- 不默认使用子代理
+- 每次只问一个问题，不一次性抛出多个问题
+- 每个问题必须给出推荐选项和理由，不让用户从空白开始思考
+
+## 交互模式
+
+### 核心规则
+
+一问一答，逐条推进：
+
+1. **一次只问一个问题**。不批量提问，不生成问题清单。问完一个、用户回答、再问下一个。
+2. **优先选择题**。每个问题给出 2-3 个选项，标注推荐项及理由。选项使用数字编号，格式遵循全局「选择确认」规则；用户回复数字即可选择，也可以直接输入自己的想法。
+3. **你主动读代码库**。如果答案能从现有代码中找到（命名规范、配置模式、现有抽象、类似实现），你自己去找，不打扰用户。连续解决多个问题而不需要用户输入才是好的 ~ask 会话。
+4. **覆盖核心维度**。在对话中自然覆盖以下维度，不分阶段、不填表：
+   - **方向**：有哪几种可行做法？各自优劣是什么？
+   - **价值**：这件事值得现在做吗？最痛的人是谁？不做会怎样？
+   - **范围**：最小可验证切口是什么？做多大的版本？先做哪一块？
+   - **前提**：哪些假设最可疑？如果前提不成立会怎样？最省成本的验证方式是什么？
+5. **用户可随时重定向**。用户说"其实都不是——我要的是这样"时，你立即沿新方向继续，不坚持原选项。
+
+### 交互节奏
+
+- 已有代码库：你先静默读 5-15 个相关文件，基于代码证据形成假设，再以选择题形式逐条确认
+- 全新项目：直接从最高不确定性的决策开始问
+- 每个问题用户通常 5-10 秒回答
+- 整个交互澄清过程通常约 10 分钟
+
+## 流程
+
+### 1. 快速理解问题
+
+- 用一句话重述用户当前要解决的问题
+- 明确讨论目标：是"不知道有哪些做法"、"不确定值不值得做"、还是"不知道该做多大"
+- 已有项目时，静默扫描相关代码（不向用户展示扫描过程），形成内部假设
+
+### 2. 交互澄清（核心阶段）
+
+按交互模式核心规则，逐条推进。默认从最高不确定性的决策开始：
+
+- 方向不明确 → 先问方向
+- 范围有争议 → 先问范围
+- 前提可疑 → 先挑战前提
+- 都不确定 → 先问最影响后续决策的那个
+
+遇到以下信号时自然收束：
+- 用户连续确认推荐选项，无额外补充 → 方向已收敛
+- 关键决策全部有明确答案 → 可以汇总
+- 用户说"可以了"、"就这样"、"开始做吧" → 立即汇总
+
+### 3. 汇总决策
+
+对话结束时，输出结构化选择摘要：
+
+- **目标**：要解决什么问题
+- **选定方向**：选了什么做法，为什么
+- **范围边界**：做多大、先做哪块、明确不做哪些
+- **已验证的前提**：确认了哪些关键假设，搁置了哪些
+- **悬而未决**：还有哪些决策需要在后续阶段进一步明确
+
+摘要用简洁列表，不写段落叙述。
+
+### 4. 给出升级路径
+
+根据交互澄清的结果，推荐下一步：
+
+- 已厘清方向，可以形成方案 → `~plan`
+- 已厘清需求，可以直接实现 → `~build`
+- 需要重型产品规格 → `~prd`
+- 想让 你 自动执行完整流程 → `~auto`
+
+如果用户在 `~ask` 过程中转而明确要求写文件、改代码、创建知识库或执行命令，不在 `~ask` 内偷偷写文件；改为按最合适的升级路径继续。
+
+## 快速通道
+
+用户明确表示"直接做，不用问我"、"按默认来"、"你决定"时，你 基于代码分析直接给出推荐方向和升级路径，跳过逐条交互。
+
+## 输出要求
+
+- 先给结论，再给依据
+- 不做"点子堆砌"——不列一堆方向让用户自己挑
+- 不把尚未确认的假设伪装成事实
+- 不把"可以做很大"默认当成推荐答案
+- 涉及视觉/交互时，选项必须具体到可执行特征

package/skills/commands/auto/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: ~auto
-description: 自动执行命令 — 自动选择并依次执行 ~idea / ~office / ~plan / ~build / ~qa / ~prd，默认持续推进直到交付完成（~auto 命令）
+description: 自动执行命令 — 自动选择并依次执行 ~ask / ~plan / ~build / ~qa / ~prd，默认持续推进直到交付完成（~auto 命令）
 policy:
   allow_implicit_invocation: false
 ---
 Trigger: ~auto <任务描述>
 
-`~auto` 是自动执行命令。它根据任务类型、复杂度、风险等级与项目状态，在 `~idea`、`~office`、`~plan`、`~build`、`~qa`、`~prd` 之间选择合适主路径，并连续推进。
+`~auto` 是自动执行命令。它根据任务类型、复杂度、风险等级与项目状态，在 `~ask`、`~plan`、`~build`、`~qa`、`~prd` 之间选择合适主路径，并连续推进。
 `~auto` 不止做一次选路；主路径一旦确定，就按需要继续执行后续阶段，默认持续推进直到完成交付，只有命中 HelloAGENTS 阻塞判定时才停下。
 
 ## 铁律
@@ -35,8 +35,7 @@ Trigger: ~auto <任务描述>
 - 先按当前上下文里已注入的“选路与分层”语义约束判断，不依赖关键词命中做机械分流
 - 若当前上下文没有足够的注入约束，再结合以下信号补足判断：影响范围、风险等级、是否需要结构化产物、是否已有活跃方案包、用户是否只想先比较方向
 - 选路优先级：
-  - 纯探索 / 点子 / 方向比较 → `~idea`
-  - 值得做与否 / 范围收缩 / 先做多大仍不清楚 → `~office`
+  - 方向不明 / 价值与范围仍不清楚 / 点子与方向比较 → `~ask`
   - 明确要求质量审查 / 验真 / 跑检查 / 收尾 → `~qa`
   - 0 到 1 / 产品级 / 多维规格 → `~prd`
   - 多文件功能 / 架构变更 / 新项目规划 → `~plan`
@@ -44,15 +43,14 @@ Trigger: ~auto <任务描述>
 
 ### 2. 按 Tier 校正
 
-- `T0` → 在 `~idea` / `~office` 之间选择，不创建项目文件
+- `T0` → 走 `~ask`，不创建项目文件
 - `T1` → 在 `~build` / `~qa` 间选择最短可交付路径
 - `T2` → 需要结构化产物或范围未完全明确时优先 `~plan`
 - `T3` → 纯质量审查/验真走 `~qa`；其余默认 `~plan` 或 `~prd`，待方案与风险边界明确后再进入实现
 
 ### 3. 读取对应命令并执行主路径
 
-- 选中 `idea` → 读取 `skills/commands/idea/SKILL.md`
-- 选中 `office` → 读取 `skills/commands/office/SKILL.md`
+- 选中 `ask` → 读取 `skills/commands/ask/SKILL.md`
 - 选中 `plan` → 读取 `skills/commands/plan/SKILL.md`
 - 选中 `build` → 读取 `skills/commands/build/SKILL.md`
 - 选中 `qa` → 读取 `skills/commands/qa/SKILL.md`
@@ -66,8 +64,7 @@ Trigger: ~auto <任务描述>
 - 若主路径是 `~plan` → 方案包写入后，若当前任务来自 `~auto` 且未命中阻塞判定，直接继续进入 `~build`，不要把“方案已形成”当作最终停点
 - 若主路径是 `~prd` → PRD / 任务 / 契约写入后，若当前任务来自 `~auto` 且未命中阻塞判定，按当前结果继续进入 `~build`，必要时先补一轮轻量 `~plan`
 - 若主路径是 `~qa` → 完成质量闭环 / 收尾后结束
-- 若主路径是 `~idea`，且用户本意就是探索/比较，则在探索输出后结束；若探索后已有明确方向且当前任务仍要求写文件或改代码，则继续进入 `~plan` 或 `~build`
-- 若主路径是 `~office`，且用户本意就是先做价值/范围判断，则在评估输出后结束；若评估结论已经明确需要结构化方案或直接实现，则继续进入 `~plan` / `~build`
+- 若主路径是 `~ask`，且用户本意就是探索/厘清，则在交互澄清输出后结束；若澄清后已有明确方向且当前任务仍要求写文件或改代码，则继续进入 `~plan` 或 `~build`
 - 若 Codex active goal 的目标已满足 → 仍先完成 `~qa` 与 HelloAGENTS 收尾，再标记 goal complete；未满足时继续下一项可执行 AFK 任务
 
 ### 5. 何时允许停下

package/skills/commands/build/SKILL.md

@@ -40,8 +40,11 @@ Trigger: ~build [description]
 
 ### 2. 需求与范围确认
 
-- 若用户提供的是明确执行任务，直接确认范围
-- 若当前活跃方案包已能覆盖需求，按方案执行
+先判断任务是否有方案包支撑：
+
+- 有活跃方案包 → 按方案包执行，直接确认范围
+- 无方案包 + 任务可判定为 T1（如"加个 loading 动画"、"修个 typo"）→ 直接执行
+- 无方案包 + 任务 T2+（多文件功能、架构变更、新模块）→ 不直接写代码，自动重定向到 `~plan`，先厘清需求再执行。方向完全不明时由 ~plan 内部走交互澄清确认
 - 若仍存在真实歧义，仅询问阻塞执行的关键决策
 
 ### 3. 执行实现

package/skills/commands/help/SKILL.md

@@ -11,8 +11,7 @@ Trigger: ~help
 ### 可用命令
 | 命令 | 说明 |
 |------|------|
-| ~idea | 轻量点子探索与方向比较 |
-| ~office | 价值与范围评估：先判断该不该做、该做多大、先做哪一小块 |
+| ~ask | 交互式需求澄清：一问一答厘清目标、方向、范围与约束；不写文件 |
 | ~auto | 自动执行：自动选主路径并持续推进到实现 / 质量闭环 / 收尾，除非命中真实阻塞 |
 | ~plan | 结构化规划：需求澄清 + 方案确认 + 方案包 |
 | ~build | 执行实现：按需求或方案包完成实现与局部验证 |
@@ -29,6 +28,7 @@ Trigger: ~help
 - `~do` → 等同 `~build`
 - `~design` → 等同 `~plan`
 - `~review` → 等同 `~qa`
+- `~idea` → 等同 `~ask`（逐步废弃）
 
 核心规则默认生效：HelloAGENTS 会通过 `bootstrap.md` / `bootstrap-lite.md` 在运行时持续执行方案纠偏与语言纪律；这不是新增命令，也不是新增技能计数。
 

package/skills/commands/plan/SKILL.md

@@ -33,18 +33,15 @@ Trigger: ~plan [description]
 
 目标：通过自然对话明确目的、约束、成功标准与验收边界。
 
-根据项目类型选择模式：
+默认使用交互澄清，一问一答逐条确认：
 
-**假设模式**（已有代码库，优先使用）：
-- 先读取 5-15 个相关文件，基于代码证据形成假设
-- 用 2-4 轮确认关键假设
-- 低置信度假设必须明确询问
+- 每次只问一个问题，优先使用选择题；选项使用数字编号，用户回复数字即可选择
+- 每个问题给出推荐选项和理由；格式遵循全局「选择确认」规则
+- 只确认真正影响执行路径的关键决策
+- 已有代码库时，先静默读 5-15 个相关文件，基于代码证据形成假设，再以选择题形式逐条确认
 - 发现用户用词与 `.helloagents/context.md` 的领域语言冲突时，立即澄清并统一术语
 
-**交互模式**（全新项目或信息不足）：
-- 每次只问一个问题，优先使用选择题
-- 只确认真正影响执行路径的关键决策
-- 每个问题给出推荐选项和理由
+**快速通道**：用户明确说"直接做，不用问我"、"按默认来"时，跳过逐条交互，基于代码证据直接形成方案。低置信度假设仍必须明确询问。
 
 涉及视觉/交互/体验的问题时：
 - 选项必须体现当前前沿水准
@@ -55,7 +52,7 @@ Trigger: ~plan [description]
 基于已确认需求，给出 2-3 个可行方案：
 - 每个方案说明架构思路与关键取舍
 - 标注推荐方案及理由
-- 让用户选择或修正
+- 方案使用数字编号，用户回复数字即可选择；格式遵循全局「选择确认」规则
 
 涉及 UI 的方案：
 - 读取 `hello-ui` SKILL.md

package/skills/commands/prd/SKILL.md

@@ -65,28 +65,28 @@ Trigger: ~prd [description]
 全新项目（无 .helloagents/ 目录）：
 - 跳过，直接进入项目定位
 
-### 2. 项目定位（快速，1-2 轮）
+### 2. 项目定位（交互澄清，与 ~ask 一致）
 
-目标：快速锁定项目类型和 PRD 范围。
+目标：通过一问一答锁定项目类型和 PRD 范围。
 
-a. 理解用户的初始描述
-b. 确认项目类型（Web App / Mobile / API / CLI / Library / 桌面 / 游戏 / 混合）
-c. 根据维度激活矩阵，列出本项目的必选/推荐/可选维度
-d. 询问用户：推荐维度是否需要？可选维度是否需要？
-e. 确定最终的维度列表
+- 每次只问一个问题，带推荐选项；选项使用数字编号，用户回复数字即可选择；格式遵循全局「选择确认」规则
+- 先确认项目类型（Web App / Mobile / API / CLI / Library / 桌面 / 游戏 / 混合）
+- 根据维度激活矩阵，逐条确认：必选维度直接纳入，推荐和可选维度逐个询问是否需要
+- 用户说"默认" → 按矩阵推荐纳入；说"跳过" → 不纳入；说"展开" → 深入讨论
 
 ### 3. 维度探索（头脑风暴，核心阶段）
 
-按维度编号顺序，逐个展开讨论。每个维度的交互模式：
+按维度编号顺序，逐个展开讨论。每个维度采用交互澄清：
 
-a. AI 先给出该维度的行业最佳实践参考和推荐方案
-b. 用户确认/修改/补充
-c. AI 总结该维度的决策结果，进入下一个维度
+a. 你根据该维度先提第一个问题，带推荐选项和理由
+b. 用户确认/修改/跳过
+c. 继续该维度内的下一个问题，直到关键决策全部明确
+d. 总结该维度的决策结果，进入下一个维度
 
 交互原则：
-- 每个维度内，每次只问一个问题，偏好选择题
+- 每个维度内，每次只问一个问题，偏好选择题；选项使用数字编号，用户回复数字即可选择
 - 用户说"跳过" → 跳过该维度，不生成对应文件
-- 用户说"默认" → AI 按推荐方案填充，快速过
+- 用户说"默认" → 你按推荐方案快速填充，不逐条询问
 - 用户说"展开" → 深入讨论该维度的子项
 - 维度之间可以回溯：用户说"回到 03" → 重新讨论 UI/UX 设计
 - 涉及项目特有概念时，确认标准术语、避免用语和关键关系；不要把泛化技术词写入领域语言
@@ -102,7 +102,7 @@ c. AI 总结该维度的决策结果，进入下一个维度
 - 按当前已加载的 HelloAGENTS 规则建立 `.helloagents/` 与最小流程状态；这是方案包写入的前置操作，不受 kb_create_mode 开关控制
 - 创建 `.helloagents/plans/YYYYMMDDHHMM_{feature}/prd/`（按当前项目存储模式解析）
 - 按 templates/plans/prd/ 的模板格式，仅写入用户未跳过的维度文件
-- 生成 tasks.md（每个任务默认是端到端垂直切片，标注 AFK / HITL、依赖、具体文件路径、预期变更、完成标准与验证方式；任务独立可验证）
+- 生成 tasks.md（每个任务默认是端到端垂直切片，标注 AFK / HITL、依赖、具体文件路径、预期变更、完成标准与验证方式；任务可独立验证）
 - 在 `tasks.md` 中保留 “Codex /goal 执行入口”，让 Codex 按 `/goal -> ~auto -> ~qa` 执行已拆分任务、验收边界和 `contract.json`；不要把完整 PRD 原文直接当作 `/goal` 目标
 - 生成 decisions.md（贯穿全程的决策日志）
 - 生成 `contract.json`（至少包含 `qaMode`、`qaFocus`；涉及 UI 时补 `ui.required`、`ui.designContract`、`ui.sourcePriority`；仅在确需先明确审美方向时再补 `ui.styleAdvisor.required`、`ui.styleAdvisor.reason`、`ui.styleAdvisor.focus`；仅在确需视觉验收时再补 `ui.visualValidation.required`、`ui.visualValidation.reason`、`ui.visualValidation.screens`、`ui.visualValidation.states`；仅在确需独立 advisor 时，再补 `advisor.required`、`advisor.reason`、`advisor.focus`、`advisor.preferredSources`）

package/skills/helloagents/SKILL.md

@@ -52,7 +52,7 @@ description: 按任务类型适用 — 建立质量驱动工作流，通过技
 禁止行为：
 - 禁止在选路分层、目标澄清阶段读取实现类技能（hello-ui/hello-test/qa-review 等）
 - 禁止因为"可能用到"就提前读取技能文件——等到真正需要时再读
-- 同一会话内，同一路径的配置文件、模块、SKILL、模板只读一次并跨轮复用；缺少所需内容、读取失败、用户要求刷新或本次修改后才重新读取
+- 同一会话内，同一路径的配置文件、模块、`SKILL`、模板只读一次并跨轮复用；缺少所需内容、读取失败、用户要求刷新或本次修改后才重新读取
 - ~command 命令只读取对应的 command SKILL.md，不连带读取其他技能
 
 ## 技能查找路径
@@ -102,8 +102,7 @@ description: 按任务类型适用 — 建立质量驱动工作流，通过技
 
 用户使用 `~command` 时，只读取对应的 command skill，路径按上方“~command 命令技能”规则查找：
 - `~auto`
-- `~idea`
-- `~office`
+- `~ask`
 - `~plan`
 - `~build`
 - `~prd`
@@ -119,5 +118,6 @@ description: 按任务类型适用 — 建立质量驱动工作流，通过技
 - `~do` → 直接按 `~build` 的 command skill 路径读取并执行
 - `~design` → 直接按 `~plan` 的 command skill 路径读取并执行
 - `~review` → 直接按 `~qa` 的 command skill 路径读取并执行
+- `~idea` → 直接按 `~ask` 的 command skill 路径读取并执行（逐步废弃）
 
 只有当对应 command skill 明确要求再读取 hello-* 技能时，才按上方“hello-* 技能”规则继续读取。

package/skills/qa-review/SKILL.md

@@ -51,6 +51,15 @@ description: 统一质量审查、命令验证、阻断修复与交付前质量
 
 不要只给泛泛评价。
 
+## 任务完成标准逐条核对
+
+若存在方案包且 `tasks.md` 中有任务清单，必须逐条核对：
+
+- 对每个已标记完成的任务，逐条对照其"完成标准"验证是否真实满足
+- 完成标准必须是可独立验证的布尔条件——如果读完标准仍需要额外上下文才能判断，则该标准本身不合格，标记为 [-] 并写明原因
+- 验证不依赖主会话上下文：任何人（或另一个 AI）读完标准 + 当前代码状态，应能做出相同的通过/不通过判定
+- 核对结果写入 `artifacts/qa-review.json` 的 `taskVerification` 字段
+
 ## 验证命令
 
 验证命令来源：

package/templates/plans/tasks.md

@@ -6,9 +6,9 @@
 - 厚任务必须继续拆小；横向前置任务只在确有技术依赖时保留。
 
 ## 任务列表
-[按执行顺序排列，每个任务独立可验证]
-- [ ] 任务1（AFK/HITL）：端到端行为描述（依赖：无；涉及文件：path/to/file.ts；预期变更：...；完成标准：功能行为或验收结果；验证方式：npm run test -- feature）
-- [ ] 任务2（AFK/HITL）：端到端行为描述（依赖：任务1；涉及文件：...；预期变更：...；完成标准：...；验证方式：...）
+[按执行顺序排列，每个任务可独立验证]
+- [ ] 任务1（AFK/HITL）：端到端行为描述（依赖：无；涉及文件：path/to/file.ts；预期变更：...；完成标准：可独立验证的布尔条件——任何人读完就能判断任务是否完成，用 Given-When-Then 或等价形式，不写"功能正常""符合预期"等无法独立判断的表述；验证方式：具体命令或可执行步骤）
+- [ ] 任务2（AFK/HITL）：端到端行为描述（依赖：任务1；涉及文件：...；预期变更：...；完成标准：同上的可独立验证格式；验证方式：...）
 - [ ] 任务3（AFK/HITL）：端到端行为描述（依赖：...；涉及文件：...；预期变更：...；完成标准：...；验证方式：...）
 
 ## Codex /goal 执行入口

package/skills/commands/idea/SKILL.md

@@ -1,56 +0,0 @@
----
-name: ~idea
-description: 轻量点子探索与方向发散（~idea 命令）
-policy:
-  allow_implicit_invocation: false
----
-Trigger: ~idea [description]
-
-`~idea` 是轻量探索命令，用于在不写文件、不进入执行、不激活完整项目流程的前提下，帮用户快速比较方向、生成点子、明确方案。
-
-## 铁律
-- 只讨论，不编写实现代码，不创建项目文件，不执行实现操作
-- 不创建 `.helloagents/`
-- 不创建或更新当前项目存储中的 `state_path`；同样禁止更新知识库文件、方案包或项目级规则文件
-- 不生成方案包
-- 不执行会改变工作区或外部状态的命令
-- 不默认使用子代理
-- 输出的重点是方向、差异、推荐理由与下一步可升级路径
-
-## 流程
-
-### 1. 快速理解问题
-
-- 理解用户当前要解决的目标、场景、限制与关注点
-- 若任务是已有项目中的连续工作，可按需读取少量相关上下文；不要为了脑暴而展开完整项目流程
-
-### 2. 生成备选方向
-
-- 提供 2-4 个可行方向
-- 每个方向都给出：
-  - 核心思路
-  - 适用场景
-  - 主要优点
-  - 主要代价或风险
-
-### 3. 给出推荐
-
-- 明确推荐一个最优方向
-- 解释推荐理由，不使用空泛形容词
-- 若涉及视觉/交互，选项必须具体到可执行特征
-
-### 4. 给出升级路径
-
-- 如果用户希望继续推进，实现层升级路径为：
-  - 想先判断值不值得做、要不要做这么大 → `~office`
-  - 想形成结构化方案 → `~plan`
-  - 想直接进入实现 → `~build`
-  - 需要重型产品规格 → `~prd`
-  - 想让 AI 自动执行完整流程 → `~auto`
-- 如果用户在 `~idea` 过程中转而明确要求写文件、改代码、创建知识库或执行命令，不在 `~idea` 内偷偷写文件；改为按最合适的升级路径继续
-
-## 输出要求
-
-- 允许发散，但必须给出明确结论
-- 不做“点子堆砌”
-- 不把尚未决定的探索结果伪装成已确认方案

package/skills/commands/office/SKILL.md

@@ -1,86 +0,0 @@
----
-name: ~office
-description: 价值与范围评估命令 — 先判断事情该不该做、该做多大、先做哪一小块（~office 命令）
-policy:
-  allow_implicit_invocation: false
----
-Trigger: ~office [description]
-
-`~office` 是范围收缩命令，用于在不写文件、不进入实现、不激活完整项目流程的前提下，先帮用户判断一件事是否值得做、是否做得过大、最小可验证切口应该落在哪里。
-
-## 铁律
-- 只讨论，不编写实现代码，不创建项目文件，不执行实现操作
-- 不创建 `.helloagents/`
-- 不创建或更新当前项目存储中的 `state_path`；同样禁止更新知识库文件、方案包或项目级规则文件
-- 不生成方案包
-- 不执行会改变工作区或外部状态的命令
-- 不默认使用子代理
-- 输出重点不是“还能做什么”，而是“要不要做、该做多大、先做哪块”
-
-## 流程
-
-### 1. 快速锁定待判断事项
-
-- 先用一句话重述当前用户真正想判断的事情
-- 明确判断目标：是评估“值不值得做”、还是评估“要不要现在做”、还是评估“要不要做这么大”
-- 若任务是已有项目中的连续工作，可按需读取少量相关上下文；不要为了做 office 评估而展开完整项目流程
-
-### 2. 从关键维度拷问
-
-- 只选当前最相关的 3-5 个维度，不机械全问
-- 可用维度包括：
-  - 真实需求是否存在
-  - 当前替代方案/现状是什么
-  - 最痛的人是谁，痛到什么程度
-  - 最小可验证切口是什么
-  - 当前最大假设是什么
-  - 现在做和以后做的时机差异是什么
-  - 做大后的主要成本、风险或返工点是什么
-- 问题必须直指判断，不做泛化 brainstorm
-
-### 3. 挑战前提
-
-- 明确指出 1-3 条最值得怀疑的前提
-- 每条前提都说明：
-  - 它为什么可疑
-  - 如果这条前提不成立，会导致什么
-  - 最省成本的验证方式是什么
-
-### 4. 强制给出不同范围方案
-
-- 至少给出 3 档范围：
-  - 不做 / 暂缓
-  - 最小切口
-  - 标准推进
-- 如确有必要，可再补一个“做大方案”，但不默认鼓励
-- 每档都给出：
-  - 核心动作
-  - 主要收益
-  - 主要代价或风险
-  - 适用前提
-
-### 5. 给出明确判断
-
-- 必须明确落到以下结论之一：
-  - 不建议做
-  - 建议先验证，不建议直接做
-  - 值得做，但先做最小切口
-  - 值得按当前范围推进
-- 解释理由，不使用空泛形容词
-
-### 6. 给出升级路径
-
-- 如果用户希望继续推进，实现层升级路径为：
-  - 想比较几个做法方向 → `~idea`
-  - 想形成结构化方案 → `~plan`
-  - 想直接进入实现 → `~build`
-  - 需要重型产品规格 → `~prd`
-  - 想让 AI 自动执行完整流程 → `~auto`
-- 如果用户在 `~office` 过程中转而明确要求写文件、改代码、创建知识库或执行命令，不在 `~office` 内偷偷写文件；改为按最合适的升级路径继续
-
-## 输出要求
-
-- 必须先给结论，再给判断依据
-- 不做“点子堆砌”
-- 不把尚未验证的假设伪装成事实
-- 不把“可以做很大”默认当成推荐答案