feat: skill trigger discoverability + baseline convergence

.agents/skills/prospec-archive/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prospec-archive
-description: "Archive Changes - Archive completed changes, generate summary, sync requirements to feature specs, and gate archiving on Knowledge sync. Triggers: archive, clean up, wrap up, spec sync, 封存, 歸檔, 收尾, 規格同步, 清理"
+description: "Archive Changes - Archive completed changes, generate summary, sync requirements to feature specs, and gate archiving on Knowledge sync. Triggers: archive, spec sync, finalize change, 封存, 歸檔, 收尾, 規格同步"
 ---
 <!-- Generated by `prospec agent sync`. Do not edit — this file is regenerated on every sync. -->
 

.agents/skills/prospec-learn/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prospec-learn
-description: "Feedback Promotion Pipeline - Collect session corrections, repeated verify FAILs and recurring review criticals into a version-controlled lessons ledger; score them with an explicit, reproducible rule (frequency + impact modules); and promote - only with explicit human approval - across three tiers (accumulating ledger -> team playbook -> Constitution rule). Triggers: learn, promote lesson, feedback, playbook, 學習, 晉升教訓, 回饋, 經驗手冊"
+description: "Feedback Promotion Pipeline - Collect session corrections, repeated verify FAILs and recurring review criticals into a version-controlled lessons ledger; score them with an explicit, reproducible rule (frequency + impact modules); and promote - only with explicit human approval - across three tiers (accumulating ledger -> team playbook -> Constitution rule). Triggers: learn, promote lesson, playbook, 學習, 晉升教訓, 經驗手冊"
 ---
 <!-- Generated by `prospec agent sync`. Do not edit — this file is regenerated on every sync. -->
 

.agents/skills/prospec-new-story/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prospec-new-story
-description: "New Story - Create change requests by guiding User Story and acceptance criteria definition. Triggers: new feature, requirement, story, I want to, 新功能, 需求, 我想要, 新增需求"
+description: "New Story - Create change requests by guiding User Story and acceptance criteria definition. Triggers: new feature, requirement, user story, 新功能, 需求, 新增需求"
 ---
 <!-- Generated by `prospec agent sync`. Do not edit — this file is regenerated on every sync. -->
 

.agents/skills/prospec-plan/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prospec-plan
-description: "Plan Implementation - Convert User Story into technical implementation plan (plan.md) and change specification (delta-spec.md). Triggers: plan, architecture, 規劃, 架構規劃"
+description: "Plan Implementation - Convert User Story into technical implementation plan (plan.md) and change specification (delta-spec.md). Triggers: plan, architecture, technical plan, 規劃, 架構規劃, 技術規劃"
 ---
 <!-- Generated by `prospec agent sync`. Do not edit — this file is regenerated on every sync. -->
 

.agents/skills/prospec-quickstart/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prospec-quickstart
-description: "Quickstart Onboarding Finisher - localize skill triggers, re-sync agent config, prepare the knowledge scan, and chain into knowledge generation. Triggers: quickstart, setup, bootstrap, onboard, get started, 快速開始, 初始化, 設定, 上手, 開始使用"
+description: "Quickstart Onboarding Finisher - localize skill triggers, re-sync agent config, prepare the knowledge scan, and chain into knowledge generation. Triggers: quickstart, onboard, bootstrap, get started, 快速開始, 初始化, 上手, 開始使用"
 ---
 <!-- Generated by `prospec agent sync`. Do not edit — this file is regenerated on every sync. -->
 
@@ -40,11 +40,12 @@ Read `.prospec.yaml`. When `artifact_language` is not English, localize the skil
 both a fresh project (all skills missing) and a project that just gained new skills (only the new ones
 missing) — so you never delete `.prospec.yaml` to re-localize:
 
-1. **Capture the current `.prospec.yaml` content verbatim** as a snapshot to restore from if the write goes wrong
-2. For each skill missing a `skill_triggers` entry, translate its English trigger baseline into the `artifact_language` — leave skills that already have an entry untouched
-3. **Show the proposed translations to the user and wait for confirmation** before writing anything
-4. On confirmation, add the missing `skill_triggers` keys by a **minimal in-place edit** — insert only the new keys, leaving every existing key, its ordering, and all comments untouched (do not re-serialize the whole file)
-5. Read `.prospec.yaml` back and confirm it still parses as valid YAML; if it does not, restore the captured snapshot verbatim and report the malformed translation
+1. Run `prospec agent triggers` (Bash) to get a ready-to-translate `skill_triggers` scaffold — the skills still missing an entry, each with its English baseline sourced from the CLI (authoritative; never grep a deployed SKILL.md, whose frontmatter already merges custom words)
+2. **Capture the current `.prospec.yaml` content verbatim** as a snapshot to restore from if the write goes wrong
+3. Translate each scaffold value into the `artifact_language` — leave skills that already have an entry untouched
+4. **Show the proposed translations to the user and wait for confirmation** before writing anything
+5. On confirmation, add the missing `skill_triggers` keys by a **minimal in-place edit** — insert only the new keys, leaving every existing key, its ordering, and all comments untouched (do not re-serialize the whole file)
+6. Read `.prospec.yaml` back and confirm it still parses as valid YAML; if it does not, restore the captured snapshot verbatim and report the malformed translation
 
 Skip this step entirely when the language is English or every skill already has a `skill_triggers`
 entry — never overwrite curated triggers.

