safe-change-plan
Turn a confirmed specification, root-cause finding, or impact analysis into an atomic, verifiable, reversible implementation plan with explicit scope and risk controls. Use only when material decision
SKILL.mdskills/safe-change-plan/SKILL.md
GitHubEnglish
Execution Contract
Default to fast; bounded natural-language invocation is allowed.
Complete one primary task by default. Continue an authorized end-to-end workflow within each Skill's permissions; Router remains recommendation-only. Pause for new material decisions or scope, not authorization already given.
For a human-only blocker, give location, action, success signal and resume step; never request secret values or assume completion.
Validate according to actual risk; security, production, migrations, releases and other high-risk work use audit. Read references/execution-modes.en.md only when mode selection is unclear.
Safe Change Plan
Convert confirmed analysis into a safe, atomic, verifiable, and reversible implementation plan. Do not execute the plan.
Boundary
- Confirm that the requirement, desired behavior, and blast radius are sufficiently known.
- If material decisions remain open, recommend
requirements-clarification; if decisions are settled but a testable specification is missing, recommendrequirements-to-spec. If dependencies or compatibility impact are unknown, recommendchange-impact-analysis. - Do not modify code, tests, configuration, dependencies, or documentation.
- Route settled feature delivery to
feature-implementationand diagnosed local repairs tosafe-fix-implementation. - Reject opportunistic refactors and unrelated cleanup.
Workflow
- Cite the confirmed specification, root-cause report, impact analysis, diff, or repository evidence that forms the plan basis.
- Rate input sufficiency. Stop and ask only when a missing decision changes architecture, contracts, data safety, permissions, or rollback feasibility.
- List
will change,may change, andwill not changescopes. - Identify prerequisites and API, database, configuration, permission, concurrency, compatibility, deployment, and release risks.
- Split work into single-purpose steps ordered by dependency. Keep required work separate from recommended work and later optimization.
- For every step state the goal, files or modules, intended change, dependency, validation method, failure signal, and rollback action.
- Prefer compatibility layers, feature flags, additive migrations, and reversible sequencing when risk warrants them.
- Define incremental validation, the complete test strategy, stop conditions, rollback plan, and definition of done.
- Mark inferred paths or commands as assumptions; never invent repository commands.
Output Contract
- Plan basis and evidence
- Input sufficiency
- Scope: will change, may change, will not change
- Preconditions
- Atomic steps, each with goal, location, change, dependency, validation, failure signal, and rollback
- Stepwise validation
- Test strategy
- Compatibility and release risks
- Rollback plan
- Stop conditions
- Definition of done
Label every item as required, recommended, or later optimization. Do not execute any step.
简体中文
执行契约
默认使用 fast;允许边界明确的自然语言隐式调用。
默认完成一个主任务。用户已授权完整流程时,在各 Skill 权限内连续完成;Router 仍只推荐。新重大决策或超出授权时暂停,不重复索取已有授权。
必须由用户完成的阻塞步骤:给出操作位置、具体动作、成功标志、恢复步骤;不要求粘贴秘密值,不代替用户确认完成。
按实际风险选择验证;安全、生产、迁移、发布等高风险工作使用 audit。模式不明确时才读取 references/execution-modes.zh-CN.md。
安全变更计划
把已确认分析转为安全、原子、可验证、可回滚的实施计划。不要执行计划。
职责边界
- 确认需求、目标行为和影响范围已经足够清楚。
- 重大决策仍开放时使用
requirements-clarification;决策已闭合但缺少可测试规格时使用requirements-to-spec;依赖或兼容性影响未知时建议使用change-impact-analysis。 - 不得修改代码、测试、配置、依赖或文档。
- 已确认功能交付交给
feature-implementation,已诊断局部修复交给safe-fix-implementation。 - 拒绝顺手重构和无关清理。
工作流程
- 引用作为计划依据的已确认规格、根因报告、影响分析、diff 或仓库证据。
- 评估输入充分性;只有缺失选择会改变架构、契约、数据安全、权限或回滚可行性时才停止询问。
- 分别列出“将修改”“可能修改”和“明确不修改”的范围。
- 识别前置条件,以及 API、数据库、配置、权限、并发、兼容性、部署和发布风险。
- 按依赖顺序拆成单一目的的小步骤;区分必须完成、建议完成和后续优化。
- 每一步说明目标、文件或模块、修改内容、依赖关系、验证方法、失败信号和回滚动作。
- 风险需要时优先采用兼容层、功能开关、增量迁移和可逆顺序。
- 定义逐步验证、完整测试策略、停止条件、回滚方案和完成定义。
- 推断出的路径或命令必须标记为假设,不得编造仓库命令。
输出契约
- 计划依据与证据
- 输入充分性
- 范围:将修改、可能修改、明确不修改
- 前置条件
- 原子步骤;每步包含目标、位置、改动、依赖、验证、失败信号和回滚
- 逐步验证
- 测试策略
- 兼容性与发布风险
- 回滚方案
- 停止条件
- 完成定义
每项标记为必须完成、建议完成或后续优化。不得执行任何步骤。