SuperAPI AI 工具集

plan

设计与创作

查看项目

更新于 10-15 23:45

技能介绍

用途:在功能启动初期,把功能请求与需求文件转成高层设计(HLD),让人类在进入 API 与编码设计前先确认方向。这是设计产物,不是代码。

主要能力:读取 requirement_dir 中每个文件、相关 ADR、CLAUDE.md 与既有设计,识别用户、待办任务与硬约束;显式列出假设,对真正模糊的业务规则、SLA 或数据归属问题向人提问;生成 2–3 个真正不同的方案并做预演失败分析;按工作量、风险、NFR 与可逆性评分并推荐一个;勾勒组件、数据流与跨仓库边界;覆盖安全隐私、规模、可用性/SLO、延迟、成本、合规、数据生命周期、向后兼容与迁移、依赖与排序、发布与回滚、风险与缓解、开放问题等标准章节。

使用方式:输入 feature(一行描述)、feature_slug(kebab-case)、requirement_dir(需求文件夹)。产物路径由技能依据 skills.config.yaml → artifacts.hld 自行解析,即 .maestro/<slug>/hld.md,调用方不传路径。输出 hld.md 与 open-questions.json,后者需用 python3 workflows/validate_open_questions.py .maestro/<slug>/open-questions.json 校验;返回 hld_path 与 hld_summary。交互式(Claude Code 中 /plan)且存在开放问题时,用 AskUserQuestion 循环解决,答案写回 JSON 并折入 HLD 正文,再重新推导开放问题,直到无开放问题(deferred 可保留)。无 AskUserQuestion 时只写产物即停。

适用场景:功能最早期、已有需求/意图时;绿地或棕地、多租户与受监管数据、需回填的大数据集、第三方依赖风险、高并发或尖峰负载、需要可逆发布等情形。

限制:不要在此设计 API、schema 或代码,那属于审批后的设计阶段(各栈 LLD + /api-contract)。外部头脑风暴技能由 skills.config.yaml → plan.external.brainstorm 配置(默认 brainstorming,来自 Superpowers 包,或 none),但覆盖范围仍由本技能负责。完成标准:所有章节齐备、至少 2 个带取舍的方案、NFR 与风险具体(非 TBD)、列出开放问题。其他收费、价格、平台与效果信息暂未提供。