skill-authoring-workflow

skill-authoring-workflow 是 Product Manager Skills 仓库的主要质量控制机制。它为产品经理提供了一套结构化、以工具优先的方法，将未成形的提示词、粗略的工作坊笔记或实验性框架转化为符合严格仓库标准的专业级资产。通过使用 find-a-skill.sh、add-a-skill.sh 和 test-a-skill.sh 等原生脚本，此流程消除了主观臆测，确保每一项新贡献都能立即部署且易于搜索。其设计旨在减少贡献者的阻力，同时最大化所得 AI 代理的可靠性。

• 优化从非结构化想法到完整格式化 skills/SKILL.md 资产的转换过程。

• 对前端内容 (frontmatter)、元数据限制（名称 ≤ 64 字符，描述 ≤ 200 字符）及章节顺序执行严格的验证门槛。

• 提供引导式向导或内容优先生成器，协助根据原始素材进行内容产生。

• 自动化仓库整合任务，包括 README 表格更新、技能计数递增及交叉参照解析。

• 提供强大的测试套件，用于冒烟测试、元数据审计及触发词验证。

• 支持将技能打包为可分发的 ZIP 包，适用于 Claude Desktop、Codex 及企业级 CLI 工具等各种代理环境。

• 专为需要扩展内部工具组且不希望产生技术债的 PM、开发人员及 AI 工程师设计。

• 在作为交互式顾问使用时，需遵循 workshop-facilitation 协议。

• 必须强制使用 check-skill-metadata.py 脚本以满足「完成定义 (Definition of Done)」要求。

• 非常适合将旧版文档转化为可执行的代理逻辑。

• 避免常见陷阱，如冗长的描述、模糊的触发语言及断裂的依赖链接。

• 要求持续使用标准化 CLI 工具，以避免凭感觉开发并确保输出质量的可预测性。