openspec-propose 是一个用于 OpenSpec 变更提案的 AI 技能,核心用途是帮助用户快速描述想构建的内容,并一次性生成完整的变更提案及其所需工件。
主要能力包括:根据用户描述推导 kebab-case 变更名称;创建带脚手架的变更目录;读取工件构建顺序与依赖关系;按依赖顺序逐个生成工件文件,包括 proposal.md(做什么与为什么)、design.md(怎么做)和 tasks.md(实施步骤);在上下文不清晰时向用户提问确认;完成后汇总变更信息并引导进入实施阶段。
使用方式:用户需提供变更名称或需求描述,否则技能会先询问要构建什么。技能通过 openspec new change 创建变更,通过 openspec status 获取状态与构建顺序,通过 openspec instructions 获取各工件的模板、规则与输出路径,按依赖顺序创建并写入工件文件,最终展示状态并提示运行 /opsx:apply。
适用场景:需要快速把想法转化为结构化变更提案的研发流程;需要同时产出提案、设计与任务清单的项目;希望在实施前明确范围与步骤的团队协作。
限制:资料未说明具体运行环境要求、收费方式、支持平台或与其他工具集成细节;技能依赖 OpenSpec 命令行工具及其 JSON 输出格式;若变更已存在需由用户决定继续或新建;上下文严重不清时需用户补充信息。输出内容应遵循模板与规则约束,不应把上下文和规则块复制进工件文件。