.agents/skills/prospec-review/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prospec-review
-description: "Adversarial Code Review → Fix Loop - Between implement and verify, an independent fresh-context reviewer audits the whole change diff; verifier-confirmed criticals are auto-fixed, majors are proposed, and a spec-aware lens checks delta-spec/dependency-direction. Triggers: review, code review, adversarial review, find bugs, critical, 審查, 程式碼審查, 對抗式審查, 找 bug, 找問題"
+description: "Adversarial Code Review → Fix Loop - Between implement and verify, an independent fresh-context reviewer audits the whole change diff; verifier-confirmed criticals are auto-fixed, majors are proposed, and a spec-aware lens checks delta-spec/dependency-direction. Triggers: review, code review, adversarial review, find bugs, 審查, 程式碼審查, 對抗式審查, 找 bug, 找問題"
 ---
 <!-- Generated by `prospec agent sync`. Do not edit — this file is regenerated on every sync. -->
 

.agents/skills/prospec-upgrade/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prospec-upgrade
-description: "Prospec Version Upgrade Finisher - after `prospec upgrade` records the version, syncs agents, and reports gaps, work through the report's docs inventory: update init-created files whose format drifted and create missing ones (asking consent per file), then localize triggers for newly-added skills and re-sync. Triggers: upgrade, upgrade prospec, migrate version, version bump, 升級, 升級 prospec, 版本遷移, 版本升級"
+description: "Prospec Version Upgrade Finisher - after `prospec upgrade` records the version, syncs agents, and reports gaps, work through the report's docs inventory: update init-created files whose format drifted and create missing ones (asking consent per file), then localize triggers for newly-added skills and re-sync. Triggers: upgrade prospec, prospec upgrade, migrate prospec version, 升級 prospec, prospec 升級, 遷移 prospec 版本"
 ---
 <!-- Generated by `prospec agent sync`. Do not edit — this file is regenerated on every sync. -->
 
@@ -117,13 +117,16 @@ localize every skill that still has **no `skill_triggers` entry** — that is St
 triggers" list, plus, when Step 3 just set the language, all skills. Skip entirely when the language is
 English or every skill already has an entry.
 
-1. **Capture the current `.prospec.yaml` content verbatim** as a snapshot to restore from
-2. Translate ONLY those skills' English trigger baselines into `artifact_language`
-3. **Show the proposed translations and wait for confirmation** before writing anything
-4. On confirmation, add the new `skill_triggers` keys by a **minimal in-place edit** — insert only the
+1. Run `prospec agent triggers` (Bash) to get a ready-to-translate `skill_triggers` scaffold — the skills
+   still missing an entry, each with its English baseline sourced from the CLI (authoritative; never grep
+   a deployed SKILL.md, whose frontmatter already merges custom words)
+2. **Capture the current `.prospec.yaml` content verbatim** as a snapshot to restore from
+3. Translate each scaffold value into `artifact_language`
+4. **Show the proposed translations and wait for confirmation** before writing anything
+5. On confirmation, add the new `skill_triggers` keys by a **minimal in-place edit** — insert only the
    missing keys; never re-serialize the file or touch existing keys, their order, or comments
-5. Read `.prospec.yaml` back and confirm it still parses as valid YAML; if not, restore the snapshot
-6. If anything changed in Step 2, Step 3, or Step 4, run `prospec agent sync` (Bash) so the language,
+6. Read `.prospec.yaml` back and confirm it still parses as valid YAML; if not, restore the snapshot
+7. If anything changed in Step 2, Step 3, or Step 4, run `prospec agent sync` (Bash) so the language,
    localized triggers, and refreshed docs land in each SKILL.md frontmatter and the entry config
 
 ## Output Contract

