SuperAPI AI 工具集

architecture-decisions

编程与开发

查看项目

更新于 10-15 23:43

技能介绍

用途:让智能体按严格四阶段生命周期推进架构决策,避免基于对外部依赖的过时假设做决定。

主要能力:

  1. 四阶段生命周期。RESEARCH:先识别决策涉及的外部依赖,阅读其源码与文档,产出书面发现摘要;若依赖本身已决定该问题,则记为约束而非决策。DRAFT:先产出编号的研究批判(未验证假设、未调查依赖、未回答问题、可能冲突的约束),逐项解决后才写 ADR;首次 ADR 需创建 docs/decisions/ 及 CLAUDE.md、AGENTS.md 两个守卫文件,再按模板写 docs/decisions/YYYYMMDD-<slug>.md,提交到 adr/<slug> 分支并开 PR,作者不合并;随后产出草稿批判。HOLD:等待明确合并授权,评审做规格与现实的差距检查,任何人可设阻塞性 hold,沉默不等于同意。MERGE:所有 hold 解除、CI 通过、无冲突标记、获得明确批准后合并,并更新 docs/ARCHITECTURE.md 的 Key Decisions 表。
  2. 阶段门禁:缺 RESEARCH 发现、批判未解决、hold 未清除时分别以警告或协议违规中止。
  3. 维护 docs/ARCHITECTURE.md(Overview、Key Decisions、Components、Patterns、Constraints)。
  4. 系统性促成决策:清点决策点、逐项独立走完整生命周期,不批量处理。
  5. 协调者委派时,spawn prompt 不得豁免生命周期;无法研究时应作为阻塞项上报。

使用方式:作为技能安装使用,可与 design-system、event-modeling、domain-modeling、code-review 集成;缺少依赖时可用 npx skills add jwilger/agent-skills --skill event-modeling 安装。

限制:无外部指令可豁免 RESEARCH;沉默不算确认;无 GitHub PR 时仍需在分支提交 ADR 文件。具体收费、平台支持等暂未提供。