harnessed 2.0.1 → 3.0.1

package/workflows/capabilities.yaml

@@ -38,6 +38,7 @@ capabilities:
     impl: mattpocock-skills
     cmd: /grill-with-docs
     since: v2.0
+    category: tool-slash-cmd
     description: 规格澄清 with docs (fires when phase.spec_ambiguous == true)
     fires_when:
       - phase.spec_ambiguous == true
@@ -46,6 +47,7 @@ capabilities:
     impl: mattpocock-skills
     cmd: /zoom-out
     since: v2.0
+    category: tool-slash-cmd
     description: 陌生模块导航 (fires when subtask.unfamiliar_module == true)
     fires_when:
       - subtask.unfamiliar_module == true
@@ -54,6 +56,7 @@ capabilities:
     impl: mattpocock-skills
     cmd: /diagnose
     since: v2.0
+    category: tool-slash-cmd
     description: 系统化排错 (fires when test_fail OR debug context)
     fires_when:
       - subtask.test_fail == true
@@ -63,6 +66,7 @@ capabilities:
     impl: mattpocock-skills
     cmd: /caveman
     since: v2.0
+    category: tool-slash-cmd
     description: token 紧张时 surgical edit (fires when token_tight == true)
     fires_when:
       - subtask.token_tight == true
@@ -71,6 +75,7 @@ capabilities:
     impl: mattpocock-skills
     cmd: /grill-me
     since: v2.0
+    category: tool-slash-cmd
     description: 反向追问 (fires when spec_ambiguous AND no_docs)
     fires_when:
       - phase.spec_ambiguous == true AND phase.no_docs == true
@@ -79,6 +84,7 @@ capabilities:
     impl: mattpocock-skills
     cmd: /to-prd
     since: v2.0
+    category: tool-slash-cmd
     description: translate idea → PRD (fires when phase.translate_idea_to_prd == true)
     fires_when:
       - phase.translate_idea_to_prd == true
@@ -87,6 +93,7 @@ capabilities:
     impl: mattpocock-skills
     cmd: /to-issues
     since: v2.0
+    category: tool-slash-cmd
     description: translate PRD → issues (fires when phase.translate_prd_to_issues == true)
     fires_when:
       - phase.translate_prd_to_issues == true
@@ -95,6 +102,7 @@ capabilities:
     impl: mattpocock-skills
     cmd: /improve-codebase-architecture
     since: v2.0
+    category: tool-slash-cmd
     description: architecture health audit (fires when phase.architecture_health_audit == true)
     fires_when:
       - phase.architecture_health_audit == true
@@ -103,6 +111,7 @@ capabilities:
     impl: mattpocock-skills
     cmd: /code-review
     since: v2.0
+    category: tool-slash-cmd
     description: verify-work parallel fan-out (multi-agent high-confidence findings)
     fires_when:
       - phase.stage == 'verify'
@@ -111,6 +120,7 @@ capabilities:
     impl: mattpocock-skills
     cmd: /code-simplifier
     since: v2.0
+    category: tool-slash-cmd
     description: verify-work tail step (移除重复、多余逻辑)
     fires_when:
       - phase.stage == 'verify' AND phase.is_final_step == true
@@ -119,6 +129,7 @@ capabilities:
     impl: mattpocock-skills
     cmd: /investigate
     since: v2.0
+    category: tool-slash-cmd
     description: gstack-routed bug investigation (fires when bug_root_cause_unknown)
     fires_when:
       - subtask.bug_root_cause_unknown == true
@@ -135,6 +146,7 @@ capabilities:
     impl: gstack
     cmd: /ui-ux-pro-max
     since: v2.0
+    category: tool-slash-cmd
     description: UI/UX 默认主方案 数据驱动 (per ~/.claude/rules/web-design.md L5)
     fires_when:
       - phase.has_ui_changes == true
@@ -144,6 +156,7 @@ capabilities:
     impl: gstack
     cmd: /frontend-design
     since: v2.0
+    category: tool-slash-cmd
     description: UI 创意/装饰补充 (per ~/.claude/rules/web-design.md L11)
     fires_when:
       - phase.has_ui_changes == true AND phase.requires_creative_polish == true
