harnessed 4.6.0 → 4.8.0

package/workflows/plan/auto/SKILL.zh-Hans.md

@@ -0,0 +1,75 @@
+---
+name: plan
+description: |
+  Stage ② Plan 主控编排器 — 串行 invoke 2 个子工作流（architecture 条件触发 → phase 始终触发）。
+  复杂架构 gstack /plan-eng-review 锁定架构后再 GSD /gsd-plan-phase + planning-with-files 持久化
+  task_plan.md。schema_version: harnessed.workflow.v3 with delegates_to (2 sub: architecture
+  serial order 1 + phase serial order 2) + disciplines_applied (6 default) + tools_available
+  (planning-with-files + plan-eng-review + gsd-plan-phase)。
+  Triggered by slash command `/plan`
+  (bare per ADR 0030 namespace policy D-02 LOCK) after `harnessed setup`.
+trigger_phrases:
+  - "plan"
+  - "计划阶段"
+  - "stage 2 plan"
+  - "持久化计划"
+  - "task_plan"
+---
+
+# plan 主控编排器 (v3)
+
+## 概述
+
+4-stage cadence Stage ② 主控编排器，委派给 2 个串行子工作流
+（打包的 Plan 阶段节奏 + D-06 planning-with-files 横切工具）：
+
+| order | sub | gate ref | mode | when fires |
+| ----- | --- | -------- | ---- | ---------- |
+| 1 | `architecture` | `judgments.stage-routing.plan-architecture-delegate.fires` | serial | phase.is_complex_architecture == true |
+| 2 | `phase` | (unconditional — plan-phase always fires when stage=='plan') | serial | always |
+
+引擎运行时通过 `runMasterOrchestrator` 按 T3.5.W0.1 顺序派发 2 个子工作流阶段：
+order 1（architecture 条件触发）必须完成后，order 2 才启动
+（phase 无条件，GSD plan-phase + planning-with-files `/plan` task_plan.md 持久化）。
+K9 invariant 强制：每个 serial mode 委派必须携带显式 `order`。
+
+## 能力引用
+
+Sister `workflows/capabilities.yaml`：
+- `planning-with-files` — Bucket 4 核心 capability (impl: claude-code-plugin, cmd: /plan)
+- `plan-eng-review` — Bucket 7 gstack 33 optional (impl: gstack, cmd: /plan-eng-review)
+- `gsd-plan-phase` — Bucket 2 special-purpose (impl: gsd, cmd: /gsd-plan-phase)
+- sub `architecture` upstream → `plan-eng-review`
+- sub `phase` upstream → `gsd-plan-phase` + `planning-with-files`
+
+## 路由规则（sister CLAUDE.md "Plan 阶段"）
+
+- **复杂架构必须先跑** `/plan-eng-review` 锁定架构后再进入 plan-phase (sister CLAUDE.md "⚠️")
+- 普通 phase 跳过 architecture sub（gate `phase.is_complex_architecture == false`）
+- **禁止在规划阶段直接使用** `superpowers:writing-plans` 输出大文档（除非用户明确要求）
+
+## 调用方式
+
+- Slash command：`/plan <text>`（bare per ADR 0030 namespace policy D-02 LOCK，`harnessed setup` 后生效）
+
+## 如何调用
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run plan --task-stdin
+```
+
+若 `$ARGUMENTS` 为空，运行 `harnessed run plan`（不带 stdin pipe）。
+
+完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一阶段。是否调用由对话上下文决定——该提示仅供参考，非强制指令。
+
+<!-- harnessed-generated:v3.4.4 -->
+
+## 参考文档
+
+- D-01 主控编排器委派模式
+- D-02 bare slash cmd 约定（ADR 0030 namespace policy LOCK）
+- D-06 planning-with-files 横切工具（NOT 独立 sub-workflow）
+- workflows/judgments/stage-routing.yaml — plan-{architecture,phase}-delegate triggers
+- workflows/plan/{architecture,phase}/workflow.yaml — 2 sub-workflow Phase 3.4 SHIPPED

package/workflows/plan/phase/SKILL.zh-Hans.md

@@ -0,0 +1,76 @@
+---
+name: plan-phase
+description: |
+  Stage ②.b 计划层 plan 子工作流 — GSD /gsd-plan-phase Wave A research + Wave B planner +
+  Wave C plan-checker + planning-with-files Claude Code plugin /plan 持久化 task_plan.md +
+  progress.md（打包的 Plan-stage 节奏：GSD + planning-with-files）。Stage ② 铁律:
+  dual capability (GSD orchestration + planning-with-files plugin)。schema_version:
+  harnessed.workflow.v3 with disciplines_applied (6 default) + tools_available [gsd-plan-phase,
+  planning-with-files] + 2 phases (01-gsd-plan + 02-persist)。Triggered by harnessed CLI
+  `harnessed plan-phase --phase <num>` or slash command `/plan-phase` after `harnessed setup`.
+trigger_phrases:
+  - "plan phase"
+  - "计划层 phase"
+  - "gsd plan phase"
+  - "持久化计划"
+  - "跑 plan-phase"
+---
+
+# plan-phase 工作流 (v3)
+
+## 概述
+
+2 阶段子工作流，将 CLAUDE.md "Plan 阶段 — GSD + planning-with-files" 映射到 harnessed
+运行时（Phase v3.0-3.4 W0.5 — D-04 Stage ② Plan 二层 + D-15 planning-with-files
+claude-code-plugin /plan + Pattern A sub-workflow ship）。
+
+| phase | id | upstream | model | capability / invokes | artifacts |
+| ----- | -- | -------- | ----- | -------------------- | --------- |
+| 1 | `01-gsd-plan` | gsd | sonnet | `{{ capabilities.gsd-plan-phase.cmd }}` | (Wave A research + Wave B planner + Wave C plan-checker) |
+| 2 | `02-persist` | planning-with-files | haiku | `{{ capabilities.planning-with-files.cmd }}` + `invokes: /plan` | `artifacts_expected: [task_plan.md, progress.md]` |
+
+## 能力引用
+
+Sister `workflows/capabilities.yaml` 条目：
+- `gsd-plan-phase` — Bucket 2 (impl: gsd, cmd: /gsd-plan-phase)
+- `planning-with-files` — Bucket 4 (impl: claude-code-plugin, cmd: /plan;
+  需要通过 Claude Code plugin marketplace 安装 `planning-with-files` Claude Code 插件；
+  输出：task_plan.md + progress.md + findings.md)
+
+## Stage ② 铁律 — dual capability
+
+GSD `/gsd-plan-phase` 编排（Wave A research → Wave B planner → Wave C
+plan-checker）→ planning-with-files `/plan` 持久化（插件真生成 task_plan.md +
+progress.md，NOT fs.writeFile self-impl per D-15 Q-AUDIT-5a claude-code-plugin
+reframe）。
+
+## 调用方式
+
+- Slash command：`/plan-phase <num>`（`harnessed setup` 后生效）
+
+## 输出产物
+
+- `task_plan.md` — 主任务清单 + 文件路径 + 依赖 + 验收标准
+- `progress.md` — phase 进度跟踪 + cross-session 恢复
+- （`findings.md` 由 discuss-* 子工作流产出，此处不重复）
+
+## 如何调用
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run plan-phase --task-stdin
+```
+
+若 `$ARGUMENTS` 为空，运行 `harnessed run plan-phase`（不带 stdin pipe）。
+
+完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一阶段。是否调用由对话上下文决定——该提示仅供参考，非强制指令。
+
+<!-- harnessed-generated:v3.4.4 -->
+
+## 参考文档
+
+- D-04 Stage ② Plan 二层（架构 / 计划）
+- D-15 Q-AUDIT-5a planning-with-files claude-code-plugin reframe (NOT npm-sdk)
+- workflows/capabilities.yaml — gsd-plan-phase / planning-with-files (Bucket 4)
+- workflows/defaults.yaml — ralph_max_iterations.plan-phase.* values (W2.2 backfill)

