artifact-chain-assistant 0.9.4 → 0.10.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "artifact-chain-assistant",
-  "version": "0.9.4",
+  "version": "0.10.0",
   "description": "Artifact-chain intake, review/repair/batch/audit workflows, diagnostics, hooks, and version-lock maintenance helpers.",
   "author": {
     "name": "广州市风荷科技有限公司"

package/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "artifact-chain-assistant",
   "displayName": "Artifact Chain Assistant",
-  "version": "0.9.4",
+  "version": "0.10.0",
   "description": "Artifact-chain intake, review/repair/batch/audit workflows, diagnostics, and version-lock maintenance helpers.",
   "author": {
     "name": "广州市风荷科技有限公司"

package/.kimi-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "artifact-chain-assistant",
-  "version": "0.9.4",
+  "version": "0.10.0",
   "description": "Artifact-chain intake, review/repair/batch/audit workflows, diagnostics, and version-lock maintenance helpers.",
   "author": {
     "name": "广州市风荷科技有限公司"

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.10.0
+
+### Added
+
+- Added the product-owned setup runner and entry-discovery contract to every generated Codex,
+  Claude Code, and Kimi Code surface. Setup reports native-binding failures from structured doctor
+  output and keeps bootstrap behind explicit write authorization.
+
+### Changed
+
+- Aligned the existing 16-entry method catalog, generated host surfaces, and documentation with the
+  canonical `help`, `quickstart`, and `setup` entry semantics.
+- Runtime compatibility, installation commands, plugin manifests, Family API metadata, and adapter
+  catalogs are synchronized with `artifact-graph@0.10.0`.
+
+### Fixed
+
+- Entry skills resolve shared scripts from the installed plugin root. Their behavior no longer
+  depends on the target project's working directory or a parent-repository layout.
+
 ## 0.9.4
 
 ### Added

package/INSTALL.md

@@ -15,7 +15,7 @@ instructions.
 ## Prerequisites
 
 - Node.js `>=22.0.0`.
-- `artifact-graph` 0.9.4 installed in the target project.
+- `artifact-graph` 0.10.0 installed in the target project.
 - **GitHub SSH key** — Claude Code clones `source: github` entries over SSH by default. If you
   have not configured a GitHub SSH key, set `CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1` in your shell
   profile, or add the marketplace with an explicit `https://` URL. Codex users can check
@@ -27,24 +27,24 @@ instructions.
 
 | Plugin | Verified Runtime | Install |
 | --- | --- | --- |
-| `artifact-chain-assistant` 0.9.4 | `artifact-graph` 0.9.4 | `pnpm add -D artifact-graph@0.9.4` |
+| `artifact-chain-assistant` 0.10.0 | `artifact-graph` 0.10.0 | `pnpm add -D artifact-graph@0.10.0` |
 
 ### Install The Runtime
 
 The default installation path uses the npm registry with a precise version:
 
 ```bash
-pnpm add -D artifact-graph@0.9.4
+pnpm add -D artifact-graph@0.10.0
 ```
 
 If the npm registry is unavailable, use the explicit GitHub fallback pinned to the verified tag:
 
 ```bash
-pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.9.4
+pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.10.0
 ```
 
 > **Never** install with an unlocked range (`artifact-graph`, `artifact-graph@latest`,
-> `artifact-graph@^0.9.4`) or an unpinned GitHub URL (`github:ifoohoo/artifact-graph`).
+> `artifact-graph@^0.10.0`) or an unpinned GitHub URL (`github:ifoohoo/artifact-graph`).
 > Unlocked installs produce non-reproducible dependency trees and break version-lock audit.
 
 With pnpm 10+, projects that install `artifact-graph` must allow the native `better-sqlite3`
@@ -71,7 +71,7 @@ allowBuilds:
 
 The plugin's `doctor` command validates the installed runtime version before running any
 diagnostic. If it detects a version mismatch or missing CLI, it reports the exact remediation
-command (`pnpm add -D artifact-graph@0.9.4`) and exits non-zero.
+command (`pnpm add -D artifact-graph@0.10.0`) and exits non-zero.
 
 ### CLI Resolution Order
 
@@ -146,7 +146,7 @@ wrappers, and Stop-hook guardrail. These assistant controls do not replace Git h
 
 > **Marketplace note**: `ifoohoo/artifact-skill-set` is an external independent marketplace. The
 > plugin payload is still published from `ifoohoo/artifact-chain-assistant`. The marketplace entry
-> must publish and enable `artifact-chain-assistant` 0.9.4 before the install commands above will
+> must publish and enable `artifact-chain-assistant` 0.10.0 before the install commands above will
 > succeed.
 
 ### Kimi Code
@@ -210,15 +210,19 @@ adapter doctor.
 
 After installing the plugin, use these entry points to understand available capabilities:
 
-1. **`help`** — Run this skill to see the standard Family API catalog and bundled legacy methods.
-   It shows what families and services the plugin provides, without claiming any are installed, enabled, or verified
-   for your project. Installation of the plugin does NOT mean families are bound or providers are active.
+1. **`help`** — Run this skill when you ask "what can this plugin do" or "how does the artifact
+   chain work". It shows the standard Family API catalog and bundled legacy methods — the plugin's
+   capabilities and what the artifact chain is for — without claiming any are installed, enabled, or
+   verified for your project. Installation of the plugin does NOT mean families are bound or providers
+   are active. If the Registry is missing, it still runs and honestly lists which standard services
+   are not yet executable.
 
-2. **`setup`** — Run this skill for read-only environment diagnostics: plugin closure integrity, Node/CLI
+2. **`setup`** — Run this skill when you ask "is my environment ready". It performs read-only
+   environment diagnostics: plugin closure integrity, Node/CLI
    availability, doctor output, project config, version lock, and registry availability. It outputs a structured status
    report with PASS/WARN/FAIL for each check plus precise next steps, and writes nothing without explicit authorization.
 
-3. **`quickstart`** — Run this skill when unsure which skill to use. It routes your intent to the correct skill:
+3. **`quickstart`** — Run this skill when getting started or unsure which skill to use. It routes your intent to the correct skill via a deterministic routing table covering common Chinese/English requests:
    capability questions go to `help`, environment checks to `setup`, initialization to `setup` then bootstrap,
    project triage to `where-am-i`, maintenance to `maintainer`, and explicit artifact tasks to the matching family/service.
 
@@ -253,7 +257,7 @@ The plugin should not move these files into the plugin repository.
 
 For a first-time setup, the end-to-end sequence is:
 
-1. **Install the CLI** — `pnpm add -D artifact-graph@0.9.4` (see Prerequisites above).
+1. **Install the CLI** — `pnpm add -D artifact-graph@0.10.0` (see Prerequisites above).
 2. **Install the plugin** — follow the Codex or Claude Code section above.
 3. **Run bootstrap** — ask the assistant to use the `artifact-chain-bootstrap` skill (see prompt
    below). The skill will:
@@ -1051,7 +1055,7 @@ with append-only behavior; it does not overwrite local rules.
 ### Recovery Steps
 
 ```bash
-# 1. Install dependencies from lockfile (gets artifact-graph@0.9.4)
+# 1. Install dependencies from lockfile (gets artifact-graph@0.10.0)
 pnpm install --frozen-lockfile
 
 # 2. Install plugin per your host (Codex / Claude Code / Kimi Code)
@@ -1118,7 +1122,7 @@ pnpm exec artifact-graph hooks install-git --hook all
 ### Enterprise Mirror
 
 If the corporate environment cannot access the public npm registry or GitHub, mirror both
-`artifact-graph@0.9.4` and the plugin marketplace repository on an internal registry. The mirror
+`artifact-graph@0.10.0` and the plugin marketplace repository on an internal registry. The mirror
 does not change the state ownership model: Git-tracked files remain authoritative, local caches
 remain derived.
 

package/README.md

@@ -154,13 +154,13 @@ override, compact query, fallback behavior, and `PLUGIN_ROOT` discovery, see
 
 | Plugin | Runtime | Install |
 | --- | --- | --- |
-| `artifact-chain-assistant` 0.9.4 | `artifact-graph` 0.9.4 | `pnpm add -D artifact-graph@0.9.4` |
+| `artifact-chain-assistant` 0.10.0 | `artifact-graph` 0.10.0 | `pnpm add -D artifact-graph@0.10.0` |
 
 ## Install
 
 ```bash
 # Runtime (required)
-npm install --save-dev artifact-graph@0.9.4
+npm install --save-dev artifact-graph@0.10.0
 ```
 
 ```bash
@@ -182,7 +182,7 @@ codex plugin add artifact-chain-assistant@artifact-skill-set
 
 > **Marketplace note**: `ifoohoo/artifact-skill-set` is an external independent marketplace. The
 > plugin payload is still published from `ifoohoo/artifact-chain-assistant`. The marketplace entry
-> must publish and enable `artifact-chain-assistant` 0.9.4 before the install commands above will
+> must publish and enable `artifact-chain-assistant` 0.10.0 before the install commands above will
 > succeed.
 
 ```text
@@ -211,7 +211,7 @@ For the full installation guide, quick start, Agent prompts, and clone onboardin
 
 ## Quick Start
 
-1. Install plugin 0.9.4 (above) and runtime: `pnpm add -D artifact-graph@0.9.4`.
+1. Install plugin 0.10.0 (above) and runtime: `pnpm add -D artifact-graph@0.10.0`.
 2. Run `artifact-graph doctor --root . --format json` to verify the runtime.
 3. For first-time setup, use the bootstrap skill.
 4. For daily work, use the maintainer skill.

package/README.zh-CN.md

@@ -201,13 +201,13 @@ catalog 还包含 `artifact.generate`，用于从模板和 profile 配置生成
 
 | 插件 | 运行时 | 安装 |
 | --- | --- | --- |
-| `artifact-chain-assistant` 0.9.4 | `artifact-graph` 0.9.4 | `pnpm add -D artifact-graph@0.9.4` |
+| `artifact-chain-assistant` 0.10.0 | `artifact-graph` 0.10.0 | `pnpm add -D artifact-graph@0.10.0` |
 
 ## 安装
 
 ```bash
 # 运行时（必需）
-npm install --save-dev artifact-graph@0.9.4
+npm install --save-dev artifact-graph@0.10.0
 ```
 
 ```bash
@@ -229,7 +229,7 @@ codex plugin add artifact-chain-assistant@artifact-skill-set
 
 > **市场说明**：`ifoohoo/artifact-skill-set` 是外部独立市场，插件载荷仍由
 > `ifoohoo/artifact-chain-assistant` 发布。市场条目必须先发布并启用
-> `artifact-chain-assistant` 0.9.4，上述安装命令才能生效。
+> `artifact-chain-assistant` 0.10.0，上述安装命令才能生效。
 
 ```text
 # Kimi Code 插件（交互式，user 作用域）
@@ -256,7 +256,7 @@ Qoder 当前承诺的边界是技能安装与发现；不提供 Claude Code 的
 
 ## 快速开始
 
-1. 安装插件 0.9.4（见上文）和运行时：`pnpm add -D artifact-graph@0.9.4`。
+1. 安装插件 0.10.0（见上文）和运行时：`pnpm add -D artifact-graph@0.10.0`。
 2. 运行 `artifact-graph doctor --root . --format json` 验证运行时。
 3. 首次搭建，进入 bootstrap 技能。
 4. 日常工作，进入 maintainer 技能。

package/adapters/claude/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "artifact-chain-assistant",
-  "version": "0.9.4",
+  "version": "0.10.0",
   "description": "Artifact-chain intake, review/repair/batch/audit workflows, diagnostics, hooks, and version-lock maintenance helpers.",
   "author": {
     "name": "广州市风荷科技有限公司"

package/adapters/claude/INSTALL.md

@@ -18,7 +18,7 @@ instructions.
 ## Prerequisites
 
 - Node.js `>=22.0.0`.
-- `artifact-graph` 0.9.4 installed in the target project.
+- `artifact-graph` 0.10.0 installed in the target project.
 - **GitHub SSH key** — Claude Code clones `source: github` entries over SSH by default. If you
   have not configured a GitHub SSH key, set `CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1` in your shell
   profile, or add the marketplace with an explicit `https://` URL. Codex users can check
@@ -30,24 +30,24 @@ instructions.
 
 | Plugin | Verified Runtime | Install |
 | --- | --- | --- |
-| `artifact-chain-assistant` 0.9.4 | `artifact-graph` 0.9.4 | `pnpm add -D artifact-graph@0.9.4` |
+| `artifact-chain-assistant` 0.10.0 | `artifact-graph` 0.10.0 | `pnpm add -D artifact-graph@0.10.0` |
 
 ### Install The Runtime
 
 The default installation path uses the npm registry with a precise version:
 
 ```bash
-pnpm add -D artifact-graph@0.9.4
+pnpm add -D artifact-graph@0.10.0
 ```
 
 If the npm registry is unavailable, use the explicit GitHub fallback pinned to the verified tag:
 
 ```bash
-pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.9.4
+pnpm add -D github:ifoohoo/artifact-graph#artifact-graph-v0.10.0
 ```
 
 > **Never** install with an unlocked range (`artifact-graph`, `artifact-graph@latest`,
-> `artifact-graph@^0.9.4`) or an unpinned GitHub URL (`github:ifoohoo/artifact-graph`).
+> `artifact-graph@^0.10.0`) or an unpinned GitHub URL (`github:ifoohoo/artifact-graph`).
 > Unlocked installs produce non-reproducible dependency trees and break version-lock audit.
 
 With pnpm 10+, projects that install `artifact-graph` must allow the native `better-sqlite3`
@@ -74,7 +74,7 @@ allowBuilds:
 
 The plugin's `doctor` command validates the installed runtime version before running any
 diagnostic. If it detects a version mismatch or missing CLI, it reports the exact remediation
-command (`pnpm add -D artifact-graph@0.9.4`) and exits non-zero.
+command (`pnpm add -D artifact-graph@0.10.0`) and exits non-zero.
 
 ### CLI Resolution Order
 
@@ -149,7 +149,7 @@ wrappers, and Stop-hook guardrail. These assistant controls do not replace Git h
 
 > **Marketplace note**: `ifoohoo/artifact-skill-set` is an external independent marketplace. The
 > plugin payload is still published from `ifoohoo/artifact-chain-assistant`. The marketplace entry
-> must publish and enable `artifact-chain-assistant` 0.9.4 before the install commands above will
+> must publish and enable `artifact-chain-assistant` 0.10.0 before the install commands above will
 > succeed.
 
 ### Kimi Code
@@ -213,15 +213,19 @@ adapter doctor.
 
 After installing the plugin, use these entry points to understand available capabilities:
 
-1. **`help`** — Run this skill to see the standard Family API catalog and bundled legacy methods.
-   It shows what families and services the plugin provides, without claiming any are installed, enabled, or verified
-   for your project. Installation of the plugin does NOT mean families are bound or providers are active.
+1. **`help`** — Run this skill when you ask "what can this plugin do" or "how does the artifact
+   chain work". It shows the standard Family API catalog and bundled legacy methods — the plugin's
+   capabilities and what the artifact chain is for — without claiming any are installed, enabled, or
+   verified for your project. Installation of the plugin does NOT mean families are bound or providers
+   are active. If the Registry is missing, it still runs and honestly lists which standard services
+   are not yet executable.
 
-2. **`setup`** — Run this skill for read-only environment diagnostics: plugin closure integrity, Node/CLI
+2. **`setup`** — Run this skill when you ask "is my environment ready". It performs read-only
+   environment diagnostics: plugin closure integrity, Node/CLI
    availability, doctor output, project config, version lock, and registry availability. It outputs a structured status
    report with PASS/WARN/FAIL for each check plus precise next steps, and writes nothing without explicit authorization.
 
-3. **`quickstart`** — Run this skill when unsure which skill to use. It routes your intent to the correct skill:
+3. **`quickstart`** — Run this skill when getting started or unsure which skill to use. It routes your intent to the correct skill via a deterministic routing table covering common Chinese/English requests:
    capability questions go to `help`, environment checks to `setup`, initialization to `setup` then bootstrap,
    project triage to `where-am-i`, maintenance to `maintainer`, and explicit artifact tasks to the matching family/service.
 
@@ -256,7 +260,7 @@ The plugin should not move these files into the plugin repository.
 
 For a first-time setup, the end-to-end sequence is:
 
-1. **Install the CLI** — `pnpm add -D artifact-graph@0.9.4` (see Prerequisites above).
+1. **Install the CLI** — `pnpm add -D artifact-graph@0.10.0` (see Prerequisites above).
 2. **Install the plugin** — follow the Codex or Claude Code section above.
 3. **Run bootstrap** — ask the assistant to use the `artifact-chain-bootstrap` skill (see prompt
    below). The skill will:
@@ -1054,7 +1058,7 @@ with append-only behavior; it does not overwrite local rules.
 ### Recovery Steps
 
 ```bash
-# 1. Install dependencies from lockfile (gets artifact-graph@0.9.4)
+# 1. Install dependencies from lockfile (gets artifact-graph@0.10.0)
 pnpm install --frozen-lockfile
 
 # 2. Install plugin per your host (Codex / Claude Code / Kimi Code)
@@ -1121,7 +1125,7 @@ pnpm exec artifact-graph hooks install-git --hook all
 ### Enterprise Mirror
 
 If the corporate environment cannot access the public npm registry or GitHub, mirror both
-`artifact-graph@0.9.4` and the plugin marketplace repository on an internal registry. The mirror
+`artifact-graph@0.10.0` and the plugin marketplace repository on an internal registry. The mirror
 does not change the state ownership model: Git-tracked files remain authoritative, local caches
 remain derived.
 

package/adapters/claude/agent-methods/catalog.yaml

@@ -1,7 +1,7 @@
 schemaVersion: 1
 catalog:
   id: artifact-chain-assistant
-  version: "0.9.4"
+  version: "0.10.0"
 entries:
   - ref: artifact.prd-feature.default
     provider:
@@ -247,7 +247,7 @@ entries:
       plugin: artifact-chain-assistant
       skill: help
     kind: operation
-    summary: "展示标准 Family API、bundled legacy 方法和安装后采用步骤"
+    summary: "能力说明入口：回答\"能做什么\"、\"制品链怎么用\"，展示标准 Family API、bundled legacy 方法和采用步骤；Registry 缺失时诚实降级"
     match:
       domains: [artifact]
       artifactTypes: [design-spec, link, e2e, domain, contract, blueprint, verification, prd-feature, scenario-script]
@@ -265,7 +265,7 @@ entries:
       plugin: artifact-chain-assistant
       skill: setup
     kind: operation
-    summary: "只读环境检查：插件闭包、CLI、config、版本锁、registry 可用性"
+    summary: "环境诊断入口：回答\"环境准备好了吗\"，只读检查插件闭包、CLI、config、版本锁、registry 可用性，输出 PASS/WARN/FAIL"
     match:
       domains: [artifact]
       artifactTypes: [design-spec, link, e2e, domain, contract, blueprint, verification, prd-feature, scenario-script]
@@ -283,7 +283,7 @@ entries:
       plugin: artifact-chain-assistant
       skill: quickstart
     kind: operation
-    summary: "按意图路由到正确的技能"
+    summary: "上手路径入口：不知道用哪个技能时，按确定性路由表把自然语言需求路由到 help/setup/where-am-i 等正确入口"
     match:
       domains: [artifact]
       artifactTypes: [design-spec, link, e2e, domain, contract, blueprint, verification, prd-feature, scenario-script]

package/adapters/claude/compatibility.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": "1.0",
-  "pluginVersion": "0.9.4",
+  "pluginVersion": "0.10.0",
   "artifactGraph": {
-    "verifiedVersion": "0.9.4",
-    "installSpec": "artifact-graph@0.9.4",
-    "githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.9.4"
+    "verifiedVersion": "0.10.0",
+    "installSpec": "artifact-graph@0.10.0",
+    "githubFallbackSpec": "github:ifoohoo/artifact-graph#artifact-graph-v0.10.0"
   }
 }

package/adapters/claude/family-apis/catalog.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "catalog": {
     "id": "artifact-chain-assistant",
-    "version": "0.9.4"
+    "version": "0.10.0"
   },
   "families": [
     {

package/adapters/claude/scripts/lib/entry-discovery.mjs

@@ -0,0 +1,123 @@
+// @feature ACA21
+// @scenario S-91
+// @decision D-ACA-26
+// 入口可发现性确定性合同：三类自然语言意图的关键词集合与 quickstart 确定性路由表。
+// 本文件是三入口发现表面的唯一权威事实源；skills-src 三入口 description、catalog.yaml、
+// 安装文档与生成适配器副本必须与其保持一致（由 entry-discovery-contract 测试断言）。
+
+export const discoveryIntentClasses = [
+  {
+    id: 'capability',
+    zh: '能力说明',
+    en: 'capability overview',
+    keywords: {
+      zh: ['能做什么', '有哪些能力', '能力说明'],
+      en: ['what can', 'capabilities'],
+    },
+  },
+  {
+    id: 'onboarding',
+    zh: '上手路径',
+    en: 'getting-started path',
+    keywords: {
+      zh: ['怎么上手', '如何开始', '不知道用哪个'],
+      en: ['getting started', 'unsure which skill'],
+    },
+  },
+  {
+    id: 'artifact-chain-purpose',
+    zh: '制品链用途',
+    en: 'artifact chain purpose',
+    keywords: {
+      zh: ['制品链怎么用', '制品链'],
+      en: ['artifact chain'],
+    },
+  },
+];
+
+// 确定性路由目标集合：target 是稳定标识，quickstart 路由表与测试共同引用。
+export const routingTargets = {
+  help: {
+    skill: 'help',
+    authorizationGate: false,
+    summary: '能力说明：展示标准 Family API、bundled legacy 方法和采用步骤',
+  },
+  setup: {
+    skill: 'setup',
+    authorizationGate: false,
+    summary: '环境诊断：只读环境检查，输出 PASS/WARN/FAIL 状态报告',
+  },
+  'setup-then-bootstrap': {
+    skill: 'artifact-chain-bootstrap',
+    authorizationGate: true,
+    summary: '写入初始化：先经 setup 只读检查，获得用户明确授权后才进入 bootstrap',
+  },
+  'where-am-i': {
+    skill: 'where-am-i',
+    authorizationGate: false,
+    summary: '模糊项目任务：搜索项目配置与制品图，输出项目事实和路由建议',
+  },
+  maintainer: {
+    skill: 'artifact-chain-maintainer',
+    authorizationGate: false,
+    summary: '日常维护：版本锁刷新、hook 管理等维护任务',
+  },
+  'family-service': {
+    skill: null,
+    authorizationGate: false,
+    summary: '明确制品任务：路由到对应 family/service 专业入口',
+  },
+  ask: {
+    skill: null,
+    authorizationGate: false,
+    summary: '意图不明确：输出追问而非猜测路由',
+  },
+};
+
+// 常见中英文自然语言需求的最小覆盖集。phrase 全部小写比较；lang 标注语言。
+export const routingVectors = [
+  { phrase: '你能做什么', lang: 'zh', target: 'help' },
+  { phrase: '这个插件有哪些能力', lang: 'zh', target: 'help' },
+  { phrase: '这个项目的制品链怎么用', lang: 'zh', target: 'help' },
+  { phrase: 'what can this plugin do', lang: 'en', target: 'help' },
+  { phrase: 'how does the artifact chain work', lang: 'en', target: 'help' },
+  { phrase: '我的环境准备好了吗', lang: 'zh', target: 'setup' },
+  { phrase: '帮我检查一下环境', lang: 'zh', target: 'setup' },
+  { phrase: 'is my environment ready', lang: 'en', target: 'setup' },
+  { phrase: '帮我初始化这个项目', lang: 'zh', target: 'setup-then-bootstrap' },
+  { phrase: '怎么开始使用这个插件', lang: 'zh', target: 'setup-then-bootstrap' },
+  { phrase: 'initialize this project', lang: 'en', target: 'setup-then-bootstrap' },
+  { phrase: 'how do i get started', lang: 'en', target: 'setup-then-bootstrap' },
+  { phrase: '我下一步该做什么', lang: 'zh', target: 'where-am-i' },
+  { phrase: '这个项目现在该从哪里入手', lang: 'zh', target: 'where-am-i' },
+  { phrase: 'what should i do next', lang: 'en', target: 'where-am-i' },
+  { phrase: '帮我刷新版本锁', lang: 'zh', target: 'maintainer' },
+  { phrase: 'refresh the version lock', lang: 'en', target: 'maintainer' },
+  { phrase: '请审阅这个 PRD feature', lang: 'zh', target: 'family-service' },
+  { phrase: 'review this design spec', lang: 'en', target: 'family-service' },
+  { phrase: '随便看看', lang: 'zh', target: 'ask' },
+  { phrase: 'hello', lang: 'en', target: 'ask' },
+];
+
+// 从 quickstart SKILL.md 正文提取确定性路由表 JSON 块。
+export function extractRoutingTable(skillMarkdown) {
+  const match = skillMarkdown.match(/```json quickstart-routing-table\n([\s\S]*?)\n```/);
+  if (!match) return null;
+  try {
+    return JSON.parse(match[1]);
+  } catch {
+    return null;
+  }
+}
+
+// 从 SKILL.md 提取 frontmatter 字段（name/description）。
+export function parseFrontmatter(skillMarkdown) {
+  const match = skillMarkdown.match(/^---\n([\s\S]*?)\n---/);
+  if (!match) return null;
+  const fields = {};
+  for (const line of match[1].split('\n')) {
+    const kv = line.match(/^(\w+):\s*(.*)$/);
+    if (kv) fields[kv[1]] = kv[2].trim();
+  }
+  return fields;
+}