SuperAPI AI 工具集

factory-product

办公与效率

查看项目

更新于 10-16 02:13

技能介绍

用途

factory-product 用于编排产品决策生命周期,协调各单项产品技能,以维护一份一致的 PRD.md,路径为 docs/adlc/product/PRD.md(ADR-401)。

主要能力

它作为 Kind-A DAG 编排器运行,对齐 factory-mission/references/executor.md 中的共享执行器引擎契约,实现固定的命名技能 DAG(固定步骤解析)。

生命周期 DAG 与步骤解析

绿地路线(空项目默认)

  • specify(generate 阶段)→ 调用 product-specify,协作采集 PDR 草稿到 .adlc/drafts/pdr/。
  • clarify⭐(clarify 阶段)→ 调用 product-clarify,执行交互式质量检查并将 PDR 标记为 Accepted(人工签核门)。
  • implement(build 阶段)→ 调用 product-implement,将接受的 PDR 编译为 docs/adlc/product/PRD.md 并提升到 docs/adlc/memory/pdr/。
  • analyze(analyze 阶段)→ 调用 product-analyze,校验 PRD/PDR 一致性并输出按严重度排序的报告。

棕地路线(存在代码但无 PDR 时默认)

  • init(generate 阶段)→ 调用 product-init,从现有代码库逆向生成 PDR 草稿。
  • clarify⭐ → implement → analyze(同绿地路线)。

刷新路线(PRD.md 与 memory PDR 已存在时默认)

  • analyze(analyze 阶段)→ 先运行 product-analyze 检测漂移。
  • clarify⭐ → implement → analyze(漂移修正循环)。

共享执行器覆盖

factory-product 对共享执行器引擎原语的覆盖如下:

  • 发布目标:固定为 local。输出写入 docs/adlc/memory/pdr/ 和 docs/adlc/product/PRD.md。若集成追踪器,还会发布追踪器完成摘要评论。
  • 输出类型:各步骤使用以下 output_type 分配:
    • specify/init → draft(PDR 草稿留在 .adlc/drafts/pdr/,不发布到评论总线)
    • clarify⭐ → decision(接受/拒绝的 PDR 列表发布到评论总线)
    • implement → artifact-ref(发布 PRD.md 路径引用,内容保留在磁盘上)
    • analyze → findings(按严重度排序的一致性报告发布到评论总线)
  • 修正循环:若 analyze 返回 CRITICAL 或 HIGH 一致性错误,执行器会带着 reads_from 中的 analyze 标记路由回 clarify。clarify 从 PR/MR/issue 评论总线(或本地回退)读取 findings。此循环受 max_corrections 限制(默认 2);若超出,编排器停止等待人工审查。
  • 监督默认值:hybrid。在 clarify⭐(PDR 审批)和最终 PRD.md 审查处硬性强制执行人工门。
  • 预检:在开始 Phase 0 之前,验证工作区中安装了 product-* 生命周期技能。

使用方式

当需要端到端引导、完善或分析产品需求与决策(PDR)时使用;当需要引导式、验收门控且可验证并带恢复检查点的产品定义流程时使用。

适用场景

  • 引导、完善或分析产品需求与决策(PDR)的端到端流程。
  • 需要引导式、验收门控和可验证且带恢复检查点的产品定义过程。

限制

  • 不适用于软件实现任务执行(应使用 factory-mission)。
  • 不适用于架构决策记录(应使用 factory-architect)。