SuperAPI AI 工具集

openspec-plus-proposal

通用与其它

查看项目

更新于 10-16 08:36

技能介绍

该技能用于 OpenSpec 提案阶段的交互式发现与撰写,输出居留在意图层面的轻量提案。

用途:当 OpenSpec 提案阶段开始(如 /opsx-new、/opsx-continue 运行)时激活,通过五个视角的问答帮助明确问题、目标、范围、非目标与影响,避免过早滑入设计、规范或实现。

主要能力与流程分四个阶段且不可跳过、合并或重排:-1 自动更新检查(每会话一次)、0 模式与模板解析、1 交互式发现、2 撰写与产物合规审查。流程阶段需通过 task 工具展示并随完成更新。

使用方式:阶段 0 先运行 openspec instructions proposal --change <name> --json 提取 template、instruction、rules;读取 openspec/.plus/config.yaml 中 settings.questionMode(默认 sequential,可选 batch)。阶段 1 按项目说明文件(AGENTS.md、CLAUDE.md、GEMINI.md 等)与既有提案统一术语,用提问工具逐个视角询问(batch 模式合并提问),并给出推荐答案与理由;若请求包含多个独立子系统须先拆解,每个子变更各自走提案→规格→设计→任务循环。阶段 2 严格按模板结构撰写,确保阶段 1 答案完整映射,然后派发一次子代理(如 Claude Code 用 general-purpose)做合规审查,发现的问题在根上下文内联修复,不重复派发。

限制:绝不读取源代码;绝不提出架构、组件、API、模式、合约或工作流;绝不推荐技术栈;绝不创建任务、里程碑或执行计划;非目标至少需明确一项;提案不得包含多个独立子系统,否则先拆解。若网络或文件出错则静默继续,不阻塞流程。