@@ -152,6 +165,7 @@ capabilities:
     impl: npm-cli
     cmd: playwright
     since: v2.0
+    category: tool-bundled-skill
     description: AI 实时操作浏览器 一行 Bash (per ~/.claude/rules/web-testing.md L8 手)
     fires_when:
       - subtask.type == 'browser_probe'
@@ -160,6 +174,7 @@ capabilities:
     impl: npm-cli
     cmd: "@playwright/test"
     since: v2.0
+    category: tool-plugin
     description: E2E test framework TypeScript (per ~/.claude/rules/web-testing.md L8 脑)
     fires_when:
       - subtask.type == 'e2e_test' AND subtask.language == 'typescript'
@@ -168,6 +183,7 @@ capabilities:
     impl: gstack
     cmd: /webapp-testing
     since: v2.0
+    category: tool-bundled-skill
     description: Python 后端联动 E2E (per ~/.claude/rules/web-testing.md L11 筋骨)
     fires_when:
       - subtask.type == 'e2e_test' AND subtask.language == 'python'
@@ -176,6 +192,7 @@ capabilities:
     impl: mcp
     cmd: chrome-devtools
     since: v2.0
+    category: tool-mcp
     description: 性能/a11y/内存泄漏诊断 (per ~/.claude/rules/web-testing.md L45 非功能性)
     fires_when:
       - subtask.type in ['perf_diagnose', 'a11y_audit', 'memory_leak']
@@ -184,6 +201,7 @@ capabilities:
     impl: cli
     cmd: ctx7
     since: v2.0
+    category: tool-cli
     description: 库 API/框架/SDK 文档抓取 (per ~/.claude/rules/context7.md)
     fires_when:
       - subtask.needs_library_docs == true
@@ -192,6 +210,7 @@ capabilities:
     impl: mcp
     cmd: tavily_search
     since: v2.0
+    category: tool-mcp
     description: Web 搜索默认 (关键词/库 API/时效) per ~/.claude/rules/web-search.md L17
     fires_when:
       - subtask.needs_web_search == true
@@ -200,6 +219,7 @@ capabilities:
     impl: mcp
     cmd: web_fetch_exa
     since: v2.0
+    category: tool-mcp
     description: 描述式/学术 Web 搜索 per ~/.claude/rules/web-search.md L24
     fires_when:
       - subtask.needs_web_search == true AND subtask.search_type in ['descriptive', 'academic']
@@ -208,6 +228,7 @@ capabilities:
     impl: gsd
     cmd: /gsd-discuss-phase
     since: v2.0
+    category: tool-slash-cmd
     description: GSD discuss-phase 灰色澄清 (Phase 层判据 sister judgments/phase-gate.yaml)
     fires_when:
       - phase.open_decisions >= 2 OR phase.scope_days > 1
@@ -216,6 +237,7 @@ capabilities:
     impl: gsd
     cmd: /gsd-plan-phase
     since: v2.0
+    category: tool-slash-cmd
     description: GSD plan-phase Wave A research + Wave B planner + Wave C plan-checker
     fires_when:
       - phase.stage == 'plan'
@@ -224,6 +246,7 @@ capabilities:
     impl: gsd
     cmd: /gsd-review
     since: v2.0
+    category: tool-slash-cmd
     description: GSD cross-AI peer review
     fires_when:
       - phase.stage == 'verify' AND phase.requires_peer_review == true
@@ -232,6 +255,7 @@ capabilities:
     impl: gsd
     cmd: /gsd-debug
     since: v2.0
+    category: tool-slash-cmd
     description: GSD systematic debugging (overlap with mattpocock /diagnose — alias)
     aliases:
       - { impl: mattpocock-skills, cmd: /diagnose }
@@ -242,6 +266,7 @@ capabilities:
     impl: gsd
     cmd: /gsd-progress
     since: v2.0
+    category: tool-slash-cmd
     description: GSD 状态同步 (verify-work serial after gsd-verify-work)
     fires_when:
       - phase.stage == 'verify'