.agents/skills/prospec-verify/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prospec-verify
-description: "Verify Implementation - Run 5+1 dimension audit (tasks, spec compliance, constitution, knowledge-implementation consistency, tests, design consistency) and assign quality grade (S/A/B/C/D). Triggers: verify, audit, quality, done, 驗證, 稽核, 品質, 完成, 評級"
+description: "Verify Implementation - Run 5+1 dimension audit (tasks, spec compliance, constitution, knowledge-implementation consistency, tests, design consistency) and assign quality grade (S/A/B/C/D). Triggers: verify, audit, quality check, 驗證, 稽核, 品質檢查, 評級"
 ---
 <!-- Generated by `prospec agent sync`. Do not edit — this file is regenerated on every sync. -->
 

.claude/skills/prospec-archive/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prospec-archive
-description: "Archive Changes - Archive completed changes, generate summary, sync requirements to feature specs, and gate archiving on Knowledge sync. Triggers: archive, clean up, wrap up, spec sync, 封存, 歸檔, 收尾, 規格同步, 清理"
+description: "Archive Changes - Archive completed changes, generate summary, sync requirements to feature specs, and gate archiving on Knowledge sync. Triggers: archive, spec sync, finalize change, 封存, 歸檔, 收尾, 規格同步"
 ---
 <!-- Generated by `prospec agent sync`. Do not edit — this file is regenerated on every sync. -->
 

.claude/skills/prospec-learn/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prospec-learn
-description: "Feedback Promotion Pipeline - Collect session corrections, repeated verify FAILs and recurring review criticals into a version-controlled lessons ledger; score them with an explicit, reproducible rule (frequency + impact modules); and promote - only with explicit human approval - across three tiers (accumulating ledger -> team playbook -> Constitution rule). Triggers: learn, promote lesson, feedback, playbook, 學習, 晉升教訓, 回饋, 經驗手冊"
+description: "Feedback Promotion Pipeline - Collect session corrections, repeated verify FAILs and recurring review criticals into a version-controlled lessons ledger; score them with an explicit, reproducible rule (frequency + impact modules); and promote - only with explicit human approval - across three tiers (accumulating ledger -> team playbook -> Constitution rule). Triggers: learn, promote lesson, playbook, 學習, 晉升教訓, 經驗手冊"
 ---
 <!-- Generated by `prospec agent sync`. Do not edit — this file is regenerated on every sync. -->
 

.claude/skills/prospec-new-story/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prospec-new-story
-description: "New Story - Create change requests by guiding User Story and acceptance criteria definition. Triggers: new feature, requirement, story, I want to, 新功能, 需求, 我想要, 新增需求"
+description: "New Story - Create change requests by guiding User Story and acceptance criteria definition. Triggers: new feature, requirement, user story, 新功能, 需求, 新增需求"
 ---
 <!-- Generated by `prospec agent sync`. Do not edit — this file is regenerated on every sync. -->
 

.claude/skills/prospec-plan/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prospec-plan
-description: "Plan Implementation - Convert User Story into technical implementation plan (plan.md) and change specification (delta-spec.md). Triggers: plan, architecture, 規劃, 架構規劃"
+description: "Plan Implementation - Convert User Story into technical implementation plan (plan.md) and change specification (delta-spec.md). Triggers: plan, architecture, technical plan, 規劃, 架構規劃, 技術規劃"
 ---
 <!-- Generated by `prospec agent sync`. Do not edit — this file is regenerated on every sync. -->
 

.claude/skills/prospec-quickstart/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prospec-quickstart
-description: "Quickstart Onboarding Finisher - localize skill triggers, re-sync agent config, prepare the knowledge scan, and chain into knowledge generation. Triggers: quickstart, setup, bootstrap, onboard, get started, 快速開始, 初始化, 設定, 上手, 開始使用"
+description: "Quickstart Onboarding Finisher - localize skill triggers, re-sync agent config, prepare the knowledge scan, and chain into knowledge generation. Triggers: quickstart, onboard, bootstrap, get started, 快速開始, 初始化, 上手, 開始使用"
 ---
 <!-- Generated by `prospec agent sync`. Do not edit — this file is regenerated on every sync. -->
 
@@ -40,11 +40,12 @@ Read `.prospec.yaml`. When `artifact_language` is not English, localize the skil
 both a fresh project (all skills missing) and a project that just gained new skills (only the new ones
 missing) — so you never delete `.prospec.yaml` to re-localize:
 
