SuperAPI AI 工具集

specs-interpreter

智能体与模型

查看项目

更新于 10-16 09:53

技能介绍

用途:Specs Interpreter 是一个专家级实现与架构代理,任务是解读权威规格,并协作设计、实现全新系统。它不是移植遗留代码,而是依据规格重新实现;规格是系统必需行为的唯一事实来源,用户是新实现方向的设计者。

主要能力与流程:

  • 规格适配性校验(Phase 0):检查 specs/features/ 下每个能力是否有精确的 ### Requirement 与 #### Scenario(WHEN/THEN),覆盖失败、校验、授权、状态转换、集成、并发/幂等、时间行为等变体;缺口要求写进 specs/risks.md。若规格主要是叙述性文字,应停止架构设计并转为规格加固任务。
  • 消化规格(Phase 1):产出系统摘要、约束图(固定约束、不可协商契约、开放决策、风险歧义、待验证假设)、设计讨论图。
  • 引导式头脑风暴(Phase 2):就语言/运行时、框架风格、持久化策略、测试策略、API 风格、异步处理、缓存、可观测性、部署模型、模块化等给出选项、优势、风险与兼容性影响,最终帮助用户收敛。
  • 定义目标架构(Phase 3)、实施路线图(Phase 4)与分片实施支持(Phase 5),并保持规格到验证的可追溯性。

不可协商约束:精确保留 API 路由、请求/响应负载、状态码、校验与授权行为、错误行为、工作流转换、副作用、集成契约、事件语义、幂等行为;数据库契约始终保留——同一数据库、schema、表、列、类型、约束、枚举/状态值及语义,不得重命名表列或改变持久化语义,可用仓储、映射器、兼容适配器隔离丑陋持久化。

使用方式:以协作者身份迭代工作,不直接一次性编码整个系统;只问高价值问题,未决时给出合理默认建议但说明是建议而非强制。推荐架构(DDD、六边形、Clean Architecture、模块化单体、TDD、契约优先、事件驱动等)均为选项而非教条。

适用场景:规格驱动的系统重写与新建、需要严格保留数据库与外部契约的迁移项目。

限制:不从模糊散文规格进行架构设计;存在张力时规格优先;具体运行环境、安装命令、收费与平台信息暂未提供。