name: skill-authoring-workflow description: 通过选择构建/添加路径、运行符合性检查和更新文档，将原始PM内容转化为合规、可发布的技能。 type: workflow
目的
创建或更新PM技能而不混乱。此工作流将粗略笔记、研讨会内容或半成品的提示转储转化为合规的skills/<技能名称>/SKILL.md资产，这些资产实际上通过验证并属于此存储库。
当您想推出新技能而不依赖“看起来不错”的轮盘赌时使用它。
关键概念
优先使用自有工具
在发明自定义流程之前，使用存储库原生工具和标准：
scripts/find-a-skill.shscripts/add-a-skill.shscripts/build-a-skill.shscripts/test-a-skill.shscripts/check-skill-metadata.py
选择正确的创建路径
- 引导向导 (
build-a-skill.sh): 当您有想法但没有最终文案时最佳。 - 内容优先生成器 (
add-a-skill.sh): 当您已有源内容时最佳。 - 手动编辑 + 验证: 用于收紧现有技能最佳。
完成定义（无例外）
一个技能仅在以下情况下完成：
- 前题元数据有效（
name,description,type） - 章节顺序合规
- 元数据限制得到遵守（
name<= 64字符,description<= 200字符） - 交叉引用解析
- README目录计数和表格已更新（如果添加/移除技能）
引导真实来源
当以此工作流作为引导对话运行时，使用workshop-facilitation作为交互协议。
它定义：
- 会话提醒 + 进入模式（引导、上下文转储、最佳猜测）
- 单问题轮次与通俗语言提示
- 进度标签（例如，上下文 Qx/8 和评分 Qx/5）
- 中断处理与暂停/恢复行为
- 决策点的编号推荐
- 常规问题的快速选择编号响应选项（在有用时包含
其他（指定））
此文件定义工作流序列和领域特定输出。如果有冲突，遵循此文件的工作流逻辑。
应用
阶段1：预检（避免重复工作）
- 搜索重叠技能：
./scripts/find-a-skill.sh --keyword "<主题>"
- 决定类型：
- 组件: 一个工件/模板
- 交互式: 3-5个自适应问题 + 编号选项
- 工作流: 多阶段编排
阶段2：生成草稿
如果您有源材料：
./scripts/add-a-skill.sh research/your-framework.md
如果您想要引导提示：
./scripts/build-a-skill.sh
阶段3：收紧技能
手动审查：
- 清晰的“何时使用”指导
- 一个具体示例
- 一个明确的抗模式
- 无填充或模糊的顾问语
阶段4：严格验证
在考虑提交前运行严格检查：
./scripts/test-a-skill.sh --skill <技能名称> --smoke
python3 scripts/check-skill-metadata.py skills/<技能名称>/SKILL.md
阶段5：与存储库文档集成
如果这是新技能：
- 将其添加到正确的README类别表
- 更新技能总数和类别计数
- 验证链接路径解析
阶段6：可选打包
如果针对Claude自定义技能上传：
./scripts/zip-a-skill.sh --skill <技能名称>
# 或打包一个类别：
./scripts/zip-a-skill.sh --type component --output dist/skill-zips
# 或使用策划的入门预设：
./scripts/zip-a-skill.sh --preset core-pm --output dist/skill-zips
示例
示例：将研讨会笔记转化为技能
输入：research/pricing-workshop-notes.md
目标：新交互式顾问
./scripts/add-a-skill.sh research/pricing-workshop-notes.md
./scripts/test-a-skill.sh --skill <新技能名称> --smoke
python3 scripts/check-skill-metadata.py skills/<新技能名称>/SKILL.md
预期结果：
- 新技能文件夹存在
- 技能通过结构和元数据检查
- README目录条目添加/更新
抗模式示例
“我们写了一个酷技能，跳过验证，忘记README计数，但还是发布了。”
结果：
- 断裂的引用
- 不一致的目录编号
- 贡献者和用户的混淆
常见陷阱
- 发布氛围，而非标准。
- 当任务实际上是组件模板时选择
工作流。 - 臃肿的描述超过上传限制。
- 添加技能后忘记更新README计数。
- 将生成输出视为最终版本而不审查。
参考
README.mdAGENTS.mdCLAUDE.mddocs/Building PM Skills.mddocs/Add-a-Skill Utility Guide.mdscripts/add-a-skill.shscripts/build-a-skill.shscripts/find-a-skill.shscripts/test-a-skill.shscripts/check-skill-metadata.pyscripts/zip-a-skill.sh