SuperAPI AI 工具集

architecture

编程与开发

查看项目

更新于 11-06 09:11

技能介绍

用途 该技能面向架构相关工作,提供四种可选契约:方案架构设计、变更合规审查、可扩展性评分、整项目健康审计。它要求先检测 --mode 参数,再完整读取所选模式的参考文档并执行其阶段、证据门禁、标志与输出。

主要能力

  • --mode=design [brief]:覆盖后端、前端、数据、集成与部署的方案架构;每个关注点至少三个调研选项、ADR、脚手架/测试夹具交接,以及第 12 步用户验证访谈。
  • --mode=review [scope] [--report-only]:变更合规检查,13 个串行类别,输出 PASS/WARN/BLOCKED 报告,含第 5 阶段验证与有界复审轮次。--report-only 返回只读叶子报告给负责修复的调用方。
  • --mode=scalability [init|audit] [scope]:对项目或规划架构评分,十领域 /20 评分卡、G1-G7、非评分 TVC 与建议矩阵。init/audit 是 scalability 的运行类型,与 --mode=scalability 不同。
  • --mode=full [scope] [--defer=validate]:整项目架构、可扩展性与生产就绪审计;INLINE 编排器、三个并行只读面、去重并输出一份整合报告/结论。--defer=validate 将发现验证留给调用方下一次报告级 $why-review 门禁。

使用方式 先检测 --mode;无模式时显示模式表并停止,不提问、不运行、不推断默认。选定模式后完整读取对应参考文档(design 读 references/mode-design.md,review 读 references/mode-review.md,scalability 读 references/mode-scalability.md,full 读 references/mode-full.md;评分时另读 references/scorecard.md)。随后分诊目标、规划审查任务、执行模式阶段、验证并交接。只有 full 会组合模式:其子面读取并运行 scalability 与 review 参考,外加独立的 production-readiness-review 技能,不得复制或重新实现任何面。

审查模式默认行为 独立审查默认 --review-only(--report-only 为别名);--fix-loop 启用 审查 → 验证 → 授权修复 → 全新复审,默认上限 3 轮。--fix-loop --loop-owner=caller 返回只读通过结果给拥有修复/复审的调用方。需先创建分诊、审查、验证与复审待办任务,并应用携带的 review-policy 契约处理 LOW 延迟与用户批准的有界扩展。

适用场景 需要架构方案设计、变更合规审查、可扩展性评分或整项目健康报告,并希望决策有证据支撑时使用。

限制 无显式模式时不做任何工作。必须完整读取所选参考文档,不得复用其他模式流程。轮次上限默认 3 轮,扩展需询问并等待。审查决策不接受开放风险,也不让失败门禁通过。Codex 兼容说明要求调用 $skill-name 加载已注册的 .agents/skills/<name>/SKILL.md 并用 Codex 工具执行,无需单独 Skill 工具或 Claude 模式切换;作者目录为 .claude/**,镜像自动生成。其他平台、收费与价格信息暂未提供。