peaks-loop 4.0.0-beta.3 → 4.0.0-beta.31

package/skills/peaks-code/test-prompts.json

@@ -0,0 +1,12 @@
+[
+  {
+    "id": 1,
+    "prompt": "/peaks-code https://example.feishu.cn/wiki/PRODUCT_DOC_ID 是产品文档。请根据这份产品文档，对 /Users/yuanyuan/Desktop/work/platform-rag-web 这个前端项目进行迭代开发。目前只是前端项目，没有后端 swagger.json，可以先 mock，等后面有真实 swagger.json 数据时再联调替换。允许修改目标仓代码，这是实战测试。",
+    "expected": "peaks-code 选择 full-auto/实战路径，使用本仓 skills 目录下的 peaks-prd/rd/ui/qa/sc/txt，Feishu 走 headed gstack/browse/dist/browse 可见浏览器登录 handoff，先校验 https 和批准的 Feishu/Lark tenant 域名，生成 .peaks/_runtime/<session-id>/prd|rd|qa|txt 脱敏中间产物；RD 完成实现、单测、CR、安全检查、dry-run 后必须进入 QA；前端 RD 自测和 QA 验证都必须使用 headed gstack/browse/dist/browse 有头浏览器端到端验证并确认可见浏览器；QA 完成 API/mock 验证、浏览器 E2E、报告、安全和性能检查。若 QA 报告存在失败、阻塞、缺失或未验证项，必须回到 RD 修复并再次 QA，直到 QA 全部通过或生成 blocked handoff；full-auto 可用 Claude Code goal 维持 RD fixes until QA passes all acceptance items 的控制目标；不得保留登录 URL、cookie、headers、tokens、storage state、browser traces、raw browser/network state 或 PII/SSO/MFA 截图/日志。"
+  },
+  {
+    "id": 2,
+    "prompt": "/peaks-code 对 /Users/yuanyuan/Desktop/work/platform-rag-web 做前端需求迭代，需求来自需要登录的 Feishu 产品文档；如果浏览器登录没打开或文档仍不可读，需要阻塞并告诉我具体要做什么，不要用 unauthenticated fetch，也不要绕过 SSO/MFA。",
+    "expected": "流程必须验证可见浏览器 handoff，不能降级到 fetch；登录或访问失败时生成 blocked PRD/TXT 胶囊，只记录脱敏状态和下一步，不保存登录 URL、cookie、headers、tokens、storage state、浏览器 traces，或包含 PII/SSO/MFA 内容的截图和日志。"
+  }
+]

package/skills/peaks-doctor/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: peaks-doctor
 description: Orchestrate peaks-loop's L3 doctor (peaks audit + peaks doctor + peaks openspec from-doctor) for project health. Use when the user asks for a project health check, doctor report, audit, or wants to convert doctor findings into OpenSpec change records. Coordinates the L2 audit framework + the L3.2 doctor + the L3.3 from-doctor proposal generator. Triggers on `/peaks-doctor`, "peaks doctor", "项目健康", "doctor report", "health check", "check the project", "audit my repo".
-internal: true
+visibility: internal
 ---
 ---
 

package/skills/peaks-ide/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: peaks-ide
 description: Orchestrate peaks-loop's IDE-aware behavior (hooks + statusline + handle) for a user's specific IDE. Detects the current state (which IDE the user is on, what peaks has already installed), plans the install / switch / status / uninstall actions, and invokes the existing peaks CLI primitives. Triggers on `/peaks-ide`, "set up peaks for my IDE", "switch peaks to Trae", "what did peaks install", "uninstall peaks hooks". Sits between the user and `peaks hooks install` / `peaks statusline install` / `peaks hook handle` — those are the CLI primitives; this skill is the user-facing surface.
-internal: true
+visibility: internal
 ---
 ---
 

package/skills/peaks-slice-decompose/SKILL.md

@@ -108,4 +108,64 @@ This skill does NOT modify source code. It documents the v2 envelope produced by
 |---|---|
 | `references/v2-schema.md` | Field-by-field table for `DecompositionResultV2`, `PassResult`, `SliceV2`, `CrossPassEdge.arbitratedBy`, `LlmArbitration`. |
 | `references/granularity-decision.md` | Decision tree for the 4 `--granularity` modes; `shouldSubdivide()` thresholds + tie-break semantics. |
