SuperAPI AI 工具集

openspec-proposal-creation-cn

设计与创作

查看项目

更新于 10-15 21:46

技能介绍

用途:按规范驱动开发方法为变更生成结构化提案,触发于规划功能、创建提案、编写规范或引入新能力。

主要能力:产出三类文件——proposal.md(Why/What/Impact,即动机、变更内容与影响摘要)、tasks.json(编号实施清单)、spec-delta.md(以ADDED/MODIFIED/REMOVED表述的正式需求变更)。

使用方式:按八步工作流执行——审阅现有规范、生成唯一变更ID(如add-user-authentication、fix-payment-validation)、生成目录结构、起草proposal.md、创建tasks.json、以EARS格式编写规范差异、验证结构、提交用户评审。审阅现有规范用命令:find spec/specs -name "spec.md" -type f;find spec/changes -maxdepth 1 -type d -not -path "*/archive";grep -r "### Requirement:" spec/specs/。校验ID冲突用:ls spec/changes/ | grep -i "<proposed-id>"。建目录用:mkdir -p spec/changes/{change-id}/specs/{capability-name}。验证结构用grep检查差异操作数、#### Scenario:与### Requirement:格式。需求用EARS语法(WHEN…SHALL…、GIVEN…WHEN…THEN…AND),场景须含正向与错误处理。

适用场景:新功能提案、破坏性变更、弃用提案,覆盖API、认证、支付、限流等。

限制:需已有spec目录结构与OpenSpec约定;每个提案只处理一个关注点;任务通常5-15项;验证步骤不可跳过;参考文件EARS_FORMAT.md、VALIDATION_PATTERNS.md、EXAMPLES.md需按需加载。具体收费、平台与效果暂未提供。