@@ -250,6 +275,7 @@ capabilities:
     impl: gsd
     cmd: /gsd-verify-work
     since: v2.0
+    category: tool-slash-cmd
     description: verify-work entry (Stage ④ Verify 起点)
     fires_when:
       - phase.stage == 'verify'
@@ -262,6 +288,7 @@ capabilities:
     impl: gstack
     cmd: /office-hours
     since: v2.0
+    category: tool-slash-cmd
     description: 战略层产品理念/商业 scope 澄清 (sister CLAUDE.md "新功能启动前强制")
     fires_when:
       - phase.type in ['new_project', 'new_milestone', 'new_feature']
@@ -270,6 +297,7 @@ capabilities:
     impl: gstack
     cmd: /plan-ceo-review
     since: v2.0
+    category: tool-slash-cmd
     description: 战略评估 CEO 视角 (新功能启动前强制 sister CLAUDE.md)
     fires_when:
       - phase.type == 'new_feature' AND phase.has_business_decisions == true
@@ -278,6 +306,7 @@ capabilities:
     impl: gstack
     cmd: /review
     since: v2.0
+    category: tool-slash-cmd
     description: Paranoid Staff Engineer 视角 (关键模块 PR 前强制 sister CLAUDE.md)
     fires_when:
       - phase.is_critical_module == true
@@ -286,6 +315,7 @@ capabilities:
     impl: gstack
     cmd: /qa
     since: v2.0
+    category: tool-slash-cmd
     description: 端到端 QA 验收 (可选 conditional)
     fires_when:
       - phase.stage == 'verify' AND phase.has_ui_changes == true
@@ -294,6 +324,7 @@ capabilities:
     impl: gstack
     cmd: /cso
     since: v2.0
+    category: tool-slash-cmd
     description: 安全审查 OWASP/auth/secrets (可选 conditional)
     fires_when:
       - phase.stage == 'verify' AND phase.has_auth_or_secrets == true
@@ -302,6 +333,7 @@ capabilities:
     impl: gstack
     cmd: /design-review
     since: v2.0
+    category: tool-slash-cmd
     description: 设计系统一致性审查 + AI 审美问题识别 (可选 conditional)
     fires_when:
       - phase.stage == 'verify' AND phase.has_design_changes == true
@@ -315,6 +347,7 @@ capabilities:
     impl: superpowers
     cmd: "superpowers:test-driven-development"
     since: v2.0
+    category: tool-slash-cmd
     description: TDD red-green-refactor (gated by judgments/tdd-gate.yaml fires_when)
     aliases:
       - { impl: mattpocock-skills, cmd: /tdd }
@@ -332,6 +365,7 @@ capabilities:
     impl: claude-code-plugin
     cmd: /plan
     since: v2.0
+    category: tool-plugin
     description: Manus-style persistent markdown planning (Claude Code plugin slash cmd)
     requires:
       plugin: planning-with-files >=2.2.0
@@ -348,6 +382,7 @@ capabilities:
     impl: bundled-skill
     cmd: ralph-loop
     since: v2.0
+    category: tool-bundled-skill
     description: Sub-task completion gate (verbatim COMPLETE; max-iterations fallback)
     sdk_ref: src/routing/lib/ralphLoop.ts
     fires_when:
@@ -357,6 +392,7 @@ capabilities:
     impl: superpowers
     cmd: "superpowers:brainstorming"
     since: v2.0
+    category: tool-slash-cmd
     description: 子任务级澄清 multi-approach 探索 (gated by judgments/subtask-gate.yaml)
     fires_when:
       - subtask.approaches >= 2
@@ -383,6 +419,7 @@ capabilities:
     impl: claude-platform
     cmd: TeamCreate
     since: v2.0
+    category: agent-platform
     description: Agent Teams team 创建 (CC 2.1.133+ experimental; per agent-teams.md L7)
     requires:
       settings_env_var: env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS == "1"
@@ -398,6 +435,7 @@ capabilities:
     impl: claude-platform
     cmd: SendMessage
     since: v2.0
