SuperAPI AI 工具集

product-clarify

通用与其它

查看项目

更新于 10-15 23:58

技能介绍

用途:在正式生成 PRD 之前充当质量门,审阅 .adlc/drafts/pdr/ 下状态为 Proposed 或 Discovered 的 PDR-*.md 文件,提出针对性澄清问题,并把获批的 PDR 提升为 Accepted。适用时机为 /product-specify 或 /product-init 之后、/product-implement 之前(实现会跳过非 Accepted 的 PDR),以及里程碑前的定期审查和解决跨功能域分析标记的不一致。无 PDR 时不应使用,应先用 /product-specify 或 /product-init。

主要能力:先运行初始化脚本,bash 为 sh: scripts/bash/setup-product-clarify.sh [--json],PowerShell 为 scripts/powershell/setup-product-clarify.ps1;读取 PDR 文件与章程(docs/adlc/memory/constitution.md,兼容旧路径 .adlc/memory/constitution.md)。可识别轻量草稿格式并转换为完整模板。质量分析覆盖 Context、Decision、Consequences、Success Metrics、Alternatives、Constitution 等维度;并做跨 PDR 一致性检查(冲突决策、缺失依赖、术语漂移、优先级冲突)与缺口分级(CRITICAL/HIGH/MEDIUM/LOW)。交互澄清一次只提一个问题,按严重度优先,每会话最多 5 个。最后更新文件、重生成 pdr.md 索引并执行审批(全部接受/逐项审查/暂缓)。

限制与规则:非破坏性修改,未经用户明确同意不得删除 PDR;章程违规始终标记,PDR 不得无正当理由覆盖 MUST 原则;跳过审批会导致实现阶段静默丢弃决策。配置项含 PDR_DRAFTS_DIR、PDR_INDEX、CONSTITUTION。具体价格、平台支持范围等信息暂未提供。