SuperAPI AI 工具集

product-capability

办公与效率

查看项目

更新于 10-15 10:24

技能介绍

用途

Product Capability 用于把产品意图转化为明确的工程约束。它适用的场景是:当问题不是“我们应该构建什么”,而是“在实现开始之前,究竟必须满足哪些条件”。

具体触发时机包括:

  • 已有 PRD、路线图条目、讨论或创始人笔记,但实现约束仍然隐含未明;
  • 某个功能跨越多个服务、仓库或团队,需要在编码前先有“能力契约”;
  • 产品意图清晰,但架构、数据、生命周期或策略影响仍然模糊;
  • 高级工程师在评审中反复重申同样的隐藏假设;
  • 需要一份可跨工具与跨会话复用的制品。

主要能力

该技能的核心工作流分为四步:

  1. 重述能力:把需求压缩为一句精确陈述,说明用户或操作者是谁、本次发布后新增了什么能力、因此改变了什么结果。
  2. 解析能力约束:提取实现前必须成立的约束,包括业务规则、范围边界、不变量、信任边界、数据所有权、生命周期转换、发布/迁移要求、失败与恢复预期。
  3. 定义面向实现的契约:产出 SRS 风格的能力计划,包含能力摘要、明确的非目标、参与者与界面、所需状态与转换、接口/输入/输出、数据模型影响、安全/计费/策略约束、可观测性与操作者要求、阻塞实现的开放问题。
  4. 转化为执行:给出明确交接结论——可直接实现、需先做架构评审、或需先做产品澄清。如有需要,可指向后续 ECC 原生通道:project-flow-ops、workspace-surface-audit、api-connector-builder、dashboard-builder、tdd-workflow、verification-loop。

使用方式

该技能只读取必要内容:产品意图(issue、discussion、PRD、路线图笔记、创始人消息)、当前架构(相关仓库文档、契约、schema、路由、现有工作流)、已有能力上下文(PRODUCT.md、设计文档、RFC、迁移笔记、运营模型文档)、交付约束(认证、计费、合规、发布、向后兼容、性能、评审策略)。

若仓库已有持久的产品上下文文件(如 PRODUCT.md、docs/product/ 或 program-spec 目录),则更新该处。若尚无能力清单,则使用模板 docs/examples/product-capability-template.md 创建。

输出按固定顺序返回:CAPABILITY(一段式重述)、CONSTRAINTS(固定规则、不变量与边界)、IMPLEMENTATION CONTRACT(参与者、界面、状态与转换、接口/数据影响)、NON-GOALS(本通道明确不负责的内容)、OPEN QUESTIONS(仍需的阻塞项或产品决策)、HANDOFF(下一步应做什么、由哪个 ECC 通道接手)。

适用场景

适合在功能跨多服务/多团队、产品意图清晰但实现约束模糊、评审反复出现隐藏假设、需要可复用制品时使用。

限制

该技能有若干不可协商的规则:不得虚构产品事实,未解决的问题必须明确标记;必须区分用户可见承诺与实现细节;必须指出哪些是固定策略、哪些是架构偏好、哪些仍然开放;若请求与现有仓库约束冲突,必须明确指出而非粉饰;优先产出一份可复用的能力制品,而非零散临时笔记。

关于该技能的收费、价格、平台支持范围等具体信息,资料中暂未提供。