-1. **Capture the current `.prospec.yaml` content verbatim** as a snapshot to restore from if the write goes wrong
-2. For each skill missing a `skill_triggers` entry, translate its English trigger baseline into the `artifact_language` — leave skills that already have an entry untouched
-3. **Show the proposed translations to the user and wait for confirmation** before writing anything
-4. On confirmation, add the missing `skill_triggers` keys by a **minimal in-place edit** — insert only the new keys, leaving every existing key, its ordering, and all comments untouched (do not re-serialize the whole file)
-5. Read `.prospec.yaml` back and confirm it still parses as valid YAML; if it does not, restore the captured snapshot verbatim and report the malformed translation
+1. Run `prospec agent triggers` (Bash) to get a ready-to-translate `skill_triggers` scaffold — the skills still missing an entry, each with its English baseline sourced from the CLI (authoritative; never grep a deployed SKILL.md, whose frontmatter already merges custom words)
+2. **Capture the current `.prospec.yaml` content verbatim** as a snapshot to restore from if the write goes wrong
+3. Translate each scaffold value into the `artifact_language` — leave skills that already have an entry untouched
+4. **Show the proposed translations to the user and wait for confirmation** before writing anything
+5. On confirmation, add the missing `skill_triggers` keys by a **minimal in-place edit** — insert only the new keys, leaving every existing key, its ordering, and all comments untouched (do not re-serialize the whole file)
+6. Read `.prospec.yaml` back and confirm it still parses as valid YAML; if it does not, restore the captured snapshot verbatim and report the malformed translation
 
 Skip this step entirely when the language is English or every skill already has a `skill_triggers`
 entry — never overwrite curated triggers.

.claude/skills/prospec-review/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prospec-review
-description: "Adversarial Code Review → Fix Loop - Between implement and verify, an independent fresh-context reviewer audits the whole change diff; verifier-confirmed criticals are auto-fixed, majors are proposed, and a spec-aware lens checks delta-spec/dependency-direction. Triggers: review, code review, adversarial review, find bugs, critical, 審查, 程式碼審查, 對抗式審查, 找 bug, 找問題"
+description: "Adversarial Code Review → Fix Loop - Between implement and verify, an independent fresh-context reviewer audits the whole change diff; verifier-confirmed criticals are auto-fixed, majors are proposed, and a spec-aware lens checks delta-spec/dependency-direction. Triggers: review, code review, adversarial review, find bugs, 審查, 程式碼審查, 對抗式審查, 找 bug, 找問題"
 ---
 <!-- Generated by `prospec agent sync`. Do not edit — this file is regenerated on every sync. -->
 

.claude/skills/prospec-upgrade/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prospec-upgrade
-description: "Prospec Version Upgrade Finisher - after `prospec upgrade` records the version, syncs agents, and reports gaps, work through the report's docs inventory: update init-created files whose format drifted and create missing ones (asking consent per file), then localize triggers for newly-added skills and re-sync. Triggers: upgrade, upgrade prospec, migrate version, version bump, 升級, 升級 prospec, 版本遷移, 版本升級"
+description: "Prospec Version Upgrade Finisher - after `prospec upgrade` records the version, syncs agents, and reports gaps, work through the report's docs inventory: update init-created files whose format drifted and create missing ones (asking consent per file), then localize triggers for newly-added skills and re-sync. Triggers: upgrade prospec, prospec upgrade, migrate prospec version, 升級 prospec, prospec 升級, 遷移 prospec 版本"
 ---
 <!-- Generated by `prospec agent sync`. Do not edit — this file is regenerated on every sync. -->
 
@@ -117,13 +117,16 @@ localize every skill that still has **no `skill_triggers` entry** — that is St
 triggers" list, plus, when Step 3 just set the language, all skills. Skip entirely when the language is
 English or every skill already has an entry.
 
-1. **Capture the current `.prospec.yaml` content verbatim** as a snapshot to restore from
-2. Translate ONLY those skills' English trigger baselines into `artifact_language`
-3. **Show the proposed translations and wait for confirmation** before writing anything
-4. On confirmation, add the new `skill_triggers` keys by a **minimal in-place edit** — insert only the
+1. Run `prospec agent triggers` (Bash) to get a ready-to-translate `skill_triggers` scaffold — the skills
+   still missing an entry, each with its English baseline sourced from the CLI (authoritative; never grep
+   a deployed SKILL.md, whose frontmatter already merges custom words)
+2. **Capture the current `.prospec.yaml` content verbatim** as a snapshot to restore from
+3. Translate each scaffold value into `artifact_language`
+4. **Show the proposed translations and wait for confirmation** before writing anything
+5. On confirmation, add the new `skill_triggers` keys by a **minimal in-place edit** — insert only the
    missing keys; never re-serialize the file or touch existing keys, their order, or comments
-5. Read `.prospec.yaml` back and confirm it still parses as valid YAML; if not, restore the snapshot
-6. If anything changed in Step 2, Step 3, or Step 4, run `prospec agent sync` (Bash) so the language,
+6. Read `.prospec.yaml` back and confirm it still parses as valid YAML; if not, restore the snapshot
+7. If anything changed in Step 2, Step 3, or Step 4, run `prospec agent sync` (Bash) so the language,
    localized triggers, and refreshed docs land in each SKILL.md frontmatter and the entry config
 
 ## Output Contract