openspec-propose

Automates creation of proposal, design, and tasks artifacts for a feature request.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/studyzy/dev-agent-protocol --skill openspec-propose-studyzy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/studyzy/dev-agent-protocol/tree/main/.claude/skills/openspec-propose
Command: npx skills add https://github.com/studyzy/dev-agent-protocol --skill openspec-propose-studyzy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

提案新变更 - 一步创建变更并生成所有产出物,帮助团队快速描述需求并获得完整的设计、规格说明和任务提案,以便准备实现。

这项技能在用户需要快速将一个变更点转化为可执行计划时尤为有用。它将自动生成以下产出物:

  • proposal.md(什么和为什么)
  • design.md(如何)
  • tasks.md(实现步骤)

准备好实现后,运行 /opsx:apply 来执行变更提案。

提示:输入应包含变更名称的描述或 kebab-case 名称以便创建变更。

Core Features & Use Cases

  • 脚手架式变更创建:一步生成包含产出物的变更结构。
  • 自动产出物生成:基于指令模板自动创建 proposal.md、design.md、tasks.md。
  • 适用于需要快速可执行计划的场景:新功能提案、需求变更、技术债务修复等。

Quick Start

Describe your desired change, then run the openspec-cn workflow to generate the proposal, design, and tasks artifacts.

Frequently Asked Questions about openspec-propose

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a complete change proposal with design and task definitions in one step?

Generating a complete change proposal requires inputting a feature description or kebab-case name. The workflow then automatically scaffolds proposal.md, design.md, and tasks.md artifacts for the feature request.

What artifacts are automatically created when proposing a new change?

Artifacts automatically created when proposing a new change include proposal.md for the what and why, design.md for the how, and tasks.md for the implementation steps. These files form the complete dependency-driven proposal structure.

How do I scaffold specification documents for a new feature request?

Scaffolding specification documents for a new feature request involves running the openspec-cn workflow with a change description. It creates a structured proposal complete with design specifications and task definitions.

Can I use this workflow for technical debt fixes and requirement changes?

Yes, this workflow supports technical debt fixes and requirement changes. It applies to any scenario requiring a fast, repeatable proposal workflow to transform change points into executable implementation plans.

What do I need to input to create a valid change proposal structure?

Creating a valid change proposal structure requires inputting a description of the desired change or its kebab-case name. This input satisfies frontmatter metadata requirements and triggers artifact scaffolding.

How do I apply a generated change proposal to start implementation?

Applying a generated change proposal to start implementation requires running the /opsx:apply command. This executes the prepared proposal, design, and tasks artifacts generated by the workflow.