-| `references/cross-pass-edge-interpretation.md` | The 4 edge kinds and how `peaks-rd` should use them for dispatch ordering; `LlmArbitration` trace reader. |
+| `references/cross-pass-edge-interpretation.md` | The 4 edge kinds and how `peaks-rd` should use them for dispatch ordering; `LlmArbitration` trace reader. |
+
+---
+
+## SC template hard rules (sediment 2026-07-09)
+
+These rules are added in response to **D-009a + D-009c** discovered while running RID 003-add-zcode-adapter. They prevent the same class of mistake from re-occurring in future SC drafts.
+
+### Rule 1 — Pre-flight: detect ESM vs CJS before writing export syntax (D-009c)
+
+Before specifying `--caller-id` / export guard syntax in any SC task, run:
+
+```bash
+head -3 package.json | grep '"type"'
+```
+
+- `"type": "module"` → ESM. Use `export const FOO = ...` for any constant that tests need to import. **Do NOT** write `if (typeof module !== 'undefined' && module.exports) { module.exports = { FOO }; }` — that pattern is CJS-only.
+- No `"type"` field (or `"type": "commonjs"`) → CJS. Use the `module.exports` guard.
+
+Why: RID-003 SC §3.5 originally specified the CJS guard for `scripts/install-skills.mjs`. The script is actually ESM (`"type": "module"`). The RD agent had to backtrack and the SC lost 5 minutes of spec clarity.
+
+### Rule 2 — Whitelist fixture sync is NOT collateral (D-009a)
+
+When a slice adds a new entry to a **whitelist fixture** (e.g. `tests/unit/ide/ide-registry.test.ts` asserting `expect(adapters).toHaveLength(7)` after adding the 8th adapter), that fixture sync is a **primary task**, not a "by the way" footnote.
+
+Mandatory structure for any slice that adds to a known set:
+
+```markdown
+### Tasks
+
+| Task | File | Change |
+|---|---|---|
+| T-1 | `src/services/ide/ide-types.ts` | Add `'zcode'` to IdeId |
+| T-2 | `src/services/ide/ide-registry.ts` | Register ZCODE_ADAPTER |
+| T-3 | `tests/unit/ide/ide-registry.test.ts` | Update whitelist: 7 → 8 adapters, add 'zcode' |
+| T-4 | `tests/unit/install-skills-script.test.ts` | Update whitelist: 5 → 6 platforms, add 'zcode' |
+```
+
+If you find a whitelist fixture during execution but didn't pre-list it as a task, treat it as a **NEW TASK** and run the SC ↔ QA repair loop, not as "necessary collateral". Pre-listing prevents surprises at Gate 1.
+
+### Rule 3 — Adapter interface optional fields (D-009b reciprocal)
+
+When extending `IdeAdapter` (or any plugin-interface in `src/services/**/ide/`), prefer **optional fields** over required fields so existing implementations don't need stub updates:
+
+```ts
+// ✅ Optional — back-compat safe
+interface IdeAdapter {
+  readonly detectCurrentModel?: () => Promise<string | undefined>;
+}
+
+// ❌ Required — every existing adapter must add a stub
+interface IdeAdapter {
+  readonly detectCurrentModel: () => Promise<string | undefined>;
+}
+```
+
+If a field MUST be required, document in the SC why each existing implementation must be updated inline, and pre-list those updates as primary tasks (Rule 2 pattern).
+
+---
+
+**Sediment source:** `.peaks/_runtime/2026-07-08-session-17918f/qa/003-add-zcode-adapter/{slice-A-completion,slice-B-completion}.md` D-009a/b/c sections. Master lesson: `.peaks/memory/peaks-code-runbook-4-0-0-beta-6-skill-md-cli-d-001-d-002-d-003-d-010.md`.

package/skills/peaks-solo/SKILL.md

