SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场utility-pm-skill-builder

utility-pm-skill-builder

智能体与模型

查看项目

更新于 10-15 14:13

技能介绍

用途

PM Skill Builder 用于为 pm-skills 库创建新的 PM 技能。它产出一个「技能实现包」（Skill Implementation Packet）——一份完整的设计文档，包含位于暂存区的草稿文件，供评审后再提升到规范位置。

适用时机：

  • 当你有一个新的 PM 技能想法时
  • 当你想要向 pm-skills 库添加领域技能（阶段特定）、基础技能（跨领域）或工具技能（元/工具类）时
  • 当贡献者需要遵循仓库规范的引导式技能创建时

不适用时机：

  • 修改或改进已有技能 → 使用 utility-pm-skill-iterate
  • 按规范审计已有技能 → 使用 utility-pm-skill-validate
  • 为非 pm-skills 场景创建技能 → 使用通用 agent 技能构建器
  • 创建工作流 → 工作流直接编写，不通过此构建器

主要能力

该技能按步骤引导完成技能创建：

  1. 理解想法：接受「问题优先」或「技能优先」两种入口形式，两者产生相同的下游流程。若想法模糊，只追问一个问题以澄清产物类型与目标受众。

  2. 差距分析：检查所有现有技能（domain、foundation、utility、tool 四个族）是否存在重叠，具体列出重叠技能并说明其覆盖范围，指出新技能将填补的具体空白。若重叠度高，触发 Why Gate，要求用户给出 2-3 个现有技能无法满足的具体提示或场景；若无法说明，则触发 Kill Gate，建议改为修订现有技能、组合工作流、添加命令变体或改进文档。

  3. 范围检查：评估想法应为一个技能还是多个技能。拆分信号包括：产生多种不同产物类型、跨越 Triple Diamond 阶段、描述中自然出现连接两个活动的「and」。

  4. 分类与仓库适配：确定技能分类与命名。领域技能使用 {phase}-{skill-name} 目录与 phase: 前置字段；基础技能使用 foundation-{skill-name} 与 classification: foundation；工具技能使用 utility-{skill-name} 与 classification: utility。随后从三种受认可方言（classic、contract-shaped、tool-family）中选择方言，并挑选 1-2 个同方言、结构最接近的现有技能作为范例。

  5. 评估就绪（eval contract）：确定最近邻（1-3 个触发重叠的现有技能）、互惠边界指针（草稿 SKILL.md 必须包含 ## When NOT to Use 章节，并在邻居技能中回指新技能）、输出评估族（framing、specification、discovery、technical、measurement、learning、communication 等族，族评分标准位于 docs/internal/eval-rubrics/{family}.md）、以及 fixture 与场景计划。

  6. 生成技能实现包：使用 references/TEMPLATE.md 作为格式，产出决策、分类、重叠分析、范例技能、草稿前置字段、草稿 SKILL.md、草稿 TEMPLATE.md、草稿 EXAMPLE.md、草稿命令、AGENTS.md 条目、校验清单、后续步骤、草稿 trigger-fixtures.json 与草稿 output-scenario。

  7. 写入暂存区：所有生成文件写入 _staging/pm-skill-builder/{skill-name}/（该目录被 gitignore，草稿不会随发布发布）。

  8. 提升（确认后）：将各文件从暂存区复制到规范位置，追加 AGENTS.md 条目，必要时更新 COLLISION_PAIRS 与邻居的互惠指针，运行 CI 校验与评估资产门禁，重新生成目录表面，校验通过后删除暂存文件夹。

使用方式

该技能以斜杠命令形式调用（命令名由生成的 command.md 决定）。使用时提供你的 PM 技能想法，可以是问题优先或技能优先形式。构建器会逐步引导，并在关键节点（分类、方言、范例、邻居与评估计划）请求用户确认。

提升阶段会运行以下校验命令：

bash scripts/lint-skills-frontmatter.sh && bash scripts/validate-agents-md.sh && bash scripts/validate-commands.sh
node scripts/check-trigger-fixtures.mjs
node scripts/check-output-eval-assets.mjs
node scripts/check-reciprocal-boundary-pointers.mjs
node scripts/check-new-skill-collision.mjs --skill={name}
node scripts/gen-skill-manifest.mjs && node scripts/gen-skill-manifest.mjs --agents

输出契约

构建器必须为新技能产出草稿文件：

  • SKILL.md（完整技能说明，含命名邻居的 When NOT to Use 章节）
  • references/TEMPLATE.md（带指导注释的输出模板）
  • references/EXAMPLE.md（完整实例，150-300 行）
  • evals/trigger-fixtures.json（路由评估 fixture）
  • evals/output-scenarios/{id}.md（输出质量场景 + 族评分标准）
  • command.md（斜杠命令文件）

所有草稿写入 _staging/pm-skill-builder/{skill-name}/。提升时复制到规范位置、更新 AGENTS.md，并丢弃暂存文件夹。

适用场景

适用于 pm-skills 仓库的贡献者，希望以符合仓库规范的方式新增 PM 技能，并确保新技能具备路由评估与输出质量评估资产、与现有技能边界清晰、不产生触发冲突。

限制

  • 仅用于创建新技能，不用于修改、审计已有技能或创建工作流。
  • 仅适用于 pm-skills 上下文。
  • 依赖仓库内的脚本、清单文件（skill-manifest.json、AGENTS.md）与评估评分标准；这些文件的具体内容与当前技能总数需在运行时从仓库读取，本资料未提供具体数值。
  • 关于收费、价格、平台支持等信息，资料中暂未提供。