SuperAPI AI 工具集

gather-requirements

通用与其它

查看项目

更新于 10-16 05:51

技能介绍

用途:把利益相关者提出的模糊数据需求,通过结构化访谈,转写为一到多个可执行的决策级问题(DGQ)Markdown 文件,存放在 docs/requirements/ 下。核心是“行动改变开关”——若答案与预期相反,是否会改变构建、发布或决策的内容;若答案是“什么都不会变”,则触发杀死开关,停止追问并写出 status: rejected / action_change: nothing 的 DGQ。

主要能力:逐题访谈并给出推荐答案(行动改变一题除外,不得代为推荐);可先探索代码库而非提问;结合 CONTEXT.md 术语表、相邻 DGQ 与 docs/adr/ 核查;每个决策写一个文件,命名 <stakeholder>-<slug>.md;多决策需求先完整深挖一个,其余以 status: draft 存根;写入后从消费项目根运行 scripts/lint-dgq.sh(可用 DGQ_ROOT=<dir> 指定;脚本缺失则静默跳过)。若属跨团队平台承诺,改走 /write-adr 并记入 related_adrs。

使用方式:以 /gather-requirements 启动。开始前扫描 docs/requirements/,若已有 DGQ 则提供继续草稿、新建或列出一行摘要三种选择;accepted/rejected 视为不可变;首次写入时才创建目录。结束时输出一行确认(Wrote … / status / action_change),needs-follow-up 时指名要问利益相关者的具体问题。

适用场景:当业务方提出“想了解流失”等模糊诉求,需要先厘清决策、行动改变、信号与规格(来源、指标、维度、窗口、排除项)以及敏感性、节奏、治理、成本边界时。

限制:不代替用户提供行动改变;规格需向利益相关者确认时标 needs-follow-up,不得自行编造;该技能为访谈流程而非模板表单,相关字段与枚举以 references/dgq.md 为准。部分安装可能缺少 lint 脚本,此时跳过检查。