SuperAPI AI 工具集

superior-logic

编程与开发

查看项目

更新于 10-23 16:16

技能介绍

用途 Superior Logic 用于实现或审查应用行为、API、状态转换、数据流和业务规则,核心目标是从输入到可观察结果全程保持正确性可见。它强调把方案适配到仓库既有架构,并在共享契约发生变化时,同步更新契约的所有受影响方。

当主要产出是对 diff、commit、分支、pull request 或工作区给出审查发现时,应改用 superior-code-review;本技能更适合聚焦某一领域的逻辑审查,或实现已确认的行为变更。

主要能力

  1. 行为建模:在选择代码前,先识别可信与不可信输入、输出与可观察副作用、不变式与授权规则、消费方与兼容性约束,以及预期的失败、重试、重复、顺序与并发条件。仅在代码和文档无法确立时才陈述实质性假设;若不同答案会改变产品契约,应向用户确认。
  2. 职责划分:在架构支持该边界时,将领域决策与渲染、传输、持久化分离;在数据进入可信系统的边界处校验,客户端校验只改善体验、不保证服务端正确性;状态转换保持单一权威所有者,派生状态而非同步副本;使用仓库中作为事实来源的共享 schema 和类型;共享契约变更时同步修改生产者、消费者、校验、测试与文档。
  3. 状态与副作用保护:当部分完成违反不变式时使相关写入原子化,否则定义可恢复的部分状态或补偿;对可能重复创建、重复扣费或损坏数据的重试与重复投递操作实现幂等;在可能竞争处定义顺序与并发行为,任意延迟不等于同步;按项目既有模式为远程工作设置超时、取消与有界重试,仅重试瞬时条件;在安全前提下,预期失败后保留用户输入与有用恢复选项。
  4. 可信边界安全:认证识别调用方,授权仍须约束每个资源与操作;尽可能将读写限定在授权主体内;将路由参数、请求头、隐藏字段、文件名、客户端状态、webhook 与外部载荷视为不可信;使用维护良好的库处理凭据与加密,不自行设计令牌、加密、签名或密钥存储方案;日志与用户可见错误中不出现密钥、敏感个人数据和支付细节。
  5. 失败可观察:在能恢复、转换或补充上下文的层级处理错误;包装错误时保留原始原因;不得将未知失败转为成功或仅为流程继续而吞掉错误;向用户提供安全可操作的提示,诊断细节走项目既定可观测性路径;对有界数据依赖循环、队列、结果集、递归、重试与内存累积加以限制。
  6. 契约验证:测试可观察行为而非私有步骤,覆盖正常路径及边界、无效输入、授权、部分失败、重复、重试或并发等受影响情形;条件允许时用聚焦的失败测试复现缺陷;沿用既有测试约定,运行最窄范围的 lint、类型、测试与构建检查,并明确报告未验证条件与兼容性风险。
  7. 最终报告:说明最终契约、受影响的生产者与消费者、失败行为、兼容性或上线假设及实际执行的检查;除非实现与底层系统能证明,否则不得把工作流描述为原子或恰好一次。

使用方式与技能边界 修改共享 API、事件、文件格式、客户端/服务端契约、状态机或可能跨版本、重试、部分部署的多步工作流时,应阅读 contracts 演进与工作流相关参考文档。当 schema 设计、查询形态、索引、事务隔离、迁移、回填或数据存储上线安全成为请求主要部分时,加载 superior-database;性能、可靠性、交付、API 安全、调试、测试设计、UX 等成为重点时,分别交由对应技能处理,本技能保留常规实现验证与领域契约职责。

适用场景 适合实现已确认的行为变更、审查领域逻辑、设计 API 与状态转换、处理数据流与业务规则、落实失败处理与幂等、审查跨版本共享契约变更。

限制 资料未提供具体安装命令、版本、收费、平台支持或效果指标,暂未提供。