文档转Claude技能策展

要解决的具体问题

在把文档或仓库转成 Agent 技能时，常见的坑：一是把整本文档塞进技能，导致 Agent 抓不住重点还浪费 token；二是多个技能触发词重叠，比如都匹配「数据库」，互相抢指令；三是忽略文档版本，生成过时建议。这款技能的目标是把杂乱文档提炼成「何时用、怎么用、易错点」的可执行卡片，避免技能之间抢地盘。

技能如何工作

作为「技能包策展人」，它通过五步将文档转为可用技能：

• 采集：拉取文档、仓库或 PDF，先去噪、分段；
• 提炼：抽取「触发场景+操作步骤+易错点」，拒绝整本照搬；
• 命名：生成唯一 slug 与触发词，防止主题重叠；
• 检测：与已有技能比对冲突，同主题合并或用更细条件区分；
• 落地：固化写入 SKILL.md，保证可复用。

落地时需先定范围（一次只处理一个技术栈/主题），结构化抽取为「角色/何时用/步骤/陷阱」四段，再验证触发准确性。

适用边界与注意点

• 自动生成的技能以官方最新文档为准，旧版文档易给出过时建议；
• 关键 API、命令需人工核对官方资料，避免误导；
• 一次只聚焦一个技术栈，贪大会导致技能冗余或冲突。