Agent Skills › bacoco/BMad-Skills › openspec-change-proposal

openspec-change-proposal

GitHub

用于快速创建轻量级（L0-1）变更提案，将小修复或简单功能需求转化为结构化文档，避免启动完整BMAD工作流。

.claude/skills/openspec-change-proposal/SKILL.md bacoco/BMad-Skills

Trigger Scenarios

用户请求修复bug 提出小型改进或快速功能需求涉及低风险、范围明确的代码调整

Install

npx skills add bacoco/BMad-Skills --skill openspec-change-proposal -g -y

More Options

Non-standard path

npx skills add https://github.com/bacoco/BMad-Skills/tree/main/.claude/skills/openspec-change-proposal -g -y

Use without installing

npx skills use bacoco/BMad-Skills@openspec-change-proposal

指定 Agent (Claude Code)

npx skills add bacoco/BMad-Skills --skill openspec-change-proposal -a claude-code -g -y

安装 repo 全部 skill

npx skills add bacoco/BMad-Skills --all -g -y

预览 repo 内 skill

npx skills add bacoco/BMad-Skills --list

SKILL.md

Frontmatter

{
    "name": "openspec-change-proposal",
    "metadata": {
        "outputs": [
            "proposal",
            "tasks",
            "spec-delta"
        ],
        "triggers": {
            "keywords": [
                "bug",
                "fix",
                "small",
                "quick",
                "simple",
                "minor",
                "lightweight"
            ],
            "patterns": [
                "fix bug",
                "small change",
                "quick feature",
                "simple fix",
                "minor update"
            ]
        },
        "auto-invoke": true,
        "capabilities": [
            "proposal-creation",
            "change-scoping",
            "task-definition",
            "lightweight-planning"
        ],
        "prerequisites": []
    },
    "description": "Creates lightweight proposals for L0-1 work.",
    "allowed-tools": [
        "Read",
        "Write",
        "Grep",
        "Bash"
    ]
}

OpenSpec Propose Skill

When to Invoke

Automatically activate when user:

Says "Fix this bug", "Small change", "Quick feature"
Asks "Simple fix for [issue]", "Minor update to [component]"
Mentions "bug fix", "small improvement", "quick change"
Has a Level 0-1 scoped change (small, low risk, no major unknowns)
Uses words like: bug, fix, small, quick, simple, minor, lightweight

Specific trigger phrases:

"Fix this bug: [description]"
"Small change to [component]"
"Quick feature: [simple feature]"
"Simple fix for [issue]"
"Minor update: [description]"
"Lightweight change proposal"

Prerequisites:

Change is Level 0-1 (small, well-defined)
No major unknowns or architectural changes
Existing codebase (not greenfield project)

Do NOT invoke when:

Complex feature requiring PRD (use BMAD instead)
Architectural changes needed (use bmad-architecture-design)
Multiple teams coordination (use BMAD)
Level 2+ complexity (escalate to BMAD)
Greenfield project (use BMAD workflow)

Auto-escalate to BMAD when:

Scope grows beyond Level 1
Major unknowns emerge
Requires cross-team coordination

Mission

Capture small change requests or bug fixes and translate them into concise proposals and task outlines without invoking the full BMAD workflow.

Inputs Required

change_request: description of the existing behavior and desired adjustment
impact_surface: files, services, or user flows likely affected
constraints: timeline, risk, or approvals that bound the solution

Outputs

proposal.md summarizing problem, desired behavior, and acceptance signals (template: assets/proposal-template.md.template)
tasks.md listing actionable steps sized for rapid implementation (template: assets/tasks-template.md.template)
specs/spec-delta.md capturing ADDED/MODIFIED/REMOVED requirements (template: assets/spec-delta-template.md.template)
Optional design.md scaffolded when deeper technical notes are required

scripts/scaffold_change.py creates this structure in openspec/changes/<change-id>/ using the templates above.

Process

Validate Level 0-1 scope using CHECKLIST.md.
Run scripts/scaffold_change.py <change-id> to create the workspace under openspec/changes/.
Clarify current vs. target behavior and record feasibility notes in proposal.md.
Draft tasks.md and populate specs/spec-delta.md using the templates in assets/.
Highlight dependencies, approvals, and risks, then hand off for review or implementation scheduling.

Quality Gates

Ensure checklist items pass before finalizing. Escalate to BMAD if scope exceeds Level 1 or introduces major unknowns.

Error Handling

If information is insufficient, ask for missing context (screenshots, logs, reproduction steps).
When risks are high or ambiguity remains, recommend migrating to BMAD discovery-analysis.