用途:这是一个面向 OpenSpec 的规划类技能,帮助用户把想构建或修复的内容快速描述出来,一次性生成完整的变更提案与规划产物。它只负责规划,不做实现。
主要能力:使用默认 spec-driven 模式时,会创建 change 目录并生成 proposal.md(做什么与为什么)、specs/<capability-path>/spec.md(系统必须做什么,是增量而非主 spec)、design.md(怎么做)和 tasks.md(实现步骤)。<capability-path> 是相对 specs/ 的目录路径,例如 user-auth 或 identity/user-auth。
使用方式:从用户描述中推导 kebab-case 变更名(如“add user authentication”对应 add-user-auth)。若请求存在会影响范围、外部可观察行为、兼容性或验收标准的歧义,先向用户确认;细节可合理假设并记录在产物中。默认使用配置的默认 schema,用户明确指定时才用 --schema <schema-name>。创建用 openspec new change "<name>";查询构建顺序用 openspec status --change "<name>" --json,解析 applyRequires、artifacts 及其依赖边;按依赖顺序用 openspec instructions <artifact-id> --change "<name>" --json 获取 template、instruction、resolvedOutputPath 等并生成产物,每生成一个后重新检查状态。若用户指定 store,先用 openspec store list --json 获取 id,并在读取/写入 specs 与 changes 的相关命令后加 --store <id>(对后续命令保持粘性)。
适用场景:需要为 OpenSpec 项目快速产出结构化规划文档、明确变更范围与实现步骤时。
限制:该工作流仅授权规划,不编辑项目代码、不开始实现,展示产物后应停止并等待新请求再启动 apply 工作流;必须只按依赖边而非状态判断所需产物集合;每条指令的说明字段是权威指引;context 与 rules 只作为约束,不得写入产物文件。资料未提供具体支持的平台、费用信息。