openspec-new-change

Original：🇨🇳 Chinese

Translated

Launch a new OpenSpec change using an experimental artifact workflow. Use this when users want to create new features, fixes or modifications through a structured step-by-step approach.

2installs

Sourcestudyzy/imewlconverter

Added on2026-03-03

NPX Install

npx skill4agent add studyzy/imewlconverter openspec-new-change

SKILL.md Content (Chinese)

View Translation Comparison →

Launch a new change using an experimental artifact-driven approach.

Input: User requests should include the change name (kebab-case) or a description of what they want to build.

Steps

If no explicit input is provided, ask the user what they want to build

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

"What change do you want to work on? Please describe what you want to build or fix."
Derive a kebab-case name based on their description (e.g., "add user authentication" →
```
add-user-auth
```
).
Important Note: Do not proceed without understanding what the user wants to build.
Determine workflow Schema
Unless the user explicitly requests a different workflow, use the default Schema (omit
```
--schema
```
).
Use a different schema only if the user mentions:
- A specific schema name → use
```
--schema <name>
```
- "show workflows" or "what workflows" → run
```
openspec schemas --json
```
  and let them choose
Otherwise: Omit
```
--schema
```
to use the default value.
Create change directory
bash
```
openspec-cn new change "<name>"
```
Add
```
--schema <name>
```
only if the user requests a specific workflow. This will create a scaffolded change under
```
openspec/changes/<name>/
```
using the selected Schema.
Display artifact status
bash
```
openspec-cn status --change "<name>"
```
This will show which artifacts need to be created and which are ready (dependencies are met).
Get instructions for the first artifact The first artifact depends on the schema (e.g.,
```
proposal
```
for spec-driven). Check the status output to find the first artifact with status "ready".
bash
```
openspec-cn instructions <first-artifact-id> --change "<name>"
```
This will output the templates and context required to create the first artifact.
Stop and wait for user instructions

Output

After completing the above steps, provide a summary:

Change name and location
Schema/workflow being used and its artifact order
Current status (0/N artifacts completed)
Template for the first artifact
Prompt: "Ready to create the first artifact? Please describe the content of this change, and I will draft it for you, or ask me to proceed."

Guardrails

Do not create any artifacts immediately — only display instructions
Do not skip the step of displaying the first artifact template
If the name is invalid (not kebab-case), request a valid name
If a change with the same name already exists, suggest continuing with that change
If using a non-default workflow, pass the --schema parameter

openspec-new-change

NPX Install

Tags

SKILL.md Content (Chinese)