+    category: agent-platform
     description: Agent Teams teammate 间通信 (round-trip 已验证 2026-05-19)
     requires:
       settings_env_var: env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS == "1"
@@ -407,7 +445,437 @@ capabilities:
     impl: claude-platform
     cmd: TeamDelete
     since: v2.0
+    category: agent-platform
     description: Agent Teams cleanup (shutdown_request 之后 TeamDelete; sister agent-teams.md 防呆清单)
     requires:
       settings_env_var: env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS == "1"
       cc_version: ">=2.1.133"
+
+  # ============================================================================
+  # Bucket 6 — L0 Discipline Substrate behavioral ref (D-09 NEW v3, 6 entry)
+  # ============================================================================
+  #
+  # behavioral category entries 不 invoke slash cmd, 而是 ref workflows/disciplines/<basename>.yaml,
+  # workflow runtime pre-phase hook load discipline rules 应用 cross-cutting (per D-05 always-on)。
+  # Sentinel cmd value '<not-applicable-behavioral>' — runtime engine 检测 category=behavioral 时 SKIP
+  # cmd invoke, 改 load discipline_ref yaml + apply rules via hook。
+
+  karpathy-guidelines:
+    impl: harnessed-bundled
+    cmd: '<not-applicable-behavioral>'
+    since: v2.0
+    category: behavioral
+    description: 4 心法 + ≤200L hard limit + no-feature-creep + trust-internal-code + no-comments-default
+    discipline_ref: workflows/disciplines/karpathy.yaml
+
+  output-style-discipline:
+    impl: harnessed-bundled
+    cmd: '<not-applicable-behavioral>'
+    since: v3.0
+    category: behavioral
+    description: BLUF + no-sycophantic + no-emoji + no-em-dash + 量词精确 + no-end-recap + no-empty-continuation-question
+    discipline_ref: workflows/disciplines/output-style.yaml
+
+  language-convention:
+    impl: harnessed-bundled
+    cmd: '<not-applicable-behavioral>'
+    since: v3.0
+    category: behavioral
+    description: 默认简体中文 + 8 类强制保留英文原文 + 用户明示 lang_request 覆盖
+    discipline_ref: workflows/disciplines/language.yaml
+
+  operational-discipline:
+    impl: harnessed-bundled
+    cmd: '<not-applicable-behavioral>'
+    since: v3.0
+    category: behavioral
+    description: biome-preempt + A7 ADR 守恒 + no-push-without-approval + no-skip-hooks + destructive-ops-explicit + authorization-not-transitive
+    discipline_ref: workflows/disciplines/operational.yaml
+
+  priority-hierarchy:
+    impl: harnessed-bundled
+    cmd: '<not-applicable-behavioral>'
+    since: v3.0
+    category: behavioral
+    description: 7-tier priority hierarchy + multi-capability arbitration (gstack > gsd > superpowers > planning-with-files > karpathy > mattpocock > parallel)
+    discipline_ref: workflows/disciplines/priority.yaml
+
+  conceptual-protocols:
+    impl: harnessed-bundled
+    cmd: '<not-applicable-behavioral>'
+    since: v3.0
+    category: behavioral
+    description: cc-handoff Ideation→Onboarding + Plan→Execute + file-ownership-strict 跨 CC instance 协议
+    discipline_ref: workflows/disciplines/protocols.yaml
+
+  # ============================================================================
+  # Bucket 7 — gstack 33 optional registry-only (D-12 NEW v3)
+  # ============================================================================
+  #
+  # 33 gstack optional slash cmd — entry name 无 `gstack-` prefix per Pattern A E.2 LOCK
+  # (sister project CLAUDE.md gstack skill routing 直接 invoke cmd 名)。
+  # 例外 2 alias suffix `-gstack` 避免命名冲突:
+  #   - retro-gstack (alias to harnessed standalone /retro)
+  #   - investigate-gstack (alias to mattpocock investigate)
+  # carrier name 自带 `gstack` 字符串 (NOT prefix policy): open-gstack-browser, gstack-upgrade
+
+  autoplan:
+    impl: gstack
+    cmd: /autoplan
+    since: v3.0
+    category: tool-slash-cmd
+    description: 串联完整 review pipeline (office-hours + plan-ceo-review + plan-eng-review 等)
+    fires_when:
+      - phase.requires_full_review_pipeline == true
+
+  codex:
+    impl: gstack
+    cmd: /codex
+    since: v3.0
+    category: tool-slash-cmd
+    description: 第二意见 / cross-AI peer review via codex
+    fires_when:
+      - phase.stage == 'verify' AND phase.requires_second_opinion == true
+
+  design-shotgun:
+    impl: gstack
+    cmd: /design-shotgun
+    since: v3.0
+    category: tool-slash-cmd
+    description: 设计 variants 探索 (一次产出多版本 mockup)
+    fires_when:
+      - phase.has_design_changes == true AND phase.needs_variants == true
+
+  design-html:
+    impl: gstack
+    cmd: /design-html
+    since: v3.0
+    category: tool-slash-cmd
+    description: 设计 HTML mockup 生成 (throwaway 原型)
+    fires_when:
+      - phase.has_design_changes == true AND phase.needs_html_mockup == true
+
+  design-consultation:
+    impl: gstack
+    cmd: /design-consultation
+    since: v3.0
+    category: tool-slash-cmd
+    description: 设计咨询 / 品牌一致性顾问
+    fires_when:
+      - phase.has_design_changes == true AND phase.needs_brand_consult == true
+
+  plan-design-review:
+    impl: gstack
+    cmd: /plan-design-review
+    since: v3.0
+    category: tool-slash-cmd
+    description: 计划 phase 设计审查 (设计意图与可行性评估)
+    fires_when:
+      - phase.stage == 'plan' AND phase.has_design_changes == true
+
+  plan-devex-review:
+    impl: gstack
+    cmd: /plan-devex-review
+    since: v3.0
+    category: tool-slash-cmd
+    description: 计划 phase 开发体验审查 (DX/onboarding 视角)
+    fires_when:
+      - phase.stage == 'plan' AND phase.has_devex_concerns == true
+
+  plan-eng-review:
+    impl: gstack
+    cmd: /plan-eng-review
+    since: v3.0
+    category: tool-slash-cmd
+    description: 复杂架构审查 (engineering manager 视角, 锁定架构后再 plan-phase)
+    fires_when:
+      - phase.is_complex_architecture == true
+
+  plan-tune:
+    impl: gstack
+    cmd: /plan-tune
+    since: v3.0
+    category: tool-slash-cmd
+    description: 计划微调 (重新评估 plan 后细节调整)
+    fires_when:
+      - phase.stage == 'plan' AND phase.tune_required == true
+
+  context-save:
+    impl: gstack
+    cmd: /context-save
+    since: v3.0
+    category: tool-slash-cmd
+    description: 保存进度 / context handoff 准备
+    fires_when:
+      - user.explicit_signal includes 'save progress'
+
+  context-restore:
+    impl: gstack
+    cmd: /context-restore
+    since: v3.0
+    category: tool-slash-cmd
+    description: 恢复进度 / context restoration
+    fires_when:
+      - user.explicit_signal includes 'resume'
+
+  qa-only:
+    impl: gstack
+    cmd: /qa-only
+    since: v3.0
+    category: tool-slash-cmd
+    description: QA 报告 only mode (端到端测试但不修代码)
+    fires_when:
+      - phase.stage == 'verify' AND phase.has_ui_changes == true AND phase.report_only == true
+
+  devex-review:
+    impl: gstack
+    cmd: /devex-review
+    since: v3.0
+    category: tool-slash-cmd
+    description: 开发体验审查 (onboarding test / DX audit)
+    fires_when:
+      - phase.stage == 'verify' AND phase.has_devex_concerns == true
+
+  benchmark:
+    impl: gstack
+    cmd: /benchmark
+    since: v3.0
+    category: tool-slash-cmd
+    description: 性能基准 / page speed regression 检测
+    fires_when:
+      - phase.stage == 'verify' AND phase.has_perf_concerns == true
+
+  browse:
+    impl: gstack
+    cmd: /browse
+    since: v3.0
+    category: tool-slash-cmd
+    description: 浏览器自动化 / dogfooding (gstack 默认 browser cmd)
+    fires_when:
+      - subtask.needs_browser_automation == true
+
+  open-gstack-browser:
+    impl: gstack
+    cmd: /open-gstack-browser
+    since: v3.0
+    category: tool-slash-cmd
+    description: 启动 headed Chrome (gstack 集成 browser headed mode)
+    fires_when:
+      - subtask.needs_headed_browser == true
+
+  connect-chrome:
+    impl: gstack
+    cmd: /connect-chrome
+    since: v3.x
+    category: tool-slash-cmd
+    description: 连接现有 Chrome 实例 (用于 Chrome extension 测试) — defer v3.x per W1.1 K1 (gstack plugin 当前未 ship connect-chrome subdir)
+    fires_when:
+      - subtask.needs_chrome_extension == true
+
+  setup-browser-cookies:
+    impl: gstack
+    cmd: /setup-browser-cookies
+    since: v3.0
+    category: tool-slash-cmd
+    description: 导入 cookies 用于 authenticated browser 测试
+    fires_when:
+      - subtask.needs_authenticated_browser == true
+
+  ship:
+    impl: gstack
+    cmd: /ship
+    since: v3.0
+    category: tool-slash-cmd
+    description: 发版 / 创建 PR / deploy (用户 explicit 触发)
+    fires_when:
+      - user.explicit_signal includes 'ship'
+      - user.explicit_signal includes 'send it'
+
+  land-and-deploy:
+    impl: gstack
+    cmd: /land-and-deploy
+    since: v3.0
+    category: tool-slash-cmd
+    description: merge + deploy + verify 串联
+    fires_when:
+      - phase.stage == 'verify' AND phase.is_release_candidate == true
+
+  setup-deploy:
+    impl: gstack
+    cmd: /setup-deploy
+    since: v3.0
+    category: tool-slash-cmd
+    description: 配置 deployment (新项目 deploy infra setup)
+    fires_when:
+      - phase.type == 'new_project' AND phase.needs_deploy_config == true
+
+  setup-gbrain:
+    impl: gstack
+    cmd: /setup-gbrain
+    since: v3.0
+    category: tool-slash-cmd
+    description: 配置 gbrain 项目上下文 (gstack 项目知识库)
+    fires_when:
+      - phase.type == 'new_project' AND phase.needs_gbrain == true
+
+  canary:
+    impl: gstack
+    cmd: /canary
+    since: v3.0
+    category: tool-slash-cmd
+    description: post-deploy canary monitor / 错误率监控
+    fires_when:
+      - phase.stage == 'verify' AND phase.post_deploy_monitor == true
+
+  document-release:
+    impl: gstack
+    cmd: /document-release
+    since: v3.0
+    category: tool-slash-cmd
+    description: 发版后更新文档 (changelog / release notes)
+    fires_when:
+      - phase.is_release_candidate == true AND phase.needs_doc_update == true
+
+  document-generate:
+    impl: gstack
+    cmd: /document-generate
+    since: v3.0
+    category: tool-slash-cmd
+    description: 生成文档 (PDF / 报告)
+    fires_when:
+      - subtask.needs_pdf_doc == true
+
+  careful:
+    impl: gstack
+    cmd: /careful
+    since: v3.0
+    category: tool-slash-cmd
+    description: safety mode / 谨慎模式 (限制高风险操作)
+    fires_when:
+      - user.explicit_signal includes 'careful'
+      - user.explicit_signal includes 'guard mode'
+
+  guard:
+    impl: gstack
+    cmd: /guard
+    since: v3.0
+    category: tool-slash-cmd
+    description: guard mode (alias of careful, 限制 destructive ops)
+    fires_when:
+      - user.explicit_signal includes 'guard'
+
+  freeze:
+    impl: gstack
+    cmd: /freeze
+    since: v3.0
+    category: tool-slash-cmd
+    description: 限制编辑到特定目录 (防误改其他模块)
+    fires_when:
+      - user.explicit_signal includes 'freeze'
+
+  unfreeze:
+    impl: gstack
+    cmd: /unfreeze
+    since: v3.0
+    category: tool-slash-cmd
+    description: 解除 freeze 限制
+    fires_when:
+      - user.explicit_signal includes 'unfreeze'
+
+  gstack-upgrade:
+    impl: gstack
+    cmd: /gstack-upgrade
+    since: v3.0
+    category: tool-slash-cmd
+    description: 升级 gstack 自身 (carrier name 自带 gstack 字符串, NOT prefix policy)
+    fires_when:
+      - user.explicit_signal includes 'upgrade gstack'
+
+  learn:
+    impl: gstack
+    cmd: /learn
+    since: v3.0
+    category: tool-slash-cmd
+    description: 复盘 gstack 已学习到的项目 patterns
+    fires_when:
+      - user.explicit_signal includes 'what has gstack learned'
+
+  health:
+    impl: gstack
+    cmd: /health
+    since: v3.0
+    category: tool-slash-cmd
+    description: 项目健康检查 (gstack 整体诊断)
+    fires_when:
+      - user.explicit_signal includes 'health check'
+
+  make-pdf:
+    impl: gstack
+    cmd: /make-pdf
+    since: v3.0
+    category: tool-slash-cmd
+    description: 生成 PDF (文档 / 报告导出)
+    fires_when:
+      - subtask.needs_pdf_export == true
+
+  # 2 alias suffix `-gstack` (避免命名冲突 per Pattern A E.2)
+  retro-gstack:
+    impl: gstack
+    cmd: /retro
+    since: v3.0
+    category: tool-slash-cmd
+    description: gstack 复盘 (alias to harnessed standalone /retro, 解决 namespace 冲突)
+    aliases:
+      - { impl: harnessed-bundled, cmd: /retro }
+    fires_when:
+      - phase.is_milestone_close == true
+
+  investigate-gstack:
+    impl: gstack
+    cmd: /investigate
+    since: v3.0
+    category: tool-slash-cmd
+    description: gstack bug investigation (alias to mattpocock investigate, 解决 namespace 冲突)
+    aliases:
+      - { impl: mattpocock-skills, cmd: /investigate }
+    fires_when:
+      - subtask.bug_root_cause_unknown == true
+
+  # ============================================================================
+  # Bucket 8 — Supplementary v3 NEW (2 entry)
+  # ============================================================================
+
+  # K2 mitigation: parallelism-gate.yaml v2 SHIPPED 已 ref 但 capabilities.yaml v2 缺该 entry → v3 backfill 补
+  superpowers-subagent-driven-development:
+    impl: superpowers
+    cmd: "superpowers:subagent-driven-development"
+    since: v3.0
+    category: tool-slash-cmd
+    description: subagent 编排 (sister parallelism-gate.yaml v2 invokes 已 ref, v3 backfill K2)
+    fires_when:
+      - subtask.parallel_count <= 3
+      - subtask.communication_needed == false
+
+  # D-11 NEW google-workspace.yaml (gws CLI per ~/.claude/rules/google-workspace.md)
+  gws:
+    impl: cli
+    cmd: gws
+    since: v3.0
+    category: tool-cli
+    description: Google Workspace CLI (Gmail/Drive/Calendar/Sheets/Docs/Slides/Tasks/People/Chat/Forms/Keep/Meet/Classroom/Admin Reports)
+    fires_when:
+      - subtask.needs_google_workspace == true
+
+  # ============================================================================
+  # Bucket 9 — gsd-research-phase v3 NEW (W2 SHIPPED per CONTEXT D-08 + D-12)
+  # ============================================================================
+
+  gsd-research-phase:
+    impl: gsd
+    cmd: /gsd-research-phase
+    since: v3.0
+    category: tool-slash-cmd
+    description: GSD research-phase (Wave A 多 source 调研, sister D-08 cite Phase v3 W2 SHIPPED)
+    fires_when:
+      - phase.stage == 'research'
+      - phase.requires_multi_source_research == true