package/workflows/research/SKILL.zh-Hans.md

@@ -0,0 +1,81 @@
+---
+name: research
+description: 多源调研工作流 — Tavily/Exa/ctx7 多源 fan-out + GSD discuss synth aggregate; harnessed v2.0 新增 per R20.7 (Stage ① Discuss 独立调用); schema bumped to harnessed.workflow.v3 in Phase v3.0-3.4 W1.1 (T3.4.W1.1) with disciplines_applied [6] + tools_available [tavily-mcp, exa-mcp, ctx7, gsd-discuss-phase], phases reuse v2 verbatim. Triggered by slash command `/research` after `harnessed setup`.
+preamble-tier: 2
+schema_version: harnessed.workflow.v3
+---
+
+# research 工作流
+
+harnessed v2.0 随附的多源调研工作流（Stage ① Discuss）；
+`workflow.yaml` schema 在 Phase v3.0-3.4 W1.1 中 bump 至 `harnessed.workflow.v3`
+(T3.4.W1.1 — D-09 L0 Discipline Substrate + D-05 tools_available 交叉验证)；
+phases 内容（01-fan-out + 02-synth）原样沿用 v2 SHIPPED，未做更改。
+
+## 阶段 (2)
+
+| # | Phase | Upstream | Capability | Model | Description |
+|---|-------|----------|-----------|-------|-------------|
+| 01 | `01-fan-out` | web-search | (route-by-subtask) | sonnet | 3 路并发调研 (Tavily MCP / Exa MCP / ctx7 CLI，遵循内置 web-search + context7 路由规则) |
+| 02 | `02-synth` | gsd | `gsd-discuss-phase` | opus | GSD discuss-phase 聚合 + 去重 + 对账 |
+
+## Capability refs
+
+Sister `workflows/capabilities.yaml` 条目：
+- `tavily-mcp` (impl: mcp-server，默认关键词搜索)
+- `exa-mcp` (impl: mcp-server，描述式 / 学术搜索)
+- `ctx7` (impl: cli-tool，库 API 文档)
+- `gsd-discuss-phase` (synth aggregate)
+
+## 调用方式
+- Slash command: `/research <topic>`（`harnessed setup` 后可用）
+
+## 路由规则（内置 web-search 路由 — `workflows/judgments/web-search-routing.yaml`）
+- 描述式查询（"找一篇对比 X 和 Y 的博客"）→ Exa MCP
+- 学术 / 论文 → Exa MCP
+- 库 / API 文档 → ctx7 CLI
+- 关键词 / 时效内容 → Tavily MCP（默认）
+- 抓整站 / 站点结构 → Tavily crawl/map
+
+## 如何调用
+
+**优先路径**（master orchestrator）：按当前 stage 规定的顺序依次调用各子工作流的 slash command。每个子命令安装在 `<claude-home>/commands/<sub-name>.md`（由 `harnessed setup` 安装），自带双路径兜底。
+
+**兜底路径**（当上游未安装或无返回结果时）：使用 Task 工具 spawn 一个通用 subagent，prompt 如下：
+
+> You are a **Research analyst**.
+>
+> **Mission**: Multi-source investigation (docs / web search / codebase grep / library probe) producing a `findings.md` with citations, NOT speculation. Use `ctx7` for library docs, `tavily-mcp` / `exa-mcp` for web, `gh` CLI for GitHub artifacts, and codebase `Grep` for internal references.
+>
+> **Default-suspect mode**: assume the change is broken / risky / incomplete until proven otherwise. Cite `file:line` for every finding; do not generalize.
+>
+> **Review checklist**:
+> 1. Resolve each unknown claim to a citable source (URL, file:line, or `ctx7` doc id)
+>
+> 2. Cite version explicitly when discussing library / framework APIs (training cutoff may be stale)
+>
+> 3. Capture conflicting sources side-by-side; do not silently pick one
+>
+> 4. Flag `OPEN: <question>` for items the user must decide; never paper over
+>
+> 5. Persist results to `.planning/<phase>/findings.md` for cross-session handoff
+>
+> **Output format**: structured report with severity-classified findings (verified / unverified / conflicting / open). One finding per line: `[severity] file:line — problem (one sentence); fix: suggested change`. If no findings, say so explicitly. No preamble, no end-of-report summary.
+
+（Role prompt 自包含 — 即使上游 `specialist` user-skill / plugin 未安装也可正常运行。）
+
+（`harnessed setup` 同时会在 `<claude-home>/commands/research.md` 安装一个 `research` Claude Code slash command，使 `/research` 成为真正的平台 slash command — 两个文件携带相同的双路径指令。之前 v3.4.x 中 `harnessed research --apply` CLI 的相关说明已移除；该子命令从未被实现。）
+
+## 如何调用
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run research --task-stdin
+```
+
+如果 `$ARGUMENTS` 为空，运行 `harnessed run research`（不带 stdin pipe）。
+
+完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一个阶段。根据对话上下文决定是否调用 — 该提示仅供参考，不作强制指引。
+
+<!-- harnessed-generated:v3.4.4 -->

package/workflows/retro/SKILL.zh-Hans.md

@@ -0,0 +1,71 @@
+---
+name: retro
+description: |
+  独立的 post-④ Verify 回顾工作流 — gstack /retro 经验教训 / 决策 / lessons
+  系统总结 (项目 / 里程碑结束可选, bundled milestone-close retrospective cadence)
+  + planning-with-files RETROSPECTIVE.md 持久化 (sister Phase
+  v2.0-2.5 RETROSPECTIVE pattern)。Capability ref retro-gstack alias suffix per Pattern A
+  E.2 LOCK (NOT bare retro 避免 standalone workflow / capability namespace 冲突)。
+  schema_version: harnessed.workflow.v3 with disciplines_applied (6 default) + tools_available
+  (retro-gstack + planning-with-files) + 2 phase (01-retro gstack invoke + 02-persist
+  RETROSPECTIVE.md sink)。Triggered by harnessed CLI `harnessed retro --milestone <name>` or
+  slash command `/retro` after `harnessed setup`.
+trigger_phrases:
+  - "项目总结"
+  - "里程碑结束"
+  - "经验教训"
+  - "retro"
+---
+
+# retro 工作流 (v3 新增 standalone)
+
+## 概述
+
+2 阶段 standalone 工作流，将 CLAUDE.md 中"项目 / 里程碑结束: 可选跑 /retro 总结"映射到
+harnessed 运行时（Phase v3.0-3.4 W1.2 — D-04 新增 v3 standalone 工作流 + Pattern A E.2
+retro-gstack alias suffix LOCK）。
+
+| phase | id | upstream | model | capability / invokes | artifacts |
+| ----- | -- | -------- | ----- | -------------------- | --------- |
+| 1 | `01-retro` | gstack | opus | `{{ capabilities.retro-gstack.cmd }}` | gstack /retro 经验教训系统总结 |
+| 2 | `02-persist` | planning-with-files | haiku | `{{ capabilities.planning-with-files.cmd }}` + `invokes: /plan` | `artifacts_expected: [RETROSPECTIVE.md]` |
+
+每阶段配置从 `workflows/retro/workflow.yaml` 加载；引擎 spawn 阶段 01 gstack
+`/retro`（alias 解析到 capabilities.yaml 中的 retro-gstack 载体），阶段 02
+planning-with-files `/plan` invoke 持久化 RETROSPECTIVE.md sink。
+
+## Capability refs (Pattern A E.2 LOCK)
+
+Sister `workflows/capabilities.yaml` 条目：
+- `retro-gstack` — Bucket 7 gstack optional **alias suffix** per Pattern A E.2 LOCK
+  (impl: gstack, cmd: /retro, aliases to harnessed-bundled /retro, fires_when: is_milestone_close)
+  — 解决 namespace 冲突 (NOT bare `retro` capability 因 standalone workflow 已占 retro 名)
+- `planning-with-files` — Bucket 4 核心能力 (impl: claude-code-plugin, cmd: /plan)
+
+## 路由规则（sister CLAUDE.md"项目 / 里程碑结束"）
+
+- ✅ **触发**: 项目结束 / 里程碑结束 / 用户明示"复盘 / retro / lessons learned"
+- ❌ **跳过**: 日常 PR / 单阶段完成（常规 verify-progress 已够用）
+
+## 如何调用
+
+使用 Bash 工具运行：
+
+```bash
+echo "$ARGUMENTS" | harnessed run retro --task-stdin
+```
+
+如果 `$ARGUMENTS` 为空，运行 `harnessed run retro`（不带 stdin pipe）。
+
+完成后，Bash 输出会在 stderr 打印 `Next:` 提示，建议下一个阶段。根据对话上下文决定是否调用 — 该提示仅供参考，不作强制指引。
+
+<!-- harnessed-generated:v3.4.4 -->
+
+## 参考文档
+
+- D-04 新增 v3 standalone 工作流 (research v3 bump + retro 新增)
+- Pattern A E.2 LOCK — 2 个 alias suffix `-gstack` 解决 namespace 冲突 (retro-gstack + investigate-gstack)
+- Pattern A reconcile D.2 — gstack 30 optional naming bare 例外
+- workflows/capabilities.yaml — retro-gstack (alias suffix) + planning-with-files
+- workflows/defaults.yaml — ralph_max_iterations.retro.* values (W2.2 backfill)
+- sister Phase v2.0-2.5 RETROSPECTIVE.md sink pattern