helloagents 3.1.1 → 3.1.2

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.1.1",
+  "version": "3.1.2",
   "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.1",
+  "version": "3.1.2",
   "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.1-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.1.2-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)
@@ -110,6 +110,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 |
 | `~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 |
@@ -128,6 +129,8 @@ Compatibility aliases:
 - `~design` → `~plan`
 - `~review` → `~qa`
 
+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.
+
 ### 3) Project knowledge base
 
 HelloAGENTS can create and maintain a project knowledge base under `.helloagents/`.
@@ -472,6 +475,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?"` |
 | 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"` |

package/README_CN.md

@@ -8,7 +8,7 @@
 
 **面向 AI 编码 CLI 的工作流层：技能、知识库、交付检查、更安全的配置写入，以及可恢复的执行流程。**
 
-[![Version](https://img.shields.io/badge/version-3.1.1-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.1.2-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)
@@ -110,6 +110,7 @@ HelloAGENTS 内置 14 个技能。技能只在当前阶段需要时读取，因
 | 命令 | 用途 |
 |------|------|
 | `~idea` | 轻量探索和方向比较；不写文件 |
+| `~office` | 价值与范围评估；先判断该不该做、该做多大、先做哪一小块 |
 | `~auto` | 自动选择主路径，并持续推进到交付或真实阻塞 |
 | `~plan` | 需求、方案、任务拆分和方案包 |
 | `~build` | 按当前请求或现有方案实现 |
@@ -128,6 +129,8 @@ HelloAGENTS 内置 14 个技能。技能只在当前阶段需要时读取，因
 - `~design` → `~plan`
 - `~review` → `~qa`
 
+`~idea` 适合比较几种方向；`~office` 适合先判断这件事值不值得做、要不要做这么大，以及最小切口应该落在哪里。
+
 ### 3）项目知识库
 
 HelloAGENTS 可以在 `.helloagents/` 下创建和维护项目知识库。
@@ -472,6 +475,7 @@ Codex 全局模式由 HelloAGENTS 通过本地插件路径自动安装。
 | 目标 | 使用 |
 |------|------|
 | 写文件前先比较方案 | `~idea "compare two API designs"` |
+| 先判断值不值得做、要不要做这么大 | `~office "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"` |

package/bootstrap-lite.md

@@ -192,7 +192,7 @@
 
 ## 工作流与完成判定
 ### 任务分层（Delivery Tier）
-- `T0` — 只读分析、创意探索、方案比较 → 自然响应或 `~idea`
+- `T0` — 只读分析、创意探索、方案比较、范围评估 → 自然响应或 `~idea` / `~office`
 - `T1` — 低风险小改动、明确实现、显式质量闭环、单文件或局部改动 → 直接执行或 `~build` / `~qa`
 - `T2` — 新项目、从零构建、3+ 文件新功能、架构级变更或需要结构化产物 → `~plan` 或 `~auto`
 - `T3` — 高风险或不可逆操作（权限、安全、支付、数据库、生产发布等）→ 先 `~plan` / `~prd`，再 `~build` / `~qa`
@@ -235,7 +235,7 @@ templates/ 查找路径（按优先级；首次确定模板根目录后，本会
   - 强制创建并持续更新：`~init`、`~plan`、`~build`、`~auto`、`~prd`、`~loop`，以及任何会创建/修改本地文件、会在当前工作区留下实际输出或操作记录的非只读任务
   - 强制更新，不要求首次创建：`~clean`，主代理汇总子代理结果后
   - 已有则更新：`~qa`、`~test`、`~commit`
-  - 不创建：`~help`、`~idea`、普通问答、一次性只读任务、子代理自身执行过程、压缩/恢复钩子
+  - 不创建：`~help`、`~idea`、`~office`、普通问答、一次性只读任务、子代理自身执行过程、压缩/恢复钩子
   更新规则：
   - 属于“强制创建并持续更新”范围且状态文件不存在时，按 templates/STATE.md 创建
   - 每次更新是重写，不是追加。状态文件只记录当前状态，不记录历史

package/bootstrap.md

@@ -192,7 +192,7 @@
 
 ## 工作流与完成判定
 ### 任务分层（Delivery Tier）
-- `T0` — 只读分析、创意探索、方案比较 → 自然响应或 `~idea`
+- `T0` — 只读分析、创意探索、方案比较、范围评估 → 自然响应或 `~idea` / `~office`
 - `T1` — 低风险小改动、明确实现、显式质量闭环、单文件或局部改动 → 直接执行或 `~build` / `~qa`
 - `T2` — 新项目、从零构建、3+ 文件新功能、架构级变更或需要结构化产物 → `~plan` 或 `~auto`
 - `T3` — 高风险或不可逆操作（权限、安全、支付、数据库、生产发布等）→ 先 `~plan` / `~prd`，再 `~build` / `~qa`
@@ -202,6 +202,7 @@
 #### 1. ROUTE / TIER — 路由与分层
 先判断任务类型、风险等级、是否需要结构化产物，再决定进入哪条路径：
 - 创意探索 / 方案比较 → `~idea`
+- 值得做与否 / 范围收缩 / 先做多大 → `~office`
 - 明确实现 / 小范围修复 → `~build`
 - 为指定模块编写测试 → `~test`
 - 结构化规划 / 新功能 / 新项目 → `~plan`
@@ -217,7 +218,7 @@
 - 约束：平台、技术、风险、时间、现有架构
 - 成功标准：做到什么程度算完成
 
-`~idea` / `~plan` / `~prd` 在此阶段展开探索或需求澄清；`~build` 在需求明确时快速通过。
+`~idea` / `~office` / `~plan` / `~prd` 在此阶段展开探索或需求澄清；`~build` 在需求明确时快速通过。
 
 #### 3. PLAN — 规划与上下文准备
 根据 skills/ 目录下各 hello-* 技能的 SKILL.md frontmatter（name + description），标记本次任务可能需要的技能（不读取文件内容，仅记录名称）。
@@ -239,6 +240,7 @@ hello-* 技能读取路径：`{HELLOAGENTS_READ_ROOT}/skills/{技能名}/SKILL.m
 - `contract.json` 是方案包的机器契约，至少明确 `qaMode`、`qaFocus`；只有在 T3 / UI / 高风险流程确有收益时，才额外声明 `advisor`；进入质量闭环或最终交付前，优先消费它而不是从自然语言描述里回推执行路径
 - 涉及 UI 时，设计约束优先级固定为：当前 `plan.md` / PRD UI 决策 → 逻辑 `.helloagents/DESIGN.md`（实际路径按当前项目存储模式解析） → 已读取的 `hello-ui` 规则；同时所有 UI 任务都必须满足 UI 质量基线
 - `~idea` 在输出比较与推荐后结束，不进入实现，也不创建 `.helloagents/`、状态文件或方案包
+- `~office` 在输出价值/范围判断后结束，不进入实现，也不创建 `.helloagents/`、状态文件或方案包
 
 #### 4. BUILD — 实现
 进入实现时，读取 PLAN 阶段标记的技能 SKILL.md（按上方 hello-* 技能查找路径读取 `skills/{技能名}/SKILL.md`），按其规范执行。

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.1.1",
+  "version": "3.1.2",
   "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.1",
+  "version": "3.1.2",
   "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/guard.mjs

@@ -88,7 +88,7 @@ function buildHighRiskGate(matches, cwd, payload = {}) {
 }
 
 function buildIdeaBoundaryReason(kind) {
-  return `[HelloAGENTS Guard] 已阻止 ~idea 中的${kind}。\n当前路由：~idea 是只读探索；先停留在比较方案。若要写文件、改代码、创建知识库或执行有副作用的命令，请先升级到 ~plan / ~build / ~prd / ~auto。`
+  return `[HelloAGENTS Guard] 已阻止只读探索命令中的${kind}。\n当前路由：~idea / ~office 都是只读探索；先停留在比较或范围判断。若要写文件、改代码、创建知识库或执行有副作用的命令，请先升级到 ~plan / ~build / ~prd / ~auto。`
 }
 
 function detectIdeaBoundaryContext(data) {
@@ -116,7 +116,7 @@ function emitIdeaBoundaryBlock(data, kind, target) {
     {
       command: kind === '有副作用命令' ? target.replace(/^命令：\s*/, '') : '',
       target: kind === '写入操作' ? target.replace(/^目标：\s*/, '') : '',
-      guardType: kind === '写入操作' ? 'idea-write-boundary' : 'idea-command-boundary',
+      guardType: kind === '写入操作' ? 'readonly-write-boundary' : 'readonly-command-boundary',
     },
     data,
   )
@@ -133,7 +133,7 @@ function buildPostWriteWarnings(data) {
   const filePath = data.tool_input?.file_path || ''
   return [
     ...(detectIdeaBoundaryContext(data)?.zeroSideEffect
-      ? ['~idea 当前任务要求只读探索；检测到写入文件的工具调用，请回到探索输出，或升级到 ~plan / ~build / ~prd / ~auto 后再修改文件']
+      ? ['~idea / ~office 当前任务要求只读探索；检测到写入文件的工具调用，请回到探索输出，或升级到 ~plan / ~build / ~prd / ~auto 后再修改文件']
       : []),
     ...scanUnrequestedFiles(filePath, data.tool_name),
     ...(content ? [...scanForSecrets(content), ...scanDangerousPackages(content, filePath)] : []),

package/scripts/notify-context.mjs

@@ -165,7 +165,7 @@ export function buildSemanticRouteInstruction(cwd, payload = {}) {
     '请根据用户请求的真实意图选路，不依赖关键词表。',
     buildDelegatedTaskHint(),
     'Delivery Tier: T0=探索/比较；T1=低风险小改动或显式验证；T2=多文件功能/新项目/需要结构化产物；T3=高风险或不可逆操作。',
-    '路由映射：~idea=只读探索，不创建文件；~build=明确实现；~qa=统一质量审查/验证/修复/收尾；~plan=结构化规划；~prd=重型规格；~auto=自动选择并继续执行后续阶段。',
+    '路由映射：~idea=只读探索与方向比较，不创建文件；~office=只读价值/范围评估，不创建文件；~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 !== 'help'
+  const shouldEnsureProjectLocal = skillName !== 'idea' && skillName !== 'office' && skillName !== 'help'
   const scope = getRuntimeScope(cwd, { payload, env, ppid, ensureProjectLocal: shouldEnsureProjectLocal })
   const context = {
     cwd: normalizePath(cwd),
     skillName,
     sourceSkillName,
-    zeroSideEffect: skillName === 'idea',
+    zeroSideEffect: skillName === 'idea' || skillName === 'office',
     identity: extractPayloadIdentity(payload),
     source: routeSource(payload),
     promptHash: hashPrompt(payload.prompt),

package/skills/commands/auto/SKILL.md

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

package/skills/commands/help/SKILL.md

@@ -12,6 +12,7 @@ Trigger: ~help
 | 命令 | 说明 |
 |------|------|
 | ~idea | 轻量点子探索与方向比较 |
+| ~office | 价值与范围评估：先判断该不该做、该做多大、先做哪一小块 |
 | ~auto | 自动执行：自动选主路径并持续推进到实现 / 质量闭环 / 收尾，除非命中真实阻塞 |
 | ~plan | 结构化规划：需求澄清 + 方案确认 + 方案包 |
 | ~build | 执行实现：按需求或方案包完成实现与局部验证 |

package/skills/commands/idea/SKILL.md

@@ -42,6 +42,7 @@ Trigger: ~idea [description]
 ### 4. 给出升级路径
 
 - 如果用户希望继续推进，实现层升级路径为：
+  - 想先判断值不值得做、要不要做这么大 → `~office`
   - 想形成结构化方案 → `~plan`
   - 想直接进入实现 → `~build`
   - 需要重型产品规格 → `~prd`

package/skills/commands/office/SKILL.md

@@ -0,0 +1,86 @@
+---
+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` 内偷偷写文件；改为按最合适的升级路径继续
+
+## 输出要求
+
+- 必须先给结论，再给判断依据
+- 不做“点子堆砌”
+- 不把尚未验证的假设伪装成事实
+- 不把“可以做很大”默认当成推荐答案

package/skills/helloagents/SKILL.md

@@ -101,6 +101,7 @@ description: 按任务类型适用 — 建立质量驱动工作流，通过技
 用户使用 `~command` 时，只读取对应的 command skill，路径按上方“~command 命令技能”规则查找：
 - `~auto`
 - `~idea`
+- `~office`
 - `~plan`
 - `~build`
 - `~prd`