SuperAPI AI 工具集

clarify

编程与开发

查看项目

更新于 11-05 16:17

技能介绍

clarify 是一个面向架构决策的审议引擎,用于在正式进入实现规划之前,澄清拟议功能或重构方案中的架构歧义、边界情况与系统权衡。

用途 该工具聚焦高影响的架构决策、失败模式与系统不变量,禁止纠缠语法细节或微优化。当需求与既有规范或架构决策记录(ADR)冲突时,它会立即中止并指出矛盾点,先解决分歧。

主要能力

  1. 五维评估:数据契约与模式(边界、序列化、实体模型、迁移兼容性)、状态与生命周期(事实来源、变更路径、并发、持久化)、失败模式与韧性(错误边界、部分失败、回退策略、恢复)、系统边界(服务职责、依赖爆炸半径、外部集成)、非功能性护栏(延迟、吞吐上限、可扩展性约束、安全)。
  2. 提问与遍历策略:正交问题可在一轮内批量提出(最多 5 个)以减少往返;因果分支决策严格每轮只问一个。每个问题附带权威技术建议与理由,支持“接受全部建议”或“除某题外全部批准”的快速通道。先解决影响最大的分支点,用户答复后立即剪除过时的依赖问题。
  3. 标准问题格式:每题包含维度标题、一句话技术张力或边界风险、若干带权衡的选项,以及一条推荐意见。
  4. 自主收敛:持续追问直至高影响张力收敛或用户要求结束,不设任意问题上限;对无跨模块影响的选择直接采用惯例,不提问。
  5. 决策档案输出:将已定决策整理为《架构决策档案》,包含范围与核心约束、已定决策(瓶颈、理由与权衡、强制不变量)、影响半径(未决问题及其影响、受影响子系统、被禁反模式)。

使用方式 先检查提案与权威契约;若存在架构歧义,进入审议访谈,按标准问题格式提出问题并暂停等待答复,可批量快速批准;答复后剪枝并评估剩余歧义,循环直至收敛;最后合成决策档案并立即结束回合。若不存在任何架构歧义,则直接跳至档案合成阶段。

适用场景 适用于功能开发或重构前的架构评审、跨服务边界与数据契约的决策、失败模式与恢复策略的确定,以及需要形成可追溯决策记录与强制不变量约束的团队协作。

路由衔接 已定决策可为文件影响规划提供方向(经 /changeset);需要实证验证候选方案时转 /spike;仍有需架构方向裁决的选择时转 /architect-decision。

限制 资料未提供具体实现语言、运行环境、安装命令、收费方式与平台支持信息;其中 /ssot、/changeset、/spike、/architect-decision 等路由属流程性引用,其具体细节暂未提供。