SuperAPI AI 工具集

system-design

设计与创作

查看项目

更新于 10-16 03:41

技能介绍

用途:在生产系统设计或演进时,用不变量、工作负载数字、失败模式与运维约束来支撑架构决策,而非凭直觉。仓库模式针对当前代码库,绿地模式用于尚无实现的场景,两种模式流程一致。\n\n主要能力:先度量需求规模,若低于防过度设计门槛或已有决策定案,则直接以段落回答、不产出产物。若流程启动,先给出最简可生产方案,仅在满足包络与不变量且在某承重轴上不同时才增加备选,最多三个;被需求、门槛或具名失败排除的选项记一行并说明原因。随后定位并恢复既有设计、确立当前真相、闭合需求前沿、运行并挑战容量包络、确定数据与一致性模型、绘制候选方案、评分并深挖关键决策、审计架构债务,最后写出并渲染设计产物。每一步都要求推荐能引用包络数字、正确性不变量、具名失败模式或 HEURISTICS.md 原则。\n\n使用方式:按流程步骤执行,读取 docs/design/*/design.json 等既有设计,仓库模式需对顶层目录分类、读取架构文档与热路径。容量计算需给出推导并用 shell 命令验算。绘制候选前先写 dataModel,并为结构化存储给出直观数据库模式卡片。渲染命令:python3 <skill-dir>/scripts/render_report.py --design docs/design/<slug>/design.json --out "$TMPDIR/system-design-<slug>.html"。无界面时可加 --no-open。脚本会自行打开报告,需确认渲染结果标题正确,并可借助浏览器读取 data-component-overlaps 等诊断项须全为 0。\n\n限制:默认不加载示例与各 archetype 包,仅在首稿仍泛化或需按受保护不变量选择时按需加载;不得为填充标签页而编造同级候选;评分不得进入证据链;债务审计仅限仓库模式,绿地模式跳过。无法确定的内容应记为假设或待测量,而非虚构数字。