SuperAPI AI 工具集

utility-pm-workflow-builder

办公与效率

查看项目

更新于 10-14 18:47

技能介绍

用途

PM Workflow Builder 用于为 pm-skills 库创建新的多技能工作流。它的产出是一个工作流实现包(Workflow Implementation Packet),包含:草稿 _workflows/<name>.md 文件、草稿 commands/workflow-<name>.md 命令,以及跨文件更新清单。所有内容写入暂存区供审查,之后再提升到正式位置。该构建器只做撰写,从不执行工作流链,也从不把自己的产出提升为正式内容。

适用场景

  • 你有一个新的多技能工作流想法(例如“我需要一个季度业务回顾的工作流”)。
  • 你已明确想串联的技能,并希望持久化记录(例如“串联 competitive-analysis、experiment-results、pivot-decision”)。
  • 一次 /chain 运行(编排器 Mode B)被证明可复用,其完成输出建议把该链提升为持久工作流;把该建议中的精确链式表达式交给本技能。

不适用场景

  • 只想运行一次序列而不撰写任何内容:使用 /chain 命令或 utility-pm-workflow-orchestrator。
  • 构建或修改单个技能:使用 utility-pm-skill-builder、utility-pm-skill-validate 或 utility-pm-skill-iterate。
  • 自定义已有工作流:直接编辑其 _workflows/<name>.md;当覆盖度高时,重叠分析会指引你到那里。

主要能力与使用方式

该技能按以下步骤运作:

  1. 理解想法:接受三种入口形式(问题优先、技能优先、链式提升),均汇入同一后续流程。如果想法模糊,只问一个澄清问题(重复触发的场景与最终产物),然后继续。
  2. 重叠分析与 Why Gate:在运行时扫描 _workflows/ 目录获取当前清单(列出除 README.md 外的所有 *.md),不依赖记忆中的数量或硬编码列表。与所有现有工作流比较,指出重叠项、覆盖内容和差距。覆盖重叠超过 70% 时触发终止门,建议改为自定义现有工作流、给它加步骤或直接用 /chain,不继续。存在任何有意义重叠时触发 Why Gate,要求提供 2-3 个现有工作流无法满足需求的具体场景;无此证据或用户明确覆盖(记录在包的 Decision 部分)则不通过。
  3. 序列设计:与用户一起选择和排序步骤,撰写时应用链式表达式契约的校验规则(见 skills/utility-pm-workflow-orchestrator/references/PARSE-CONTRACT.md 的 Mode B Chain Expression Contract)。每一步必须按精确名称解析到已安装技能 skills/<name>/SKILL.md;名称不匹配时拒绝该步骤并提供最接近的真实名称(只提供建议,绝不替换)。仅允许 Category 1 内容技能。拒绝作为步骤的包括:Tier-3 维护技能(utility-pm-skill-*、utility-pm-release-conductor、utility-pm-changelog-curator、utility-update-pm-skills、foundation-prioritized-action-plan)、向子智能体分发的调度技能(utility-pm-critic、utility-pm-workflow-orchestrator 等),以及已有工作流(工作流不嵌套工作流)。本构建器自身为 Tier-3,因此自引用在构造上不可能。每一步都要编写交接说明:该步骤从前一步输出中消费什么、必须为下一步产出什么。没有真实交接的实现包不算就绪。
  4. 生成实现包:写入 _staging/workflows/<name>/(被 gitignore 忽略;与技能构建器相同的审查模型),绝不写入正式位置。目录结构为:workflow.md(草稿 _workflows/<name>.md)、command.md(草稿 commands/workflow-<name>.md)、PACKET.md(决策、重叠分析、清单、提升步骤)。使用 references/TEMPLATE.md 作为包格式。工作流草稿必须包含当前 _workflows/*.md 文件共有的完整章节清单(见模板内嵌骨架);命令草稿镜像现有 commands/workflow-*.md 形态,包括每步一个字面 skills/<name>/SKILL.md 路径和 $ARGUMENTS 页脚。根据最终序列派生线性 mermaid 上下文流程图(步骤名为节点,执行顺序为边)。
  5. 审查与提升指引:展示实现包并停止。构建器本身绝不提升。获批后,由用户(或后续会话)把草稿移到正式路径,并处理包中的跨文件清单,该清单列出添加工作流会触及的每个计数与文档面,包括校验器不覆盖的 .github/workflows/release.yml 发布说明模板。构建器绝不自己编辑这些跨文件。

输出格式

实现包遵循 references/TEMPLATE.md:

  • Decision:建议加 Why Gate 证据(或记录的覆盖)。
  • Overlap Analysis:每个重叠工作流、其覆盖内容、差距。
  • Workflow Draft:完整的 _workflows/<name>.md 内容。
  • Command Draft:完整的 commands/workflow-<name>.md 内容。
  • Cross-Cutting Checklist:提升时需要更新的每个面及其执行校验器(没有则标为 validator-blind)。
  • Promotion Steps:移动-验证-校验序列。

参考文件包括:模板 references/TEMPLATE.md、完整示例 references/EXAMPLE.md(季度业务回顾)、撰写时应用的链式表达式契约 skills/utility-pm-workflow-orchestrator/references/PARSE-CONTRACT.md、工作流范例 _workflows/sprint-planning.md 与 _workflows/customer-discovery.md、命令范例 commands/workflow-sprint-planning.md、单技能的同级构建器 skills/utility-pm-skill-builder/SKILL.md。

质量清单

展示实现包前需验证:重叠分析扫描了实时 _workflows/ 目录(无记忆列表、无硬编码计数);Why Gate 证据具体(具名场景)或记录了明确覆盖;每一步按精确名称解析到已安装技能;没有 Tier-3 维护技能、调度技能或工作流作为步骤出现;每一步都有撰写的交接(消费/产出),而非仅技能名;工作流草稿包含模板骨架中的每个章节(元数据表、带 Do NOT use 的 When to Use、逐步块、上下文流程图、提示、质量清单、see also);命令草稿命名每步的 skills/<name>/SKILL.md 路径并以 $ARGUMENTS 页脚结尾;mermaid 图与最终序列完全一致;所有内容写在 _staging/workflows/<name>/ 下,未触碰任何正式路径;跨文件清单完整复现,包括 .github/workflows/release.yml 发布说明行。

限制

该技能只撰写不执行,也不提升自己的产出。它不能编辑跨文件更新清单中列出的文件。步骤仅限 Category 1 内容技能,且必须按精确名称匹配。关于收费、价格、平台或效果等信息,资料中暂未提供。