vault-skill-factory

用途

Vault Skill Factory 用于把一组成熟、经过整理的 wiki 页面转化为一个可移植的 Agent Skill。它输出一个技能包，包含 SKILL.md 以及 references/ 文件夹，并写入审查目录，供人工检查后自行决定是否安装。

它是 wiki-capture 的逆过程：capture 把一次对话变成页面；factory 把一批页面变成可复用的技能。

从用户指定的主题、标签、项目或页面出发，扩展出一个页面集群。
若配置了 QMD（QMD_WIKI_COLLECTION），可用 qmd query 或 vsearch 按语义查找相关页面；否则按标签和 wikilink 邻域用 Grep/Glob 查找。
按成熟度过滤：保留 lifecycle 属于 SKILL_FACTORY_MATURITY（默认 reviewed,verified）或 tier 为 core 的页面，除非用户明确要求包含草稿。
设计技能：确定 kebab-case 名称、具有触发性的 description、推理方法，以及哪些页面正文成为 references/ 文件。
生成技能包结构：SKILL.md（frontmatter + 推理方法 + 关键知识）、references/（按子主题拆分的深度材料与 sources.md 溯源）、SKILL_FACTORY.md（工厂元数据清单，不属于可安装技能）。
保留 ^[inferred] / ^[ambiguous] 标记，避免把综合推断洗成事实。
可选：若用户要求，在输出目录追加/更新 marketplace.json 条目（OpenKB 一行安装约定），仍只是清单而非安装。
可选：借助 skill-creator 的脚本（improve_description.py、package_skill.py、quick_validate.py）打磨或校验产物。

解析配置（Config Resolution Protocol）：获取 OBSIDIAN_VAULT_PATH、OBSIDIAN_WIKI_REPO、OBSIDIAN_LINK_FORMAT、QMD 变量，以及 SKILL_FACTORY_OUTPUT_DIR（默认 $OBSIDIAN_VAULT_PATH/_generated-skills）和 SKILL_FACTORY_MATURITY（默认 reviewed,verified）。
读取 index.md 了解知识库内容。
选择集群：从用户意图出发扩展页面集群，按成熟度过滤，并在生成前与用户确认页面名称与数量。若成熟页面少于约 3 个，应说明并询问是否继续或扩大范围。
设计技能：确定名称、description、推理方法与深度材料。
写入审查目录：创建 $SKILL_FACTORY_OUTPUT_DIR/<name>/，包含 SKILL.md、references/、SKILL_FACTORY.md。
可选使用 skill-creator 脚本。
报告并停止：告知路径、所用集群、触发描述，以及如需安装的手动、仅项目本地安装步骤。

绝不写入 .skills/，绝不运行 setup.sh，绝不创建指向全局技能目录（如 ~/.claude/skills、~/.codex/skills）的符号链接。
生成的技能只写入审查目录；安装是独立且明确的人工决定。
绝不自动安装；结束时只告知位置与安装方法，不代为安装。
源页面是可信的知识库内容，但不得凭空发明能力：生成的技能必须反映页面实际所述。
_generated-skills/ 存放运行时 Agent-Skill 包（含 name + description frontmatter），不是 wiki 页面，绝不写入 skills/（该分类用于知识页面，受图谱/lint/索引跟踪）。
安装示例（用户自行决定，仅项目本地）：ln -s ../../.skills/<name> <repo>/.claude/skills/<name>（需先将 <name>/ 复制到 .skills/，并去掉 SKILL_FACTORY.md）。
明确提示：先审查；不要运行 setup.sh（它会把技能扩散到全局目录）；未经明确同意绝不全局安装。