harnessed 3.0.3 → 3.2.0

package/README.md

@@ -21,7 +21,7 @@
 
 - **三层栈机器化** — `gstack 决策` + `GSD 项目经理` + `superpowers 资深工程师` + `karpathy 4 心法` + `mattpocock 23 招式`,5 支柱 100% capture
 - **不 vendor 上游** — manifest describe install/check;上游升级用户 re-install 即获最新版
-- **Composition Skill** — 自家 workflow skill 当指挥棒,调度多个上游协同。**4 master orchestrator + 18 sub-workflow + 2 standalone = 24 namespace-layered workflow**,完整 4-stage 机器化 (`/discuss /plan /task /verify` 4 master + 三层栈 18 sub + `/research /retro` 2 standalone)
+- **Composition Skill** — 自家 workflow skill 当指挥棒,调度多个上游协同。**1 super-master `/auto` + 4 stage master + 18 sub-workflow + 2 standalone = 25 namespace-layered workflow**,完整 4-stage 机器化 (`/auto` 跨 stage 一键 / `/discuss /plan /task /verify` 单 stage / 三层栈 18 sub / `/research /retro` 2 standalone)
 - **L0 Discipline Substrate** — 全局 cross-stage 行为基准 (karpathy 心法 + output-style + language + operational + priority + protocols),applied universally
 - **包管理器思维** — install dependency graph 自动解析, doctor 健康检查, install-base 一键装齐
 - **统一入口** — 用户面对 `/discuss /plan /task /verify` 等 master slash command,不需学每家上游术语;sub command 显式调用单 stage (例如 `/discuss-strategic` 只跑战略层澄清)
@@ -40,6 +40,45 @@ npm install -g harnessed && harnessed setup
 
 ---
 
