SuperAPI AI 工具集

frame-a-proposal

设计与创作

查看项目

更新于 10-15 22:38

技能介绍

用途:把一个问题转化为可供评审的 RFC 式设计提案,写入 proposals/ 目录。提案是设计论证,不是决策也不是实施计划,目的是迫使评审者在选项中做出选择。文件名格式为 0001-feature-name.md(四位补零序号加 kebab 标题);状态流转为 draft → fcp → accepted/rejected,接受后转为 decisions/ 中的记录,属人类行为。

主要能力与执行顺序:扫描 proposals/ 与 decisions/ 中的既有内容;界定问题(受益者、可观察变化、被迫做出的决策),此为停止门,确认前不得起草 Design;分配序号并从模板创建文件;撰写 Motivation(问题、证据、受害者、不作为成本、明确的非目标)、Design(机制与关键取舍)、Alternatives(至少两个真实选项及不选原因)、Drawbacks(诚实成本)、Unresolved questions(每条注明解决证据与决策者);最后链接与校验。

使用方式:读取使用 exec/search,写入使用 write/edit,模板创建用 write({ document: { path: "proposals/0007-async-export-pipeline.md", template: "proposal" } }),校验用 audit({ path: "proposals/0007-async-export-pipeline.md" })。链接为普通相对 markdown。

限制:不得自行推进状态或记录决策;不写实施规格;不得用稻草人填充备选方案或留空 Drawbacks;跳过 Step 1 界定门即视为失败。无交互运行时可陈述界定并继续,但需将三项字段原样写入 Motivation。收费、价格、平台支持等事实资料未提供。