SuperAPI AI 工具集

product-init

通用与其它

查看项目

更新于 10-15 23:58

技能介绍

用途:从已建成产品(brownfield)反向推导产品决策,生成 PDR(产品决策记录)文档,适合无正式 PDR 的既有产品、需要产品文档的老代码库、团队入职讲解或收购/继承的代码库。不适用于新产品(改用 /product-specify)或小幅 PDR 更新(改用 /product-clarify)。

主要能力:采用三阶段管道——Discovery Agent 逐功能领域扫描代码、文档、定价等原始信号;Pattern Agent 将信号归类到 PDR 类别(Problem、Persona、Scope、Metric 等)并评战略重要性(0.0-1.0);Synthesis Agent 做跨功能领域分析并标记不一致。输出为 .adlc/drafts/pdr/ 下状态为 Discovered 的 PDR-{NNN}.md 文件及自动生成的 pdr.md 索引。

使用方式:先运行 setup 脚本解析路径并检测功能领域,bash 为 sh scripts/bash/setup-product-init.sh [--json],PowerShell 为 scripts/powershell/setup-product-init.ps1;依赖 product-clarify 技能,安装命令:adlc-cli skills add tikalk/adlc-team-skills --skill product-clarify。随后确认检测到的功能领域(≤3 自动批准,4-6 需用户确认,超过 6 建议分组),依次运行各阶段,写入 PDR 文件并重新生成索引。PDR 编号扫描现有文件取最大值加一,三位补零,编号不复用。状态写入 .adlc/product/state.json。

限制:brownfield PDR 必须基于真实代码和文档证据,不得编造依据;发现型 PDR 状态应为 Discovered 而非 Proposed;不一致标记应嵌入受影响的 PDR,不单独建文件。配置项包括 PDR_DRAFTS_DIR、PDR_INDEX、PRD_FILE、STATE_FILE。其他收费、平台、效果等信息暂未提供。