harnessed 3.4.0 → 3.4.2

package/dist/index.mjs

@@ -1,6 +1,6 @@
 // package.json
 var package_default = {
-  version: "3.4.0"};
+  version: "3.4.2"};
 
 // src/index.ts
 var VERSION = package_default.version;

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../package.json","../src/index.ts"],"names":[],"mappings":";AAAA,IAAA,eAAA,GAAA;AAAA,EAEE,OAAA,EAAW,OA8Fb,CAAA;;;AC3FO,IAAM,UAAU,eAAA,CAAI","file":"index.mjs","sourcesContent":["{\n  \"name\": \"harnessed\",\n  \"version\": \"3.4.0\",\n  \"description\": \"AI coding harness package manager + composition orchestrator\",\n  \"type\": \"module\",\n  \"license\": \"Apache-2.0\",\n  \"author\": \"easyinplay\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/easyinplay/harnessed.git\"\n  },\n  \"homepage\": \"https://github.com/easyinplay/harnessed#readme\",\n  \"bugs\": \"https://github.com/easyinplay/harnessed/issues\",\n  \"keywords\": [\n    \"claude-code\",\n    \"ai-harness\",\n    \"package-manager\",\n    \"composition\",\n    \"skill-pack\",\n    \"mcp\",\n    \"orchestrator\"\n  ],\n  \"engines\": {\n    \"node\": \">=22.0.0\"\n  },\n  \"packageManager\": \"pnpm@10.12.0\",\n  \"bin\": {\n    \"harnessed\": \"./dist/cli.mjs\"\n  },\n  \"main\": \"./dist/index.mjs\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.mjs\",\n      \"default\": \"./dist/index.mjs\"\n    },\n    \"./schemas\": {\n      \"types\": \"./dist/schemas/index.d.ts\",\n      \"import\": \"./dist/schemas/index.mjs\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"dist\",\n    \"manifests\",\n    \"workflows\",\n    \"routing\",\n    \"config-templates\",\n    \"schemas\",\n    \"README.md\",\n    \"LICENSE\",\n    \"NOTICE\"\n  ],\n  \"scripts\": {\n    \"dev\": \"tsup --watch\",\n    \"build\": \"tsc --noEmit && tsup\",\n    \"build:schema\": \"node ./scripts/build-schema.mjs\",\n    \"validate:schema\": \"node ./scripts/validate-schema.mjs\",\n    \"typecheck\": \"tsc --noEmit\",\n    \"test\": \"vitest run --passWithNoTests\",\n    \"test:watch\": \"vitest\",\n    \"test:coverage\": \"vitest run --coverage --passWithNoTests\",\n    \"bench\": \"vitest bench --run\",\n    \"lint\": \"biome check .\",\n    \"lint:fix\": \"biome check --write .\",\n    \"format\": \"biome format --write .\"\n  },\n  \"dependencies\": {\n    \"@anthropic-ai/claude-agent-sdk\": \"0.3.142\",\n    \"@clack/prompts\": \"^0.10.1\",\n    \"@sinclair/typebox\": \"^0.34.49\",\n    \"ajv\": \"^8.20.0\",\n    \"ajv-errors\": \"^3.0.0\",\n    \"ajv-formats\": \"^3.0.1\",\n    \"commander\": \"^13.0.0\",\n    \"diff\": \"^9.0.0\",\n    \"expr-eval\": \"^2.0.2\",\n    \"picocolors\": \"^1.1.1\",\n    \"proper-lockfile\": \"^4.1.2\",\n    \"yaml\": \"^2.9.0\"\n  },\n  \"devDependencies\": {\n    \"@biomejs/biome\": \"^2.0.0\",\n    \"@types/node\": \"^22.10.0\",\n    \"@types/proper-lockfile\": \"^4.1.4\",\n    \"@vitest/coverage-v8\": \"^4.0.0\",\n    \"tsup\": \"^8.3.0\",\n    \"typescript\": \"^5.6.0\",\n    \"vitest\": \"^4.0.0\"\n  },\n  \"pnpm\": {\n    \"onlyBuiltDependencies\": [\n      \"esbuild\"\n    ]\n  }\n}\n","// Main library entry — re-exports public APIs.\n// phase 1.1 batch 1: skeleton only; schema validator wired in batch 2 (T3+).\n\nimport pkg from '../package.json' with { type: 'json' }\n\nexport const VERSION = pkg.version\n"]}
+{"version":3,"sources":["../package.json","../src/index.ts"],"names":[],"mappings":";AAAA,IAAA,eAAA,GAAA;AAAA,EAEE,OAAA,EAAW,OA8Fb,CAAA;;;AC3FO,IAAM,UAAU,eAAA,CAAI","file":"index.mjs","sourcesContent":["{\n  \"name\": \"harnessed\",\n  \"version\": \"3.4.2\",\n  \"description\": \"AI coding harness package manager + composition orchestrator\",\n  \"type\": \"module\",\n  \"license\": \"Apache-2.0\",\n  \"author\": \"easyinplay\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/easyinplay/harnessed.git\"\n  },\n  \"homepage\": \"https://github.com/easyinplay/harnessed#readme\",\n  \"bugs\": \"https://github.com/easyinplay/harnessed/issues\",\n  \"keywords\": [\n    \"claude-code\",\n    \"ai-harness\",\n    \"package-manager\",\n    \"composition\",\n    \"skill-pack\",\n    \"mcp\",\n    \"orchestrator\"\n  ],\n  \"engines\": {\n    \"node\": \">=22.0.0\"\n  },\n  \"packageManager\": \"pnpm@10.12.0\",\n  \"bin\": {\n    \"harnessed\": \"./dist/cli.mjs\"\n  },\n  \"main\": \"./dist/index.mjs\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.mjs\",\n      \"default\": \"./dist/index.mjs\"\n    },\n    \"./schemas\": {\n      \"types\": \"./dist/schemas/index.d.ts\",\n      \"import\": \"./dist/schemas/index.mjs\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"dist\",\n    \"manifests\",\n    \"workflows\",\n    \"routing\",\n    \"config-templates\",\n    \"schemas\",\n    \"README.md\",\n    \"LICENSE\",\n    \"NOTICE\"\n  ],\n  \"scripts\": {\n    \"dev\": \"tsup --watch\",\n    \"build\": \"tsc --noEmit && tsup\",\n    \"build:schema\": \"node ./scripts/build-schema.mjs\",\n    \"validate:schema\": \"node ./scripts/validate-schema.mjs\",\n    \"typecheck\": \"tsc --noEmit\",\n    \"test\": \"vitest run --passWithNoTests\",\n    \"test:watch\": \"vitest\",\n    \"test:coverage\": \"vitest run --coverage --passWithNoTests\",\n    \"bench\": \"vitest bench --run\",\n    \"lint\": \"biome check .\",\n    \"lint:fix\": \"biome check --write .\",\n    \"format\": \"biome format --write .\"\n  },\n  \"dependencies\": {\n    \"@anthropic-ai/claude-agent-sdk\": \"0.3.142\",\n    \"@clack/prompts\": \"^0.10.1\",\n    \"@sinclair/typebox\": \"^0.34.49\",\n    \"ajv\": \"^8.20.0\",\n    \"ajv-errors\": \"^3.0.0\",\n    \"ajv-formats\": \"^3.0.1\",\n    \"commander\": \"^13.0.0\",\n    \"diff\": \"^9.0.0\",\n    \"expr-eval\": \"^2.0.2\",\n    \"picocolors\": \"^1.1.1\",\n    \"proper-lockfile\": \"^4.1.2\",\n    \"yaml\": \"^2.9.0\"\n  },\n  \"devDependencies\": {\n    \"@biomejs/biome\": \"^2.0.0\",\n    \"@types/node\": \"^22.10.0\",\n    \"@types/proper-lockfile\": \"^4.1.4\",\n    \"@vitest/coverage-v8\": \"^4.0.0\",\n    \"tsup\": \"^8.3.0\",\n    \"typescript\": \"^5.6.0\",\n    \"vitest\": \"^4.0.0\"\n  },\n  \"pnpm\": {\n    \"onlyBuiltDependencies\": [\n      \"esbuild\"\n    ]\n  }\n}\n","// Main library entry — re-exports public APIs.\n// phase 1.1 batch 1: skeleton only; schema validator wired in batch 2 (T3+).\n\nimport pkg from '../package.json' with { type: 'json' }\n\nexport const VERSION = pkg.version\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harnessed",
-  "version": "3.4.0",
+  "version": "3.4.2",
   "description": "AI coding harness package manager + composition orchestrator",
   "type": "module",
   "license": "Apache-2.0",

package/workflows/capabilities.yaml

@@ -36,6 +36,8 @@ capabilities:
 
   grill-with-docs:
     impl: mattpocock-skills
+    install_type: user-skill
+    skill_dir: grill-with-docs
     cmd: /grill-with-docs
     since: v2.0
     category: tool-slash-cmd
@@ -45,6 +47,8 @@ capabilities:
 
   zoom-out:
     impl: mattpocock-skills
+    install_type: user-skill
+    skill_dir: zoom-out
     cmd: /zoom-out
     since: v2.0
     category: tool-slash-cmd
@@ -54,6 +58,8 @@ capabilities:
 
   diagnose:
     impl: mattpocock-skills
+    install_type: user-skill
+    skill_dir: diagnose
     cmd: /diagnose
     since: v2.0
     category: tool-slash-cmd
@@ -63,7 +69,14 @@ capabilities:
       - subtask.type == 'debug'
 
   caveman:
-    impl: mattpocock-skills
+    # v3.4.2: dual-install ("互为补充") — caveman ships BOTH as user-skill
+    # (git clone caveman repo into ~/.claude/skills/caveman/) AND as Claude Code
+    # plugin (`caveman@caveman` in installed_plugins.json). Resolver detects
+    # either; emits combined warning only if BOTH are missing.
+    impl: caveman
+    install_type: [user-skill, plugin]
+    skill_dir: caveman
+    plugin_id: caveman
     cmd: /caveman
     since: v2.0
     category: tool-slash-cmd
@@ -73,6 +86,8 @@ capabilities:
 
   grill-me:
     impl: mattpocock-skills
+    install_type: user-skill
+    skill_dir: grill-me
     cmd: /grill-me
     since: v2.0
     category: tool-slash-cmd
@@ -82,6 +97,8 @@ capabilities:
 
   to-prd:
     impl: mattpocock-skills
+    install_type: user-skill
+    skill_dir: to-prd
     cmd: /to-prd
     since: v2.0
     category: tool-slash-cmd
@@ -91,6 +108,8 @@ capabilities:
 
   to-issues:
     impl: mattpocock-skills
+    install_type: user-skill
+    skill_dir: to-issues
     cmd: /to-issues
     since: v2.0
     category: tool-slash-cmd
@@ -100,6 +119,8 @@ capabilities:
 
   improve-codebase-architecture:
     impl: mattpocock-skills
+    install_type: user-skill
+    skill_dir: improve-codebase-architecture
     cmd: /improve-codebase-architecture
     since: v2.0
     category: tool-slash-cmd
@@ -107,8 +128,11 @@ capabilities:
     fires_when:
       - phase.architecture_health_audit == true
 
+  # v3.4.2 fix: code-review is a claude-plugins-official PLUGIN (not mattpocock).
   code-review:
-    impl: mattpocock-skills
+    impl: plugin
+    install_type: plugin
+    plugin_id: code-review
     cmd: /code-review
     since: v2.0
     category: tool-slash-cmd
@@ -116,8 +140,11 @@ capabilities:
     fires_when:
       - phase.stage == 'verify'
 
+  # v3.4.2 fix: code-simplifier is a claude-plugins-official PLUGIN (not mattpocock).
   code-simplifier:
-    impl: mattpocock-skills
+    impl: plugin
+    install_type: plugin
+    plugin_id: code-simplifier
     cmd: /code-simplifier
     since: v2.0
     category: tool-slash-cmd
@@ -127,6 +154,8 @@ capabilities:
 
   investigate:
     impl: mattpocock-skills
+    install_type: user-skill
+    skill_dir: investigate
     cmd: /investigate
     since: v2.0
     category: tool-slash-cmd
@@ -142,8 +171,11 @@ capabilities:
   # Bucket 2 — special-purpose tools 13 (per D-14 + RESEARCH § 2.2)
   # ============================================================================
 
+  # v3.4.2 fix: ui-ux-pro-max is a marketplace PLUGIN (ui-ux-pro-max-skill), not gstack.
   ui-ux-pro-max:
-    impl: gstack
+    impl: plugin
+    install_type: plugin
+    plugin_id: ui-ux-pro-max
     cmd: /ui-ux-pro-max
     since: v2.0
     category: tool-slash-cmd
@@ -152,8 +184,11 @@ capabilities:
       - phase.has_ui_changes == true
       - subtask.type == 'ui_polish'
 
+  # v3.4.2 fix: frontend-design is a claude-plugins-official PLUGIN, not gstack.
   frontend-design:
-    impl: gstack
+    impl: plugin
+    install_type: plugin
+    plugin_id: frontend-design
     cmd: /frontend-design
     since: v2.0
     category: tool-slash-cmd
@@ -181,6 +216,8 @@ capabilities:
 
   webapp-testing:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /webapp-testing
     since: v2.0
     category: tool-bundled-skill
@@ -226,6 +263,8 @@ capabilities:
 
   gsd-discuss-phase:
     impl: gsd
+    install_type: user-skill
+    skill_dir: gsd-discuss-phase
     cmd: /gsd-discuss-phase
     since: v2.0
     category: tool-slash-cmd
@@ -235,6 +274,8 @@ capabilities:
 
   gsd-plan-phase:
     impl: gsd
+    install_type: user-skill
+    skill_dir: gsd-plan-phase
     cmd: /gsd-plan-phase
     since: v2.0
     category: tool-slash-cmd
@@ -244,6 +285,8 @@ capabilities:
 
   gsd-review:
     impl: gsd
+    install_type: user-skill
+    skill_dir: gsd-review
     cmd: /gsd-review
     since: v2.0
     category: tool-slash-cmd
@@ -253,6 +296,8 @@ capabilities:
 
   gsd-debug:
     impl: gsd
+    install_type: user-skill
+    skill_dir: gsd-debug
     cmd: /gsd-debug
     since: v2.0
     category: tool-slash-cmd
@@ -264,6 +309,8 @@ capabilities:
 
   gsd-progress:
     impl: gsd
+    install_type: user-skill
+    skill_dir: gsd-progress
     cmd: /gsd-progress
     since: v2.0
     category: tool-slash-cmd
@@ -273,6 +320,8 @@ capabilities:
 
   gsd-verify-work:
     impl: gsd
+    install_type: user-skill
+    skill_dir: gsd-verify-work
     cmd: /gsd-verify-work
     since: v2.0
     category: tool-slash-cmd
@@ -286,6 +335,8 @@ capabilities:
 
   gstack-office-hours:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /office-hours
     since: v2.0
     category: tool-slash-cmd
@@ -295,6 +346,8 @@ capabilities:
 
   gstack-plan-ceo-review:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /plan-ceo-review
     since: v2.0
     category: tool-slash-cmd
@@ -304,6 +357,8 @@ capabilities:
 
   gstack-review:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /review
     since: v2.0
     category: tool-slash-cmd
@@ -313,6 +368,8 @@ capabilities:
 
   gstack-qa:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /qa
     since: v2.0
     category: tool-slash-cmd
@@ -322,6 +379,8 @@ capabilities:
 
   gstack-cso:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /cso
     since: v2.0
     category: tool-slash-cmd
@@ -331,6 +390,8 @@ capabilities:
 
   gstack-design-review:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /design-review
     since: v2.0
     category: tool-slash-cmd
@@ -363,6 +424,8 @@ capabilities:
   # cmd `/plan` invocation → plugin 真生成 3 file 持久化, NOT fs.writeFile self-impl。
   planning-with-files:
     impl: claude-code-plugin
+    install_type: plugin
+    plugin_id: planning-with-files
     cmd: /plan
     since: v2.0
     category: tool-plugin
@@ -378,9 +441,13 @@ capabilities:
       - phase.stage == 'plan' AND phase.requires_persisted_plan == true
 
   # D-10: ralph-loop 真接 SDK wrapper (NOT mock reference; sister Phase 2.2 v0.2.0 ship)
+  # v3.4.2: ralph-loop is a claude-plugins-official plugin; cmd is the bare `/ralph-loop`
+  # (verified: ralph-loop@claude-plugins-official in installed_plugins.json).
   ralph-loop:
-    impl: bundled-skill
-    cmd: ralph-loop
+    impl: plugin
+    install_type: plugin
+    plugin_id: ralph-loop
+    cmd: /ralph-loop
     since: v2.0
     category: tool-bundled-skill
     description: Sub-task completion gate (verbatim COMPLETE; max-iterations fallback)
@@ -521,6 +588,8 @@ capabilities:
 
   autoplan:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /autoplan
     since: v3.0
     category: tool-slash-cmd
@@ -530,6 +599,8 @@ capabilities:
 
   codex:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /codex
     since: v3.0
     category: tool-slash-cmd
@@ -539,6 +610,8 @@ capabilities:
 
   design-shotgun:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /design-shotgun
     since: v3.0
     category: tool-slash-cmd
@@ -548,6 +621,8 @@ capabilities:
 
   design-html:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /design-html
     since: v3.0
     category: tool-slash-cmd
@@ -557,6 +632,8 @@ capabilities:
 
   design-consultation:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /design-consultation
     since: v3.0
     category: tool-slash-cmd
@@ -566,6 +643,8 @@ capabilities:
 
   plan-design-review:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /plan-design-review
     since: v3.0
     category: tool-slash-cmd
@@ -575,6 +654,8 @@ capabilities:
 
   plan-devex-review:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /plan-devex-review
     since: v3.0
     category: tool-slash-cmd
@@ -584,6 +665,8 @@ capabilities:
 
   plan-eng-review:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /plan-eng-review
     since: v3.0
     category: tool-slash-cmd
@@ -593,6 +676,8 @@ capabilities:
 
   plan-tune:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /plan-tune
     since: v3.0
     category: tool-slash-cmd
@@ -602,6 +687,8 @@ capabilities:
 
   context-save:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /context-save
     since: v3.0
     category: tool-slash-cmd
@@ -611,6 +698,8 @@ capabilities:
 
   context-restore:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /context-restore
     since: v3.0
     category: tool-slash-cmd
@@ -620,6 +709,8 @@ capabilities:
 
   qa-only:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /qa-only
     since: v3.0
     category: tool-slash-cmd
@@ -629,6 +720,8 @@ capabilities:
 
   devex-review:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /devex-review
     since: v3.0
     category: tool-slash-cmd
@@ -638,6 +731,8 @@ capabilities:
 
   benchmark:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /benchmark
     since: v3.0
     category: tool-slash-cmd
@@ -647,6 +742,8 @@ capabilities:
 
   browse:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /browse
     since: v3.0
     category: tool-slash-cmd
@@ -656,6 +753,8 @@ capabilities:
 
   open-gstack-browser:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /open-gstack-browser
     since: v3.0
     category: tool-slash-cmd
@@ -665,6 +764,8 @@ capabilities:
 
   connect-chrome:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /connect-chrome
     since: v3.x
     category: tool-slash-cmd
@@ -674,6 +775,8 @@ capabilities:
 
   setup-browser-cookies:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /setup-browser-cookies
     since: v3.0
     category: tool-slash-cmd
@@ -683,6 +786,8 @@ capabilities:
 
   ship:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /ship
     since: v3.0
     category: tool-slash-cmd
@@ -693,6 +798,8 @@ capabilities:
 
   land-and-deploy:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /land-and-deploy
     since: v3.0
     category: tool-slash-cmd
@@ -702,6 +809,8 @@ capabilities:
 
   setup-deploy:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /setup-deploy
     since: v3.0
     category: tool-slash-cmd
@@ -711,6 +820,8 @@ capabilities:
 
   setup-gbrain:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /setup-gbrain
     since: v3.0
     category: tool-slash-cmd
@@ -720,6 +831,8 @@ capabilities:
 
   canary:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /canary
     since: v3.0
     category: tool-slash-cmd
@@ -729,6 +842,8 @@ capabilities:
 
   document-release:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /document-release
     since: v3.0
     category: tool-slash-cmd
@@ -738,6 +853,8 @@ capabilities:
 
   document-generate:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /document-generate
     since: v3.0
     category: tool-slash-cmd
@@ -747,6 +864,8 @@ capabilities:
 
   careful:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /careful
     since: v3.0
     category: tool-slash-cmd
@@ -757,6 +876,8 @@ capabilities:
 
   guard:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /guard
     since: v3.0
     category: tool-slash-cmd
@@ -766,6 +887,8 @@ capabilities:
 
   freeze:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /freeze
     since: v3.0
     category: tool-slash-cmd
@@ -775,6 +898,8 @@ capabilities:
 
   unfreeze:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /unfreeze
     since: v3.0
     category: tool-slash-cmd
@@ -784,6 +909,8 @@ capabilities:
 
   gstack-upgrade:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /gstack-upgrade
     since: v3.0
     category: tool-slash-cmd
@@ -793,6 +920,8 @@ capabilities:
 
   learn:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /learn
     since: v3.0
     category: tool-slash-cmd
@@ -802,6 +931,8 @@ capabilities:
 
   health:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /health
     since: v3.0
     category: tool-slash-cmd
@@ -811,6 +942,8 @@ capabilities:
 
   make-pdf:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /make-pdf
     since: v3.0
     category: tool-slash-cmd
@@ -821,6 +954,8 @@ capabilities:
   # 2 alias suffix `-gstack` (避免命名冲突 per Pattern A E.2)
   retro-gstack:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /retro
     since: v3.0
     category: tool-slash-cmd
@@ -832,6 +967,8 @@ capabilities:
 
   investigate-gstack:
     impl: gstack
+    install_type: user-skill
+    skill_dir: gstack
     cmd: /investigate
     since: v3.0
     category: tool-slash-cmd
@@ -872,6 +1009,8 @@ capabilities:
 
   gsd-research-phase:
     impl: gsd
+    install_type: user-skill
+    skill_dir: gsd-research-phase
     cmd: /gsd-research-phase
     since: v3.0
     category: tool-slash-cmd

package/workflows/discuss/phase/SKILL.md

@@ -52,6 +52,17 @@ Sister `workflows/judgments/phase-gate.yaml`:
 - < 1 天工作量
 - bug 修复且已有最小复现
 
+## How to invoke
+
+Use the SlashCommand tool to run: `{{ capabilities.gsd-discuss-phase.cmd }}`
+
+(If a `⚠️ ... not installed` warning was printed by `harnessed setup`, the backing
+capability is missing on disk. Install it (`claude plugin install <name>` for
+plugins, or follow the official install instructions for user-skills — e.g. for
+gstack: `git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack` then
+`cd ~/.claude/skills/gstack && ./setup`), then re-run `harnessed setup` to re-render
+this SKILL.md and clear the warning.)
+
 ## References
 
 - D-04 Stage ① Discuss 三层 (战略 / phase / 子任务)

package/workflows/discuss/strategic/SKILL.md

@@ -56,6 +56,17 @@ Sister `workflows/judgments/strategic-gate.yaml`:
 - continuing 已有 phase 的执行
 - 用户已给明确 ticket / spec
 
+## How to invoke
+
+Use the SlashCommand tool to run: `{{ capabilities.gstack-office-hours.cmd }}`
+
+(If a `⚠️ ... not installed` warning was printed by `harnessed setup`, the backing
+capability is missing on disk. Install it (`claude plugin install <name>` for
+plugins, or follow the official install instructions for user-skills — e.g. for
+gstack: `git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack` then
+`cd ~/.claude/skills/gstack && ./setup`), then re-run `harnessed setup` to re-render
+this SKILL.md and clear the warning.)
+
 ## References
 
 - D-04 Stage ① Discuss 三层 (战略 / phase / 子任务)

package/workflows/discuss/subtask/SKILL.md

@@ -57,6 +57,17 @@ Sister `workflows/judgments/subtask-gate.yaml`:
 - 标准库直接调用
 - bug 修复且已知根因
 
+## How to invoke
+
+Use the SlashCommand tool to run: `{{ capabilities.superpowers-brainstorming.cmd }}`
+
+(If a `⚠️ ... not installed` warning was printed by `harnessed setup`, the backing
+capability is missing on disk. Install it (`claude plugin install <name>` for
+plugins, or follow the official install instructions for user-skills — e.g. for
+gstack: `git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack` then
+`cd ~/.claude/skills/gstack && ./setup`), then re-run `harnessed setup` to re-render
+this SKILL.md and clear the warning.)
+
 ## References
 
 - D-04 Stage ① Discuss 三层 (战略 / phase / 子任务)

package/workflows/plan/architecture/SKILL.md

@@ -53,6 +53,17 @@ trigger `is-complex-architecture` 重构 ref。
 - 性能 / scaling 关键路径
 - 引入显著技术债 / migration 风险
 
+## How to invoke
+
+Use the SlashCommand tool to run: `{{ capabilities.plan-eng-review.cmd }}`
+
+(If a `⚠️ ... not installed` warning was printed by `harnessed setup`, the backing
+capability is missing on disk. Install it (`claude plugin install <name>` for
+plugins, or follow the official install instructions for user-skills — e.g. for
+gstack: `git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack` then
+`cd ~/.claude/skills/gstack && ./setup`), then re-run `harnessed setup` to re-render
+this SKILL.md and clear the warning.)
+
 ## References
 
 - D-04 Stage ② Plan 二层 (架构 / 计划)