+## 🚀 快捷使用 — 3 种选择
+
+按介入程度由低到高:
+
+### 🎯 整体自动 (推荐新手 / 不想动脑子)
+
+```
+/auto "需求 X"
+
+# 大需求可显式分阶段 (一般 AI 自动判断;若自认大需求可强制):
+/auto "需求 X" --staged
+```
+
+> 不想动脑子或者刚入门 — 一切交给 harnessed。自动跑完 6 stage (research conditional → discuss → plan → task → verify → retro mandatory),中间不停。v3.2.0 NEW:AI 1-shot 自动判断需求复杂度,大需求建议切 `--staged` 模式 (每 stage 完停 review);开始前 prompt "对需求清晰认知吗?" n → 自动加跑 `/research` 多源调研;末尾 `/retro` 强制总结。失败 fail-fast,`harnessed resume` 续。`--pause-between-stages` 保留为 backward-compat alias。
+
+### 📂 分类自动 (推荐熟手 / 想 review 中间结果)
+
+```
+/discuss "需求 X"          # 战略 + Phase + 子任务 3 层澄清
+/plan "需求 X"             # 架构 (conditional) + 计划持久化
+/task "subtask-1"          # 4 sub 串行 (clarify → code → test → deliver)
+/verify "phase-1"          # 7 sub conditional 验证
+```
+
+> 想自己决定从哪个 stage 开始 / review 中间产出 — 4 个 master 独立调用,每个 master 内部仍自动 fan-out 该 stage 所有 sub。
+
+### 🔬 精确调用 (大神 mode / 知道自己要什么)
+
+```
+/discuss-phase "..."        # 单跑 Phase 层澄清
+/plan-architecture "..."    # 单跑架构审查
+/verify-paranoid "..."      # 单跑 Paranoid Staff Engineer 审查
+# ... 其他 18 个 sub-workflow 任选
+```
+
+> "我是大神,我自己决定" — 跳过 master,直接调某 sub-workflow。适合已知精确需要哪个 sub 的高级用户 / 复用某单一环节。
+
+---
+
 ## 📐 4-stage 流程图
 
 ```mermaid
@@ -87,14 +126,15 @@ graph TD
 
 > 虚框 = 可选 standalone (`/research` 战略前调研 / `/retro` 里程碑后总结);实框 = 主流程 4-stage cadence。
 
-### 24 workflow 总览表
+### 25 workflow 总览表
 
 | Slash cmd | Stage | Type | Capability / Upstream | Brief |
 |-----------|-------|------|----------------------|-------|
+| `/auto` | All | **Super-master** | masterOrchestrator (跨 6 stage) | 一键自动跑 6 stage (research conditional → discuss → plan → task → verify → retro mandatory); v3.2.0 NEW:AI 复杂度 1-shot judge + 理解度 check + retro mandatory; `--staged` (primary, alias `--pause-between-stages` backward-compat) opt-in |
 | `/discuss` | ① Discuss | Master | masterOrchestrator | 3 sub 并行 gate-eval (chain-isolation 铁律) |
-| `/discuss-strategic` | ① Discuss | Sub | gstack `/office-hours` + `/plan-ceo-review` | 战略层 — 新功能 / 新 milestone / 产品方向强制治理 |
-| `/discuss-phase` | ① Discuss | Sub | GSD `/gsd-discuss-phase` | Phase 层 — ≥2 open decisions / 灰色地带澄清 |
-| `/discuss-subtask` | ① Discuss | Sub | superpowers brainstorming + `/grill-with-docs` | 子任务层 — ≥2 approach / 核心算法 / API contract |
+| `/discuss-strategic` | ① Discuss | Sub | gstack `/office-hours` + `/plan-ceo-review` + planning-with-files | 战略层 — 新功能 / 新 milestone / 产品方向强制治理 (findings.md 持久化) |
+| `/discuss-phase` | ① Discuss | Sub | GSD `/gsd-discuss-phase` + planning-with-files | Phase 层 — ≥2 open decisions / 灰色地带澄清 (findings.md + knowledge.md 持久化) |
+| `/discuss-subtask` | ① Discuss | Sub | superpowers brainstorming + `/grill-with-docs` | 子任务层 — ≥2 approach / 核心算法 / API contract (ephemeral 短讨论, 不持久化) |
 | `/plan` | ② Plan | Master | masterOrchestrator | 串行 invoke 2 sub (architecture conditional → phase always) |
 | `/plan-architecture` | ② Plan | Sub | gstack `/plan-eng-review` | 架构层 — 复杂架构强制治理关卡 |
 | `/plan-phase` | ② Plan | Sub | GSD `/gsd-plan-phase` + planning-with-files `/plan` | 计划层 — 持久化 `task_plan.md` + `progress.md` |
@@ -120,40 +160,6 @@ graph TD
 
 ---
 
-## 🚩 命令一览
-
-### 主命令
-
-| 命令 | 说明 |
-| ---- | ---- |
-| `harnessed setup` | 一次性 setup,装 workflow skills 到 `~/.claude/skills/` |
-| `harnessed install <name>` | 装上游 manifest (默认 dry-run) |
-| `harnessed uninstall <name>` | 反向卸载 (默认 dry-run) |
-| `harnessed audit-log` | 路由透明日志 query (支持 `--filter` jq 表达式) |
-| `harnessed status` | 当前 phase + lock holder |
-| `harnessed resume` | session 中断后恢复至最近 checkpoint |
-| `harnessed doctor` | 8-check 健康检查 (Node / MCP / jq / Win bash / 路由 / token budget 等) |
-| `harnessed backup` | snapshot 备份管理 |
-| `harnessed rollback <timestamp>` | 一行回滚 (EOL preserve + sha1 verify) |
-| `harnessed gc` | 清理过期 backups |
-
-### 参数 (Flags)
-
-> 所有命令默认 **apply (immediate write)**,无需加 flag。高级用户可加 `--dry-run` 预览。
-
-| Flag | 说明 |
-| ---- | ---- |
-| `--dry-run` | 预览不写盘 (高级用户 opt-in) |
-| `--non-interactive` | CI / 脚本场景 |
-| `--system` | L4 全局装允许 (否则降级 L1 npx ephemeral) |
-| `--yes` | uninstall 跳过交互 confirm |
-| `--full-diff` | 展开 > 200 行的 diff 折叠 |
-| `--no-color` | 强制 nocolor (即使 TTY) |
-
-> `--apply` flag 仍保留为向后兼容 alias (no-op, 旧脚本不破)。
-
----
-
 ## ⚡ 使用流程
 
 4-stage 三层栈方法论 — 推荐 4 个 master orchestrator 串行驱动:
@@ -333,6 +339,8 @@ planning-with-files /plan (cross-cutting tool) → write artifacts to .planning/
 | 关键模块 PR | gstack /review |
 | 大重构 PR 多维度审查 | 4-specialist Agent Team Pattern C |
 | 跨 session hand-off | discipline.protocols self-contained design doc |
+| `/auto` 复杂度大需求 | AI 1-shot judge → 自动建议 `--staged` (v3.2.0 NEW;n abort 建议手动 `/discuss`) |
+| `/auto` 需求理解度 | 开始前 prompt → n 自动加 `/research` 多源调研 (v3.2.0 NEW) |
 
 ---
 
@@ -415,6 +423,42 @@ harnessed setup --apply  # 自动装齐 gstack + GSD + superpowers + planning-wi
 
 ---
 
+## 🛠️ 维护命令 (Operational)
+
+> 这些是 harnessed 自身维护命令(setup / 健康检查 / 备份回滚 / 状态恢复等),日常 feature 开发用上面的 slash command 即可,这块通常不需要。
+
+### CLI 命令
+
+| 命令 | 说明 |
+| ---- | ---- |
+| `harnessed setup` | 一次性 setup,装 workflow skills 到 `~/.claude/skills/` + MCP 到 `~/.claude.json` |
+| `harnessed resume` | session 中断后恢复至最近 checkpoint |
+| `harnessed status` | 当前 phase + lock holder |
+| `harnessed doctor` | 8-check 健康检查 (Node / MCP / jq / Win bash / 路由 / token budget 等) |
+| `harnessed install <name>` | 装上游 manifest |
+| `harnessed uninstall <name>` | 反向卸载 |
+| `harnessed backup` | snapshot 备份管理 |
+| `harnessed rollback <timestamp>` | 一行回滚 (EOL preserve + sha1 verify) |
+| `harnessed gc` | 清理过期 backups |
+| `harnessed audit-log` | 路由透明日志 query (支持 `--filter` jq 表达式) |
+
+### 参数 (Flags)
+
+> 所有命令默认 **apply (immediate write)**,无需加 flag。高级用户可加 `--dry-run` 预览。
+
+| Flag | 说明 |
+| ---- | ---- |
+| `--dry-run` | 预览不写盘 (高级用户 opt-in) |
+| `--non-interactive` | CI / 脚本场景 |
+| `--system` | L4 全局装允许 (否则降级 L1 npx ephemeral) |
+| `--yes` | uninstall 跳过交互 confirm |
+| `--full-diff` | 展开 > 200 行的 diff 折叠 |
+| `--no-color` | 强制 nocolor (即使 TTY) |
+
+> `--apply` flag 仍保留为向后兼容 alias (no-op, 旧脚本不破)。
+
+---
+
 ## License
 
 [Apache-2.0](./LICENSE) — 见 [NOTICE](./NOTICE) (含 Harness Inc. 商标 disclaimer)

package/dist/cli.mjs

@@ -847,7 +847,7 @@ var init_resume = __esm({
 
 // package.json
 var package_default = {
-  version: "3.0.3"};
+  version: "3.2.0"};
 
 // src/manifest/errors.ts
 function instancePathToKeyPath(instancePath) {
@@ -4812,7 +4812,8 @@ function registerRollback(program2) {
 }
 init_checkAgentTeams();
 var FLAT_LEGACY_DEPRECATED = /* @__PURE__ */ new Set(["plan-feature", "execute-task", "verify-work"]);
-var FLAT_LEGACY_KEEP = /* @__PURE__ */ new Set(["research", "retro"]);
+var FLAT_LEGACY_KEEP = /* @__PURE__ */ new Set(["research", "retro", "auto"]);
+var FLAT_TOP_LEVEL_MASTERS = /* @__PURE__ */ new Set(["auto"]);
 var NON_WORKFLOW_DIRS = /* @__PURE__ */ new Set(["disciplines", "judgments"]);
 async function scanWorkflowsNested(workflowsDir, entries) {
   const workflows = [];
@@ -4840,7 +4841,7 @@ async function scanWorkflowsNested(workflowsDir, entries) {
         continue;
       }
       if (FLAT_LEGACY_KEEP.has(entry)) {
-        workflows.push({ name: entry, relPath: entry, isMaster: false });
+        workflows.push({ name: entry, relPath: entry, isMaster: FLAT_TOP_LEVEL_MASTERS.has(entry) });
         continue;
       }
       workflows.push({ name: entry, relPath: entry, isMaster: false });