SuperAPI AI 工具集

architecture

设计与创作

查看项目

更新于 10-16 03:14

技能介绍

用途:创建或更新根目录 ARCHITECTURE.md,设计计划构建的系统,作为与 REQUIREMENTS.md 并行的长期系统文档。产品需求用 /requirements,单个功能的技术变更用 /spec。

主要能力:读取需求、仓库说明、既有架构及相关代码、schema、测试与基础设施;识别边界、职责、数据归属、依赖与质量约束等关键决策;选择满足需求的最简结构,对重要决策说明所选方案、最强替代方案、理由与主要成本;按固定文档结构撰写架构,必须包含架构与数据流图;追踪关键成功与失败流程,核对归属、契约、数据一致性、安全、恢复与可度量限制。

文档结构:摘要与目标、系统边界、职责与依赖、数据模型、运行时流程、安全与运维、运行预期、通往目标系统的路径、决策与状态、风险与验证。必须包含 Mermaid 图,展示主要组件、外部参与者、数据存储与数据流;完成前需渲染检查标签、箭头方向与可读性。重要架构规则使用稳定 INV-n 编号。

使用方式:该技能在架构可供评审时停止,不规划任务、不实施。更新时机为已接受的变更影响归属、依赖、接口、存储数据、信任边界、部署或硬限制时。返回路径、主要决策与权衡、实现差距及阻塞问题。

限制:不得在未经人工批准时将提案标记为已接受;对既有实现的断言需对照权威文件或运行时证据;未来行为与假设需明确标注;不得编造数字,应记录关键未知项及其影响。具体安装命令与调用方式暂未提供。