@@ -0,0 +1,197 @@
+---
+name: peaks-solo
+description: |
+  Dispatcher (分诊员) for the Peaks-Loop skill family. Use when the user describes a task in natural language and does NOT know which peaks-* skill fits. peaks-solo reads the live skill pool via `peaks skill search`, dispatches to a matching leaf (peaks-code / peaks-content / peaks-doctor / peaks-issue-fix-orchestrator / etc.) or falls back to self-planned execution (deep-search / WebSearch / Bash / Edit markdown) if no leaf matches, and then asks the user whether to sediment the result.
+
+  Triggers: 自然语言描述诉求且无明确 peaks-* skill 选择 / "帮我处理这个" / "我不知道该用哪个" / "随便都行".
+
+  NOT for: code-specific work (use /peaks-code) / content-specific work (use /peaks-content) / project health check (use /peaks-doctor) / issue sweep (use /peaks-issue-fix-orchestrator) / SOP authoring (use /peaks-sop).
+metadata:
+  type: dispatcher
+  domain: triage
+  visibility: public
+  supersedes: peaks-solo (eradicated 2026-07-05, revived 2026-07-08)
+  red_lines: [RL-1, RL-8, HC-7, HC-8, HC-9, HC-10, HC-11]
+---
+
+# peaks-solo — Dispatcher (分诊员)
+
+> peaks-solo 是 Peaks-Loop 的 dispatcher,不是 orchestrator。读取技能池 → 分诊 → 转交 leaf 或自规划 → 回头问沉淀。**不持有 implementation surface**。
+
+---
+
+## 1. 角色定义 (dispatcher ≠ orchestrator)
+
+**peaks-solo 是一条 dispatcher skill**,跟 `peaks-code` 这种 orchestrator 平行存在,但更薄一层:
+
+| 角色 | 工作 | 是否持有 implementation surface |
+|---|---|---|
+| **dispatcher** (peaks-solo,本 skill) | 看用户 NL → 查 skill 池 → 转交 / 自规划 → 问沉淀 | **不持有**(只调度,不实现) |
+| **orchestrator** (peaks-code / peaks-content / peaks-doctor) | 看用户 NL → 走 11 步 runbook → 直接调 prd/rd/qa/ui/sc/txt 蜂群 → 沉淀 | **持有**(通过子蜂群间接持有) |
+
+**核心区分(HC-11 锁死):** peaks-solo 能看、能查、能转交、能跑通用工具(deep-search / WebSearch / Bash / Edit markdown)、能提议沉淀;**不能**写代码、**不能**写 PRD、**不能**跑 vitest、**不能**改 Loop Engineering 资产(那是用户主权)。
+
+**与 peaks-* leaf 的关系:** peaks-solo 是新加的第三条入口,不替代任何 leaf。3.x / 4.x 老用户继续 `/peaks-code` / `/peaks-content` / `/peaks-doctor` 等,**老入口 0 改动**(HC-10)。
+
+---
+
+## 2. 触发条件
+
+peaks-solo 由 LLM 在三种匹配类之一触发,**不依赖**任何固定的 slash 命令前缀:
+
+### 2.1 Source-trace 触发
+
+LLM 自身启动循环(如 Claude Code 启动新会话、resume 检测、auto-decide 路径)时,**没有**其它 skill 已被 dispatch,且用户描述诉求 → 走 peaks-solo 分诊。
+
+### 2.2 Trigger-phrase 触发(主路径)
+
+用户自然语言描述诉求 + 满足下列任一短语:
+
+- 自然语言描述诉求且无明确 peaks-* skill 选择(主触发)
+- "帮我处理这个" / "帮我看看"
+- "我不知道该用哪个"
+- "随便都行" / "你帮我决定"
+- "我有个事需要处理" / "我想做点东西"
+
+**反向:** 用户已明确指定 `/peaks-code` / `/peaks-content` / `/peaks-doctor` 等具体 skill → 不进 peaks-solo,直接 dispatch 到该 leaf(HC-10 老入口保留)。
+
+### 2.3 LLM-judge 触发
+
+用户 NL 表述是开放性、跨域、或者 LLM 无法判定属于哪个 peaks-* 域时(例如"帮我看下 GitHub trending top 10"),LLM 自己判断"这事没有专属 leaf",走 peaks-solo 兜底。
+
+---
+
+## 3. Triage 决策流
+
+peaks-solo 的 triage 流严格按以下伪代码执行:
+
+```
+1. user NL → peaks-solo 触发
+2. peaks-solo 跑 peaks skill search --query "<NL>" → 拿到 candidates []
+3. if candidates.length == 0:
+     → 走自规划兜底(§4)
+4. if candidates.length == 1:
+     → 直接 Skill tool 调起该 skill(转交,无感)
+5. if candidates.length >= 2:
+     → 走 AskUserQuestion 多选("NL 描述匹配到 N 个 peaks-* skill,请选一个:")
+     → 用户选 → Skill tool 调起
+     → 用户选 "(e) 都不对" → 自规划兜底(§4)
+6. leaf 跑完 → leaf 内部自己处理 sediment(不重复问;HC-9)
+7. 自规划跑完 → 走 §5 沉淀提议
+```
+
+### 3.1 多候选 AskUserQuestion 模板(HC-9 锁死)
+
+```
+question: "这个诉求匹配到以下 peaks-* skill,请选一个:"
+options:
+  - (a) <name + 一句话功能 + 适用场景>
+  - (b) <name + 一句话功能 + 适用场景>
+  - ...
+  - (e) 都不对,我自己跑
+multiSelect: false
+```
+
+**关键约束:** 必须是 AskUserQuestion,**不**允许让用户自由文本输入 skill 名(HC-9 Human-NL-Choice-Only)。
+
+### 3.2 用户主动说"我自己来" / "不用分诊"
+
+LLM **bail out**(返回控制权给用户,不调任何 leaf,不进自规划兜底)。
+
+### 3.3 关键词 → leaf skill 快速映射
+
+完整 ≥ 10 行关键词表见 `references/triage-decision-table.md`。下面只列最常见的 5 类:
+
+| keyword | → leaf skill |
+|---|---|
+| code / 改 bug / 全流程 / 端到端 | `/peaks-code` |
+| 文档 / article / 内容 / 写稿 | `/peaks-content` |
+| 健康 / 体检 / audit 报告 | `/peaks-doctor` |
+| issue / 批量修 / sweep | `/peaks-issue-fix-orchestrator` |
+| SOP / 流程 / 工作流 | `/peaks-sop` |
+
+---
+
+## 4. 自规划兜底
+
+当 `peaks skill search` 返回 0 个候选,或用户选"(e) 都不对",LLM 走自规划:用通用工具(deep-search / WebSearch / Bash / Edit markdown)完成用户诉求。
+
+### 4.1 允许工具清单
+
+| 工具 | 适用场景 | 限制 |
+|---|---|---|
+| `deep-search` skill | 信息查询 / 研究类(若已装) | 不主动 install |
+| `WebSearch` / `WebFetch` | 实时性高的查询(超过训练数据) | 内置工具 |
+| `Bash` | 数值计算 / 系统命令 / git 操作 | **不写 src/** 业务代码(那是 peaks-code 域) |
+| `Edit` / `Write` | 改 markdown / 改 yaml / 改 `.peaks/memory/` 文件 | **不改 src/** 业务代码;**不改 `skills/peaks-{code,content,doctor,...}/`** 任何 leaf skill 文件 |
+| `peaks memory extract` | 跑完提议沉淀 | 走现成 CLI,不重写 |
+
+完整 allowed + blocked 清单见 `references/fallback-tool-inventory.md`。
+
+### 4.2 自规划成功后的下一步
+
+自规划跑完 **必须** 走 §5 沉淀提议(HC-9 Human-NL-Choice-Only);不允许静默丢弃结果。
+
+---
+
+## 5. 沉淀提议
+
+自规划兜底跑完(leaf 转交跑完则由 leaf 内部 Step 11 处理,不重复问)→ peaks-solo 用 AskUserQuestion 提议沉淀。
+
+### 5.1 AskUserQuestion 模板(HC-9 锁死)
+
+```
+question: "本次结果是否沉淀?"
+options:
+  - (a) 沉淀为普通 lesson / convention → peaks memory extract --apply
+  - (b) 沉淀为 Loop Engineering 资产 → peaks asset crystallize
+  - (c) 改 scope 再沉淀(LLM 继续追问)
+  - (d) 不沉淀(单次性,丢弃)
+multiSelect: false
+```
+
+**默认推荐 = (a)**(普通 lesson / convention),LLM 必须给一段 NL 解释为什么推荐 (a) 或 (b),**不**允许默认推荐 (d)。
+
+完整 4-option 模板 + 触发条件矩阵见 `references/sediment-prompt-template.md`。
+
+### 5.2 触发条件矩阵
+
+| peaks-solo 跑完类型 | 是否问 | trigger |
+|---|---|---|
+| 转交 leaf 跑完 | **不问** | (leaf 内部 Step 11 处理) |
+| 自规划兜底跑完 | **默认问** | `success_default_prompt` |
+| 用户主动说"沉淀这个" | **立即问** | `user_explicit` |
+| LLM 识别 ≥ 2 个 reuse signals | **附带 4-section brief 问** | `llm_suggested` |
+
+---
+
+## 6. Out of scope (HC-11 锁死)
+
+peaks-solo 是 dispatcher,**不**是 orchestrator,**不**是 implementer。下面四类操作**禁止**直接在 peaks-solo 内部执行:
+
+- **no code** — 不写 / 不改 / 不重构 `src/**` 业务代码,也不调 peaks-rd / peaks-qa / peaks-ui / peaks-sc 子蜂群(那是 peaks-code 的 implementation surface)。遇到 code-domain 需求必须转交 `/peaks-code` 或建议用户自己跑。
+- **no PRD** — 不写产品需求文档(那是 peaks-code → peaks-prd 的范围)。peaks-solo 自己不持有 PRD 的生成 surface。
+- **no vitest** — 不跑测试,也不写 `tests/**` 业务测试。遇到测试需求必须转交 `/peaks-test` 或 `/peaks-code`。
+- **no Loop Engineering Asset mutation** — 不调 `peaks asset crystallize` 改 Loop Engineering 资产,也不写 `.peaks/standards/` / `.peaks/memory/` 之外的 peaks-loop 内部资产(那是用户主权,peak-* 技能层没有改动权)。
+
+**唯一例外:** 沉淀提议模板里 **选项 (b)** 提到 `peaks asset crystallize` 是给用户看的,不是 peaks-solo 自动执行;真正执行由用户在 AskUserQuestion 选中后由 LLM 代跑该 CLI。
+
+### 6.1 边角 case
+
+| case | 处理 |
+|---|---|
+| 用户中途换需求 | 重新跑 §3 triage,不复用旧 candidates |
+| 兜底工具失败(如 WebSearch 不可用) | 转下一种 allowed 工具;3 次失败后 AskUserQuestion 问用户是否要继续 |
+| 沉淀被拒后(用户选 d) | 不重复问,直接关闭本 skill session |
+| 用户在 AskUserQuestion 中输入自由文本(理论上不该发生) | 把它当作 NL 描述,重新跑 §3 triage |
+
+---
+
+## 相关引用
+
+- `references/triage-decision-table.md` — 关键词 → leaf skill 完整映射表(≥ 10 行)
+- `references/fallback-tool-inventory.md` — 自规划允许 + 禁止工具清单
+- `references/sediment-prompt-template.md` — 4-option AskUserQuestion 沉淀模板
+- spec: `docs/superpowers/specs/2026-07-08-peaks-solo-dispatcher-design.md` §3.1, §3.3, §3.4, §3.5
+- plan: `docs/superpowers/plans/2026-07-08-peaks-solo-dispatcher/s1-peaks-solo-skill.md`
+- decision memo: `.peaks/memory/user-decision-2026-07-08-revive-peaks-solo-as-dispatcher.md`

package/skills/peaks-solo/references/fallback-tool-inventory.md

@@ -0,0 +1,46 @@
+# peaks-solo — Fallback Tool Inventory (自规划兜底工具清单)
+
+> 当 `peaks skill search` 返回 0 候选,或用户在 AskUserQuestion 选"(e) 都不对",peaks-solo 走自规划兜底。本表规定自规划下 LLM **允许**与**禁止**调用的工具。
+> **核心边界(HC-11 锁死):** peaks-solo 不写业务代码、不写 PRD、不跑 vitest、不改 Loop Engineering 资产。下面 blocked 列表是 HC-11 的可执行形式。
+
+## Allowed tools (允许)
+
+| 工具 | 适用场景 | 限制 |
+|---|---|---|
+| `deep-search` skill | 信息查询 / 研究类 / 多跳事实核查 | 若 LLM CLI 平台装了 deep-search 自动出现;peaks-solo **不主动 install**;若未装,降级到 WebSearch |
+| `WebSearch` | 实时性高的查询(超过训练数据)/ trending / top N | 内置工具,无需 install |
+| `WebFetch` | 已知 URL 的内容抓取(单页,无 JS 渲染) | 内置工具;不爬取含登录 / 反爬的页面 |
+| `Bash` | 数值计算 / 系统命令 / git 操作 / `ls` / `cat` / `rg` / `grep` | 仅**只读命令**;不写 src/** 业务代码;不 rm;不 git push --force;不 chmod 777;不 curl \| sh |
+| `Edit` / `Write` | 改 markdown / 改 yaml / 改 `.peaks/memory/<user>/*.md` / 改临时文件 | **只允许**改:`*.md` / `*.yaml` / `*.yml` / `.peaks/memory/`;**不允许**改:`src/**` 业务代码 / `skills/peaks-{code,content,doctor,sop,status,test,resume,ide,final-review,slice-decompose,issue-fix-orchestrator,perf-audit,security-audit,audit}/**` 任何 leaf skill |
+| `peaks memory extract` | 跑完提议沉淀(选项 a) | 走现成 CLI,不重写;不创建新 CLI |
+| `AskUserQuestion` | 多候选分诊 / 沉淀提议 / 兜底方案选择 | HC-9 锁死;**不**引入自由文本输入 |
+
+## Blocked tools / operations (禁止)
+
+下表是**显式禁止**——LLM 在自规划兜底中**不能**调这些工具或跑这些操作。违反即违反 HC-11。
+
+| blocked 操作 | 原因 | 替代方案 |
+|---|---|---|
+| `rm -rf <path>` | 不可逆破坏性操作 | 改用 `mv <path> <path>.bak` 或只读 `ls` |
+| `git push --force` / `git push -f` | 改写历史,影响其他协作者 | 用 `git push --force-with-lease`(若必须)或拒绝 push 让用户自己来 |
+| `Edit src/**` / `Write src/**` 业务代码 | HC-11: no code;peaks-code 域 | 转交 `/peaks-code` |
+| `Edit skills/peaks-{code,content,doctor,sop,status,test,resume,ide,final-review,slice-decompose,issue-fix-orchestrator,perf-audit,security-audit,audit}/**` 任何文件 | HC-8 + HC-11: leaf skill 文件是用户主权 | 让用户自己改 |
+| `peaks asset crystallize`(直接调用) | Loop Engineering Asset mutation = 用户主权 | 仅在沉淀 AskUserQuestion 中作为**选项 (b)** 提及,不主动执行 |
+| `Edit .peaks/standards/**` / `Write .peaks/standards/**` | standards 是项目层 invariants | 让用户自己改 |
+| `Edit .claude-plugin/marketplace.json` | marketplace 是 install surface | 让用户自己改 / 转交 S2 |
+| `vitest` / `pnpm test` / 任何测试 runner | HC-11: no vitest | 转交 `/peaks-test` 或 `/peaks-code` |
+| `curl <untrusted-url> \| sh` / `wget \| bash` | RCE 风险 | 拒绝执行;若必须,先下载到文件,人工 review 后再执行 |
+| 写入用户 home 目录(`~/.*`) | 用户主权,peaks-solo 不动用户全局配置 | 让用户自己来 |
+
+## 边界判断原则
+
+LLM 拿不准"该不该做"时,按下面 3 条问自己:
+
+1. **这是 peaks-code 域吗?** 是 → 转交 `/peaks-code`。
+2. **这是用户主权领域吗?**(`src/**` 业务代码 / Loop Engineering Asset / 用户 home) → 让用户自己来。
+3. **这是 read-only 还是 mutating?** read-only(`ls` / `cat` / `rg` / WebSearch / WebFetch)→ OK;mutating 且不在 allowed 列表 → 拒绝。
+
+## 失败回退
+
+- 自规划下某个 allowed 工具失败 3 次(网络 / 权限 / not found)→ 走 AskUserQuestion 问用户:"这个工具一直失败,要不要换另一种?"(HC-9 锁死,不静默放弃)。
+- 自规划全部失败 → 走 AskUserQuestion:"peaks-solo 找不到合适工具,要不要: (a) 换更具体的 NL 重跑 / (b) 转人工 / (c) 结束"。

package/skills/peaks-solo/references/sediment-prompt-template.md

@@ -0,0 +1,62 @@
+# peaks-solo — Sediment Prompt Template (沉淀提议 AskUserQuestion)
+
+> 自规划兜底跑完(转交 leaf 跑完则由 leaf 内部 Step 11 处理,**不重复问**)→ peaks-solo 用本模板提议沉淀。
+> **核心约束(HC-9 Human-NL-Choice-Only 锁死):** 必须用 AskUserQuestion 4-option,**不**允许自由文本输入;**默认推荐 = (a)**,**不**是 (d)。
+
+## 4-option AskUserQuestion 模板
+
+```yaml
+question: "本次结果是否沉淀?"
+options:
+  - label: "(a) 沉淀为普通 lesson / convention"
+    description: "通过 peaks memory extract --apply 写到 .peaks/memory/<user>/,作为可复用 lessons/conventions。"
+  - label: "(b) 沉淀为 Loop Engineering 资产"
+    description: "通过 peaks asset crystallize 提升为 Loop Engineering Asset(标准 / skill / SOP / framework)。"
+  - label: "(c) 改 scope 再沉淀"
+    description: "本次 scope 不对,LLM 继续追问(例如想问清楚是什么 lesson),然后再走 (a) 或 (b)。"
+  - label: "(d) 不沉淀"
+    description: "单次性结果,丢弃,不写入任何 .peaks/ 路径。"
+multiSelect: false
+```
+
+## 默认推荐
+
+**默认推荐 = (a)**(普通 lesson / convention),**不**是 (d)。
+
+**为什么推荐 (a) 而不是 (b):** (b) 沉淀为 Loop Engineering Asset 是**重操作**——会进入 `.peaks/standards/` 或 `.peaks/memory/<asset>/`,影响所有 peaks-* skill 的语义。普通 lesson / convention 风险低、可回滚、不会污染项目 invariants,适合作为大多数一次性结果的首选归宿。(b) 仅在 LLM 识别 ≥ 2 个 reuse signals 时推荐。
+
+## LLM 必须给一段 NL rationale
+
+在调 AskUserQuestion 前,LLM **必须**先(在最终回复里,AskUserQuestion 之前)给一段 1-3 句的 NL 解释,说明为什么推荐 (a) 或 (b)。模板:
+
+> "我推荐 (a) 沉淀为普通 lesson / convention,理由:<1 句:本次结果的可复用程度 / 适用范围 / 为什么不是 (b) / 为什么不是 (d)>。如果你认为这是 Loop Engineering 级别的资产,选 (b);如果本次是单次性 / scope 不对,选 (c) 或 (d)。"
+
+**禁止:** 直接弹 AskUserQuestion 不解释;**禁止:** 默认推荐 (d)。
+
+## 触发条件矩阵
+
+| peaks-solo 跑完类型 | 是否问沉淀 | trigger 标记 |
+|---|---|---|
+| 转交 leaf 跑完 | **不问**(leaf 内部 Step 11 处理) | `leaf_handled` |
+| 自规划兜底跑完(成功) | **默认问** | `success_default_prompt` |
+| 自规划兜底跑完(部分失败) | **附带"是否继续"二选一 + 沉淀四选一**两个 AskUserQuestion | `partial_failure` |
+| 用户主动说"沉淀这个" / "把这个记下来" | **立即问**(跳过自规划完成检测) | `user_explicit` |
+| LLM 识别 ≥ 2 个 reuse signals(同一结果可在 ≥ 2 个未来场景复用) | **附带 4-section brief 问**(在 question 前先输出 brief:reuse contexts / scope / drift risks / crystallize recommendation) | `llm_suggested` |
+| 沉淀提议被用户选 (d) 后 | **不重复问**,直接关闭 peaks-solo session | `user_declined` |
+| 沉淀提议被用户选 (c) 后(scope 改) | **继续追问 → 再问一次 4-option** | `scope_change` |
+
+## 沉淀后的执行
+
+| 用户选 | LLM 执行 |
+|---|---|
+| (a) | `peaks memory extract --apply --session-id <sid> --project <repo>` —— 走现成 CLI,不重写 |
+| (b) | `peaks asset crystallize --asset <name> --project <repo>` —— 走现成 CLI;**仅**在用户明确选 (b) 后执行 |
+| (c) | 继续 AskUserQuestion 追问(例如"具体是什么场景的 lesson?" / "适用哪个子项目?") |
+| (d) | 不写任何文件;peaks-solo 直接结束 |
+
+## 反 pattern 警告
+
+- **不推荐 (b) 默认推荐** —— 大多数一次性结果进不了 Loop Engineering Asset 层;盲目 crystallize 会污染 `.peaks/standards/`。
+- **不静默丢弃** —— 用户没明示"不要沉淀",就必须问;选 (d) 必须是用户**主动选**,不是 LLM 默认。
+- **不重复问** —— 转交 leaf 跑完由 leaf 处理 sediment;peaks-solo 只对**自规划兜底跑完**问。
+- **不让用户自由文本** —— HC-9 锁死;不在 AskUserQuestion 选项之外加 free-form input。

package/skills/peaks-solo/references/triage-decision-table.md

@@ -0,0 +1,31 @@
+# peaks-solo — Triage Decision Table
+
+> 关键词 → leaf skill 快速映射。peaks-solo 在 §3 triage 决策流里先扫本表做"启发式预判",再用 `peaks skill search --query "<NL>"` 做精确匹配。
+> 匹配规则:case-insensitive substring(命中即行;同 NL 多行命中 → AskUserQuestion 多选)。
+
+| keyword | → | leaf skill |
+|---|---|---|
+| code / 代码 / 改 bug / 写功能 / 全流程 / 端到端 / PR / 测试覆盖 / 改 src | → | /peaks-code |
+| 文档 / article / blog / 内容 / 写稿 / 内容工作流 / 公众号 / 长文 | → | /peaks-content |
+| 健康 / health / 体检 / audit / 报告 / doctor report / 项目诊断 | → | /peaks-doctor |
+| issue / 修 issue / sweep / 批量修 / open issue 处理 | → | /peaks-issue-fix-orchestrator |
+| SOP / 流程 / 工作流 / 审批 / 门禁 / 标准操作 | → | /peaks-sop |
+| 性能 / perf / 慢 / 优化 / latency / 响应时间 | → | /peaks-perf-audit (or 自规划) |
+| 安全 / security / 漏洞 / vulnerability / OWASP | → | /peaks-security-audit (or 自规划) |
+| 状态 / status / 进度 / 现在到哪 / 当前在哪一步 | → | /peaks-status |
+| 跑测试 / test / vitest / unit test | → | /peaks-test |
+| 恢复 / resume / 继续 / 接上次 | → | /peaks-resume |
+| 不知道 / 随便 / 帮我 / 你帮我决定 / 我想做点东西 | → | peaks-solo triage (this skill) |
+| 切片 / slice / 拆解任务 / 大任务拆小 | → | /peaks-slice-decompose |
+| 想法 / brain-storm / 创意 / 探索思路 | → | /peaks-ide |
+| 最终审查 / final review / 验收 / 4-dim evidence | → | /peaks-final-review |
+| 研究 / research / 信息查询 / GitHub trending / top 10 / 调查 | → | (no leaf) → 自规划(deep-search / WebSearch) |
+| 一句话需求 / 一次性 / 单次性 | → | peaks-solo 自规划兜底 |
+
+## 使用说明
+
+1. **先扫表,再跑 search。** 表是 O(N) 的 substring 命中;跑 `peaks skill search` 是兜底。两者结果不一致时,以 search 为准(search 读的是 live frontmatter)。
+2. **多行命中 → AskUserQuestion 多选,**模板见 SKILL.md §3.1。
+3. **(e) "都不对" → 自规划兜底。** 走 SKILL.md §4。
+4. **空表条目:** "研究 / 信息查询 / GitHub trending / top 10" 等一次性信息查询,**当前 skill 池没有专属 leaf**,peaks-solo 直接走自规划(deep-search / WebSearch)。
+5. **本表是 opportunistic 表,**不是 exhaustive 表。S2/S3 后续可在 dogfood 中发现新关键词补行。

package/skills/peaks-sop/test-prompts.json

@@ -0,0 +1,17 @@
+[
+  {
+    "id": 1,
+    "prompt": "我想要一个发布流程：先写好 CHANGELOG，再跑通测试，最后才能发布。帮我做成一个 SOP，我不想自己写 JSON。",
+    "expected": "peaks-sop 访谈出 phases（如 draft/review/ship）和门禁，调用 peaks sop init --apply 生成骨架，把门禁写进 sop.json（changelog 用 file-exists、tests 用 command 并提示需要 --allow-commands），跑 peaks sop lint 到 ok:true，用 peaks sop check 验证每个门禁，再 peaks sop register 注册。全程不让用户手写 JSON。"
+  },
+  {
+    "id": 2,
+    "prompt": "我的 SOP lint 报错说门禁绑定了未知阶段，帮我修。",
+    "expected": "peaks-sop 读 lint findings 定位违例门禁，在 sop.json 里把门禁的 phase 改成已声明的阶段（或补声明该阶段），重新 peaks sop lint 直到 ok:true，不直接 register 未通过 lint 的 SOP。"
+  },
+  {
+    "id": 3,
+    "prompt": "这个发布 SOP 真的能在测试没过时把我拦住吗？我想先确认再用。",
+    "expected": "peaks-sop 用 peaks sop check 在好/坏两种状态下验证门禁返回 pass/fail，再用 peaks sop advance --to ship --dry-run 干跑确认门禁未通过时阻断推进且不落盘，向用户展示阻断行为后再交付。"
+  }
+]

package/dist/src/cli/cli-helpers.d.ts

@@ -1,43 +0,0 @@
-import { Command } from 'commander';
-import { getErrorMessage, ok, redactSensitiveErrorMessage, type ResultEnvelope } from '../shared/result.js';
-import type { ArtifactProvider, GuidedArtifactSetup } from '../services/artifacts/artifact-service.js';
-import type { ConfigLayer } from '../services/config/config-service.js';
-import type { MiniMaxProviderSmokeResult } from '../services/providers/minimax-provider-service.js';
-import type { MiniMaxWorkerResult } from '../services/providers/minimax-worker-service.js';
-import type { RecommendationWorkflow } from '../services/recommendations/recommendation-service.js';
-export type ProgramIO = {
-    stdout: (text: string) => void;
-    stderr: (text: string) => void;
-};
-export declare function printResult<T>(io: ProgramIO, result: ResultEnvelope<T>, asJson?: boolean): void;
-export declare function addJsonOption(command: Command): Command;
-export declare function failUnsupportedNonDryRun(io: ProgramIO, command: string, asJson?: boolean): void;
-/** CLI shim helper: render a `{ ok: boolean, error?, data? }` envelope
- *  and set `process.exitCode = 1` on failure.
- *
- *  Library functions MUST return envelopes like `{ ok, error?, data? }`
- *  and MUST NOT mutate `process.exitCode` themselves. The shim (the
- *  Commander `.action()` callback in `register*Commands`) owns the
- *  process-exit side-effect so the library can be re-used from non-CLI
- *  contexts (vitest, programmatic dispatch, plugin loading).
- *
- *  Output format mirrors the existing `registerSedimentCommands` shim:
- *  a JSON envelope on stdout (one line, parseable), nothing else.
- */
-export interface CliEnvelope {
-    ok: boolean;
-    error?: string;
-    data?: unknown;
-}
-export declare function printCliEnvelope(io: ProgramIO, r: CliEnvelope): void;
-export declare function isRecommendationWorkflow(value: string): value is RecommendationWorkflow;
-export declare function isArtifactProvider(value: string): value is ArtifactProvider;
-export declare function isArtifactSetupStep(value: string): value is GuidedArtifactSetup['step'];
-export declare function isArtifactRepoSegment(value: string): boolean;
-export declare function isMiniMaxHttpsUrl(value: string): boolean;
-export declare function parseConfigLayer(value: string | undefined): ConfigLayer | undefined | null;
-export declare function printInvalidConfigLayer(io: ProgramIO, command: string, asJson?: boolean): void;
-export declare function multipleOption(value: string, previous: string[]): string[];
-export declare function summarizeMiniMaxSmokeResult(result: MiniMaxProviderSmokeResult): MiniMaxProviderSmokeResult;
-export declare function summarizeMiniMaxWorkerResult(result: MiniMaxWorkerResult): MiniMaxWorkerResult;
-export { getErrorMessage, ok, redactSensitiveErrorMessage };

