AgentSkillsCN

specswarm-modify

以影响分析为先的修改工作流,兼顾向后兼容性评估与重大变更的检测。当用户明确表示想要修改、变更、更新、调整、增强、扩展或改变现有功能行为时(而非修复缺陷、也非重构质量),此工作流将自动执行。适用于那些虽能正常工作,但需要以不同方式运作的功能。

SKILL.md
--- frontmatter
name: specswarm-modify
description: Impact-analysis-first modification workflow with backward compatibility assessment and breaking change detection. Auto-executes when user clearly wants to modify, change, update, adjust, enhance, extend, or alter existing feature behavior (not fixing bugs, not refactoring quality). For features that work but need to work differently.
allowed-tools: AskUserQuestion, SlashCommand
hooks:
  - event: PreToolUse
    tool: SlashCommand
    handler: ensure-impact-analysis
    description: Ensures impact analysis is completed before modification commands
  - event: PostToolUse
    tool: SlashCommand
    handler: track-modification-progress
    description: Tracks modification progress and breaking change detection

SpecSwarm Modify Workflow

Provides natural language access to /specswarm:modify command.

When to Invoke

Trigger this skill when the user mentions:

  • Modifying, changing, or updating existing feature behavior
  • Enhancing or extending working features
  • Altering how something works (that currently works)
  • Making features work differently than they do now

Examples:

  • "Change authentication from session to JWT"
  • "Add pagination to the user list API"
  • "Update search to use full-text search"
  • "Modify the dashboard to show real-time data"
  • "Extend the API to support filtering"

NOT for this skill:

  • Fixing bugs (use specswarm-fix)
  • Improving code quality without changing behavior (use specswarm-refactor)
  • Building new features (use specswarm-build)

Instructions

Confidence-Based Execution:

  1. Detect that user mentioned modifying/changing existing functionality

  2. Extract the modification description from their message

  3. Assess confidence and execute accordingly:

    High Confidence (95%+) - Auto-execute immediately:

    • Clear modification requests: "Change authentication from session to JWT", "Add pagination to user list API", "Update search algorithm to use full-text search"
    • Action: Immediately run /specswarm:modify "modification description"
    • Show brief notification: "🎯 Running /specswarm:modify... (press Ctrl+C within 3s to cancel)"

    Medium Confidence (70-94%) - Ask for confirmation:

    • Less specific: "Update the authentication", "Modify the search"
    • Action: Use AskUserQuestion tool with two options:
      • Option 1 (label: "Run /specswarm:modify"): Use SpecSwarm's impact-analysis workflow
      • Option 2 (label: "Process normally"): Handle as regular Claude Code request

    Low Confidence (<70%) - Always ask:

    • Vague: "Make the feature better", "Improve the UI"
    • Action: Use AskUserQuestion as above
  4. If user cancels (Ctrl+C) or selects Option 2, process normally without SpecSwarm

  5. After command completes, STOP - do not continue with ship/merge

What the Modify Command Does

/specswarm:modify runs complete workflow:

  • Analyzes impact and backward compatibility
  • Identifies breaking changes
  • Creates migration plan if needed
  • Updates specification and plan
  • Generates modification tasks
  • Implements changes
  • Validates against regression tests

Stops after modification is complete - does NOT merge/ship/deploy.

Semantic Understanding

This skill should trigger not just on exact keywords, but semantic equivalents:

Modify equivalents: modify, change, update, adjust, enhance, extend, alter, revise, adapt, transform, convert Target terms: feature, functionality, behavior, workflow, process, mechanism, system

Distinguish from:

  • Fix (broken/not working things): "fix", "repair", "resolve", "debug"
  • Refactor (code quality): "refactor", "clean up", "reorganize", "optimize code structure"
  • Build (new things): "build", "create", "add", "implement new"

Example

code
User: "Change authentication from session to JWT"

Claude: 🎯 Running /specswarm:modify... (press Ctrl+C within 3s to cancel)

[Executes /specswarm:modify "Change authentication from session to JWT"]
code
User: "Update the authentication"

Claude: [Shows AskUserQuestion]
1. Run /specswarm:modify - Use SpecSwarm's impact-analysis workflow
2. Process normally - Handle as regular Claude Code request

User selects Option 1