尧图网站建设 
如何为pm-skills贡献一个新技能完整开发流程与验证脚本使用指南【免费下载链接】pm-skillsPM Skills Marketplace: 100 agentic skills, commands, and plugins — from discovery to strategy, execution, launch, and growth.项目地址: https://gitcode.com/GitHub_Trending/pm/pm-skillspm-skillsPM Skills Marketplace是一个面向产品管理者的 AI 技能市场收录了 9 大插件、68 个技能与 42 个命令。想为 pm-skills 贡献一个新技能并不复杂按现有目录结构编写 SKILL.md、遵循 frontmatter 规范、最后运行官方验证脚本 validate_plugins.py 即可。本文带你走完整条开发流程让你第一次提交 PR 就能顺利通过审查。快速了解 pm-skills 的项目结构动手前先搞清楚技能和命令的区别这是贡献指南 CONTRIBUTING.md 中最重要的两条约定概念比喻存放位置加载方式Skill技能名词领域知识skills/{技能名}/SKILL.md话题相关时自动加载Command命令动词工作流commands/{命令名}.md用户通过/命令名触发以 pm-data-analytics 插件为例它的技能 sql-queries 负责自然语言转 SQL的领域知识而命令 write-query.md 则把该技能串成/write-query工作流。两者各司其职很多命令还会复用同一个技能。贡献前的第一步选对入口CONTRIBUTING.md 对贡献渠道有明确分工Bug、错别字等小改动—— 直接开 PR新技能、新命令或较大改动—— 先开一个 Issue 讨论方案再动手同时记住两条硬性规范每个技能必须有 YAML frontmatter包含name和description技能的name必须与目录名完全一致。仓库结构约定详见 CLAUDE.md它是项目维护的唯一事实来源每个插件都遵循相同的骨架pm-{插件名}/ ├── .claude-plugin/plugin.json ← 插件清单 ├── skills/{技能名}/SKILL.md ← 一个技能一个文件夹 ├── commands/{命令名}.md ← 一个命令一个文件 └── README.md ← 插件说明文档五步完成一个新技能的开发第 1 步克隆仓库git clone https://gitcode.com/GitHub_Trending/pm/pm-skills cd pm-skills第 2 步创建技能目录与 SKILL.md在目标插件下新建skills/你的技能名/目录并创建 SKILL.md。frontmatter 是最容易出错的地方参考 validate_plugins.py 的校验规则正确写法是--- name: your-skill-name description: 技能是做什么的。Use when 什么场景下触发该技能。 --- # 技能标题 正文写框架步骤、使用示例……三个细节决定成败name必须与目录名一字不差description建议 30 字符以上并包含 use when / use for 等触发词AI 才会在对的时机加载它正文保持在 50~3000 词之间过长可拆分到 references/ 子目录做渐进式披露。第 3 步可选编写配套命令若需要一个/命令来驱动该技能在commands/下新建.md文件frontmatter 需要description和argument-hint两个字段。注意命令中禁止硬引用其他插件跨插件的后续步骤只能用自然语言建议如要不要我帮你设计增长循环。第 4 步同步文档与版本号按 CLAUDE.md 的运维流程新增/删除技能后要做三件事更新对应插件 README 和根 README.md 中的技能计数同步 .claude-plugin/marketplace.json 中的总数描述统一提升版本号——所有插件与 marketplace.json 必须保持同一版本当前均为 2.0.0。第 5 步运行验证脚本 validate_plugins.py这是提交前的最后一道关卡也是 pm-skills 对每个贡献者的明确要求。验证脚本 validate_plugins.py 使用指南在仓库根目录执行python3 validate_plugins.py可选地传入目录参数来校验指定位置python3 validate_plugins.py /路径/。脚本会自动找出所有包含.claude-plugin/的插件目录并逐一检查退出码为 0 表示全部通过。它到底检查了什么检查项错误必须修警告建议修插件清单 plugin.json缺少 name/version/description、名称与目录不符版本不符合 semver、缺少 keywords、author 字段不全技能 SKILL.md缺 frontmatter、缺 name/description、名称与目录不符描述过短、正文过长3000 词或过短50 词命令 .md缺 frontmatter、缺 description缺少推荐字段 argument-hint交叉引用—命令引用了本插件中不存在的技能报告末尾会给出✓ ALL CHECKS PASSED或✗ N ERRORS的总结。只要出现 ERRORPR 大概率会被打回WARN 不阻断合并但建议一并处理。脚本的完整校验逻辑可查阅 validate_plugins.py。提交前自检清单 ✅技能name与目录名一致frontmatter 必填字段齐全技能namedescription命令descriptionargument-hint描述包含触发词长度达标没有跨插件硬引用插件 README 与根 README 计数已更新各插件版本号与 marketplace.json 保持同步python3 validate_plugins.py零错误PR 聚焦单一改动一个 PR 只做一个变更常见问题Q我的贡献会被署名吗会。CONTRIBUTING.md 明确每位贡献者都会被公开列出且贡献按 LICENSEMIT授权。Q只想贡献纯技能不想写命令可以吗完全可以。像 prioritization-frameworks 这类技能就是独立的参考型知识AI 在相关话题下会自动调用无需任何命令。QWindows 上验证脚本中文/特殊字符显示异常脚本已内置 Windows UTF-8 输出兼容处理直接运行即可。掌握技能是名词、命令是动词的核心心智模型再加上验证脚本这道自动门禁你为 pm-skills 贡献的第一个新技能很快就会合入。动手前记得先开 Issue 讨论保持 PR 聚焦验证通过再提交 【免费下载链接】pm-skillsPM Skills Marketplace: 100 agentic skills, commands, and plugins — from discovery to strategy, execution, launch, and growth.项目地址: https://gitcode.com/GitHub_Trending/pm/pm-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何为pm-skills贡献一个新技能？完整开发流程与验证脚本使用指南
如何为pm-skills贡献一个新技能完整开发流程与验证脚本使用指南【免费下载链接】pm-skillsPM Skills Marketplace: 100 agentic skills, commands, and plugins — from discovery to strategy, execution, launch, and growth.项目地址: https://gitcode.com/GitHub_Trending/pm/pm-skillspm-skillsPM Skills Marketplace是一个面向产品管理者的 AI 技能市场收录了 9 大插件、68 个技能与 42 个命令。想为 pm-skills 贡献一个新技能并不复杂按现有目录结构编写 SKILL.md、遵循 frontmatter 规范、最后运行官方验证脚本 validate_plugins.py 即可。本文带你走完整条开发流程让你第一次提交 PR 就能顺利通过审查。快速了解 pm-skills 的项目结构动手前先搞清楚技能和命令的区别这是贡献指南 CONTRIBUTING.md 中最重要的两条约定概念比喻存放位置加载方式Skill技能名词领域知识skills/{技能名}/SKILL.md话题相关时自动加载Command命令动词工作流commands/{命令名}.md用户通过/命令名触发以 pm-data-analytics 插件为例它的技能 sql-queries 负责自然语言转 SQL的领域知识而命令 write-query.md 则把该技能串成/write-query工作流。两者各司其职很多命令还会复用同一个技能。贡献前的第一步选对入口CONTRIBUTING.md 对贡献渠道有明确分工Bug、错别字等小改动—— 直接开 PR新技能、新命令或较大改动—— 先开一个 Issue 讨论方案再动手同时记住两条硬性规范每个技能必须有 YAML frontmatter包含name和description技能的name必须与目录名完全一致。仓库结构约定详见 CLAUDE.md它是项目维护的唯一事实来源每个插件都遵循相同的骨架pm-{插件名}/ ├── .claude-plugin/plugin.json ← 插件清单 ├── skills/{技能名}/SKILL.md ← 一个技能一个文件夹 ├── commands/{命令名}.md ← 一个命令一个文件 └── README.md ← 插件说明文档五步完成一个新技能的开发第 1 步克隆仓库git clone https://gitcode.com/GitHub_Trending/pm/pm-skills cd pm-skills第 2 步创建技能目录与 SKILL.md在目标插件下新建skills/你的技能名/目录并创建 SKILL.md。frontmatter 是最容易出错的地方参考 validate_plugins.py 的校验规则正确写法是--- name: your-skill-name description: 技能是做什么的。Use when 什么场景下触发该技能。 --- # 技能标题 正文写框架步骤、使用示例……三个细节决定成败name必须与目录名一字不差description建议 30 字符以上并包含 use when / use for 等触发词AI 才会在对的时机加载它正文保持在 50~3000 词之间过长可拆分到 references/ 子目录做渐进式披露。第 3 步可选编写配套命令若需要一个/命令来驱动该技能在commands/下新建.md文件frontmatter 需要description和argument-hint两个字段。注意命令中禁止硬引用其他插件跨插件的后续步骤只能用自然语言建议如要不要我帮你设计增长循环。第 4 步同步文档与版本号按 CLAUDE.md 的运维流程新增/删除技能后要做三件事更新对应插件 README 和根 README.md 中的技能计数同步 .claude-plugin/marketplace.json 中的总数描述统一提升版本号——所有插件与 marketplace.json 必须保持同一版本当前均为 2.0.0。第 5 步运行验证脚本 validate_plugins.py这是提交前的最后一道关卡也是 pm-skills 对每个贡献者的明确要求。验证脚本 validate_plugins.py 使用指南在仓库根目录执行python3 validate_plugins.py可选地传入目录参数来校验指定位置python3 validate_plugins.py /路径/。脚本会自动找出所有包含.claude-plugin/的插件目录并逐一检查退出码为 0 表示全部通过。它到底检查了什么检查项错误必须修警告建议修插件清单 plugin.json缺少 name/version/description、名称与目录不符版本不符合 semver、缺少 keywords、author 字段不全技能 SKILL.md缺 frontmatter、缺 name/description、名称与目录不符描述过短、正文过长3000 词或过短50 词命令 .md缺 frontmatter、缺 description缺少推荐字段 argument-hint交叉引用—命令引用了本插件中不存在的技能报告末尾会给出✓ ALL CHECKS PASSED或✗ N ERRORS的总结。只要出现 ERRORPR 大概率会被打回WARN 不阻断合并但建议一并处理。脚本的完整校验逻辑可查阅 validate_plugins.py。提交前自检清单 ✅技能name与目录名一致frontmatter 必填字段齐全技能namedescription命令descriptionargument-hint描述包含触发词长度达标没有跨插件硬引用插件 README 与根 README 计数已更新各插件版本号与 marketplace.json 保持同步python3 validate_plugins.py零错误PR 聚焦单一改动一个 PR 只做一个变更常见问题Q我的贡献会被署名吗会。CONTRIBUTING.md 明确每位贡献者都会被公开列出且贡献按 LICENSEMIT授权。Q只想贡献纯技能不想写命令可以吗完全可以。像 prioritization-frameworks 这类技能就是独立的参考型知识AI 在相关话题下会自动调用无需任何命令。QWindows 上验证脚本中文/特殊字符显示异常脚本已内置 Windows UTF-8 输出兼容处理直接运行即可。掌握技能是名词、命令是动词的核心心智模型再加上验证脚本这道自动门禁你为 pm-skills 贡献的第一个新技能很快就会合入。动手前记得先开 Issue 讨论保持 PR 聚焦验证通过再提交 【免费下载链接】pm-skillsPM Skills Marketplace: 100 agentic skills, commands, and plugins — from discovery to strategy, execution, launch, and growth.项目地址: https://gitcode.com/GitHub_Trending/pm/pm-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考