skill-authoring-workflow — 把粗糙笔记变成合规 Claude 技能的编写工作流

技能概述

skill-authoring-workflow(技能编写工作流)是一个六阶段结构化工作流,帮你把粗糙笔记、工作坊内容或半成品提示词,转化为通过验证、符合仓库规范的 SKILL.md 技能资产——不靠"看起来没问题"碰运气,而是按明确的完成标准交付。

适用场景

1. 从原始素材创建新技能:手上有会议记录、研究文档或框架草稿,想把它们沉淀成仓库里一个可复用的 PM 技能,却不确定从哪一步下手。
2. 更新现有技能而不破坏标准:需要修改一个已发布的技能,同时保证 frontmatter、章节顺序和元数据限制都保持合规。
3. 提交前跑完整编写与验证流程:技能草稿已经写好,想在做任何提交动作之前,把结构检查、元数据校验和 README 目录更新一次性做完。

核心功能

1. 六阶段结构化流程:查重预检(避免重复造轮子)→ 草稿生成 → 内容打磨 → 严格验证 → 仓库文档集成 → 可选打包,每一步都有明确动作,不会写完就散。
2. 复用仓库原生工具链:内置优先调用 find-a-skill、add-a-skill、build-a-skill、test-a-skill 等脚本和元数据检查器,用现成标准流程代替自造流程。
3. 明确的完成标准(Definition of Done):8 项硬性检查——frontmatter 有效、章节顺序合规、名称与描述长度达标、触发时机清晰、交叉引用可解析、README 计数同步更新等,全部通过才算完成。

常见问题

我只有一堆粗糙的会议笔记,能用吗?

可以,"粗糙"正是它的标准输入。工作流的存在意义就是把半成品素材推进到合规可发布的状态——你只需要提供素材和意图(比如"把这份定价工作坊笔记变成一个交互式顾问技能"),它会从预检阶段开始推进,不会反复追问你已经给过的信息。材料为零时,它也会先问清你要转化什么内容再启动。

和直接跑一次 build-a-skill 脚本有什么区别?

脚本只覆盖单个环节:向导脚本适合"有想法但还没写正文"的情况,内容优先脚本适合"已经有素材"的情况。这套工作流把素材转化、类型判断、内容打磨、验证脚本调用、README 目录更新和打包上传串成完整链路,并在最后用完成标准逐项把关——单跑脚本不会替你做查重预检和目录计数同步。

技能验证通过后,能直接打包上传到 Claude 吗?

可以。工作流最后是可选的打包阶段,支持按单个技能、按类别或按预设组合(如核心 PM 技能包)输出 zip 压缩包,可直接用于 Claude 自定义技能上传。需要注意:上传前仍建议人工复核生成内容,该工作流明确将"把生成结果当最终稿直接发布"列为反模式。