package/dist/src/cli/cli-helpers.js

@@ -1,86 +0,0 @@
-import { fail, getErrorMessage, ok, redactSensitiveErrorMessage } from '../shared/result.js';
-const MINIMAX_API_HOST = 'api.minimaxi.com';
-export function printResult(io, result, asJson = false) {
-    if (asJson) {
-        io.stdout(JSON.stringify(result, null, 2));
-        return;
-    }
-    if (!result.ok) {
-        io.stderr(`${result.code}: ${result.message}`);
-        for (const action of result.nextActions) {
-            io.stderr(`- ${action}`);
-        }
-        return;
-    }
-    io.stdout(JSON.stringify(result.data, null, 2));
-    for (const warning of result.warnings) {
-        io.stderr(`warning: ${warning}`);
-    }
-    for (const action of result.nextActions) {
-        io.stdout(`next: ${action}`);
-    }
-}
-export function addJsonOption(command) {
-    return command.option('--json', 'print machine-readable JSON envelope');
-}
-export function failUnsupportedNonDryRun(io, command, asJson) {
-    printResult(io, fail(command, 'UNSUPPORTED_NON_DRY_RUN', 'Only dry-run planning is supported', {}, ['Rerun with --dry-run or omit --no-dry-run']), asJson);
-    process.exitCode = 1;
-}
-export function printCliEnvelope(io, r) {
-    if (r.ok) {
-        io.stdout(JSON.stringify({ ok: true, data: r.data ?? null }));
-        return;
-    }
-    io.stdout(JSON.stringify({ ok: false, error: r.error }));
-    process.exitCode = 1;
-}
-export function isRecommendationWorkflow(value) {
-    return value === 'code-refactor' || value === 'product-refactor' || value === 'frontend-design';
-}
-export function isArtifactProvider(value) {
-    return value === 'github' || value === 'gitlab';
-}
-export function isArtifactSetupStep(value) {
-    return value === 'detect' || value === 'configure' || value === 'validate' || value === 'complete';
-}
-export function isArtifactRepoSegment(value) {
-    return /^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(value) && !value.includes('..') && !value.endsWith('.');
-}
-export function isMiniMaxHttpsUrl(value) {
-    try {
-        const url = new URL(value);
-        return url.protocol === 'https:' && url.hostname === MINIMAX_API_HOST && url.username.length === 0 && url.password.length === 0 && url.search.length === 0 && url.hash.length === 0;
-    }
-    catch {
-        return false;
-    }
-}
-export function parseConfigLayer(value) {
-    if (value === undefined) {
-        return undefined;
-    }
-    return value === 'user' || value === 'project' ? value : null;
-}
-export function printInvalidConfigLayer(io, command, asJson) {
-    printResult(io, fail(command, 'INVALID_CONFIG_LAYER', 'Config layer must be user or project', {}, ['Use --layer user or --layer project']), asJson);
-    process.exitCode = 1;
-}
-export function multipleOption(value, previous) {
-    return [...(previous || []), value];
-}
-export function summarizeMiniMaxSmokeResult(result) {
-    return { ...result, responseText: null, summary: null };
-}
-export function summarizeMiniMaxWorkerResult(result) {
-    const provider = summarizeMiniMaxSmokeResult(result.provider);
-    return {
-        ...result,
-        provider,
-        reviewHandoff: {
-            model: result.reviewHandoff.model,
-            prompt: '[redacted]'
-        }
-    };
-}
-export { getErrorMessage, ok, redactSensitiveErrorMessage };

package/dist/src/cli/commands/agent-commands.d.ts

@@ -1,20 +0,0 @@
-/**
- * peaks agent * CLI surface — Slice: ECC 64 agents soft-optional
- * integration (per spec §7.2 line 818).
- *
- * Registers the new `peaks agent` top-level command with two
- * subcommands:
- *   - `peaks agent run <name> [--target <path>]`  — shell out to
- *     `npx ecc agent run <name> --target <path> --json` when ECC
- *     is installed; soft-fail with the 4-option install prompt
- *     when it isn't.
- *   - `peaks agent list`                          — emit the 12
- *     canonical ECC agents (the wrapper hardcodes the
- *     most-used subset; the full 64-agent list is
- *     discoverable at runtime via `npx ecc agent list`).
- *
- * The wrapper service is `src/services/agent/ecc-agent-service.ts`.
- */
-import { Command } from 'commander';
-import { type ProgramIO } from '../cli-helpers.js';
-export declare function registerAgentCommands(program: Command, io: ProgramIO): void;