OpenSpec 变更提案工具：一步生成提案、设计与任务文档

openspec-propose by ai-feier/skills

1 周安装量

GitHub

安装命令

npx skills add https://github.com/ai-feier/skills --skill openspec-propose

开发项目管理自动化

🇨🇳中文介绍

提出新变更 - 一步创建变更并生成所有工件。

我将创建一个包含工件的变更：

proposal.md（内容与原因）
design.md（实现方式）
tasks.md（实施步骤）

准备实施时，运行 /opsx-apply

输入：用户的请求应包含一个变更名称（kebab-case）或对其想要构建内容的描述。

步骤

如果未提供明确输入，询问他们想要构建什么

使用 AskUserQuestion 工具（开放式，无预设选项）询问：

"您想要处理什么变更？描述您想要构建或修复的内容。"

根据他们的描述，推导出 kebab-case 名称（例如，"add user authentication" → add-user-auth）。

重要提示：在未理解用户想要构建什么之前，不要继续。

创建变更目录
```
openspec new change "<name>"
```

这将在 openspec/changes/<name>/ 处创建一个带有 .openspec.yaml 的脚手架变更。

🇺🇸English

Propose a new change - create the change and generate all artifacts in one step.

I'll create a change with artifacts:

proposal.md (what & why)
design.md (how)
tasks.md (implementation steps)

When ready to implement, run /opsx-apply

Input : The user's request should include a change name (kebab-case) OR a description of what they want to build.

Steps

If no clear input provided, ask what they want to build

Use the AskUserQuestion tool (open-ended, no preset options) to ask:

"What change do you want to work on? Describe what you want to build or fix."

From their description, derive a kebab-case name (e.g., "add user authentication" → add-user-auth).

IMPORTANT : Do NOT proceed without understanding what the user wants to build.

Create the change directory
```
openspec new change "<name>"
```

This creates a scaffolded change at openspec/changes/<name>/ with .

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

827,200 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

273,700 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

221,200 周安装

获取工件构建顺序

openspec status --change "<name>" --json

解析 JSON 以获取：

 * `applyRequires`：实施前所需的工件 ID 数组（例如 `["tasks"]`）
 * `artifacts`：所有工件的列表及其状态和依赖关系

4. 按顺序创建工件，直到达到可实施状态

使用 TodoWrite 工具 来跟踪工件的处理进度。

按依赖顺序循环处理工件（先处理没有待处理依赖项的工件）：

a. 对于每个状态为 ready（依赖项已满足）的工件：

 * 获取指令： 
       
       openspec instructions <artifact-id> --change "<name>" --json
       

 * 指令 JSON 包含： 
   * `context`：项目背景（给您的约束 - **不要**包含在输出中）
   * `rules`：特定工件的规则（给您的约束 - **不要**包含在输出中）
   * `template`：用于输出文件的结构
   * `instruction`：针对此工件类型的模式特定指导
   * `outputPath`：写入工件的位置
   * `dependencies`：为获取上下文而需读取的已完成工件
 * 读取任何已完成的依赖文件以获取上下文
 * 使用 `template` 作为结构创建工件文件
 * 应用 `context` 和 `rules` 作为约束 - 但**不要**将它们复制到文件中
 * 显示简要进度："已创建 "

b. 继续直到所有 applyRequires 中的工件都完成

 * 创建每个工件后，重新运行 `openspec status --change "<name>" --json`
 * 检查 `artifacts` 数组中，`applyRequires` 里的每个工件 ID 是否都处于 `status: "done"`
 * 当所有 `applyRequires` 工件都完成时停止

c. 如果某个工件需要用户输入（上下文不明确）：

 * 使用 **AskUserQuestion 工具** 来澄清
 * 然后继续创建

5. 显示最终状态

     openspec status --change "<name>"

完成所有工件后，总结：

变更名称和位置
创建的工件列表及其简要描述
准备情况："所有工件已创建！准备实施。"
提示："运行 /opsx-apply 或要求我实施以开始处理任务。"

工件创建指南

遵循 openspec instructions 中每个工件类型的 instruction 字段
模式定义了每个工件应包含的内容 - 请遵循它
在创建新工件之前，先读取依赖工件以获取上下文
使用 template 作为输出文件的结构 - 填写其各个部分
重要提示：context 和 rules 是给您的约束，不是文件的内容
- 不要将 <context>、<rules>、<project_context> 块复制到工件中
- 这些指导您编写的内容，但绝不应出现在输出中

创建实施所需的所有工件（根据模式的 apply.requires 定义）
在创建新工件之前，始终先读取依赖工件
如果上下文极其不明确，询问用户 - 但更倾向于做出合理的决定以保持进度
如果已存在同名变更，询问用户是希望继续处理它还是创建新的
在继续下一个之前，验证每个工件文件在写入后是否存在

Get the artifact build order

openspec status --change "<name>" --json

Parse the JSON to get:

 * `applyRequires`: array of artifact IDs needed before implementation (e.g., `["tasks"]`)
 * `artifacts`: list of all artifacts with their status and dependencies

4. Create artifacts in sequence until apply-ready

Use the TodoWrite tool to track progress through the artifacts.

Loop through artifacts in dependency order (artifacts with no pending dependencies first):

a. For each artifact that isready (dependencies satisfied):

 * Get instructions: 
       
       openspec instructions <artifact-id> --change "<name>" --json
       

 * The instructions JSON includes: 
   * `context`: Project background (constraints for you - do NOT include in output)
   * `rules`: Artifact-specific rules (constraints for you - do NOT include in output)
   * `template`: The structure to use for your output file
   * `instruction`: Schema-specific guidance for this artifact type
   * `outputPath`: Where to write the artifact
   * `dependencies`: Completed artifacts to read for context
 * Read any completed dependency files for context
 * Create the artifact file using `template` as the structure
 * Apply `context` and `rules` as constraints - but do NOT copy them into the file
 * Show brief progress: "Created "

b. Continue until allapplyRequires artifacts are complete

 * After creating each artifact, re-run `openspec status --change "<name>" --json`
 * Check if every artifact ID in `applyRequires` has `status: "done"` in the artifacts array
 * Stop when all `applyRequires` artifacts are done

c. If an artifact requires user input (unclear context):

 * Use **AskUserQuestion tool** to clarify
 * Then continue with creation

5. Show final status

     openspec status --change "<name>"

After completing all artifacts, summarize:

Change name and location
List of artifacts created with brief descriptions
What's ready: "All artifacts created! Ready for implementation."
Prompt: "Run /opsx-apply or ask me to implement to start working on the tasks."

Artifact Creation Guidelines

Follow the instruction field from openspec instructions for each artifact type
The schema defines what each artifact should contain - follow it
Read dependency artifacts for context before creating new ones
Use template as the structure for your output file - fill in its sections
IMPORTANT : context and rules are constraints for YOU, not content for the file
- Do NOT copy <context>, <rules>, <project_context> blocks into the artifact
- These guide what you write, but should never appear in the output

Create ALL artifacts needed for implementation (as defined by schema's apply.requires)
Always read dependency artifacts before creating a new one
If context is critically unclear, ask the user - but prefer making reasonable decisions to keep momentum
If a change with that name already exists, ask if user wants to continue it or create a new one
Verify each artifact file exists after writing before proceeding to next

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

150,000 周安装

OpenSpec 变更提案工具：一步生成提案、设计与任务文档

🇨🇳中文介绍

🇺🇸English

相关 Skills

最新 Skills