mcpField
C
changeset

changeset

github.com/venhdev开发1135 次安装今天更新
代码仓库

关于 changeset

用于将已确定的解决方案转为只读文件变更计划的开发技能。它追踪受影响的代码与测试，并规划必要的级联改动；若方向过时或矛盾，则报告未解决状态。

主要功能

  1. 01追踪调用方、实现、架构和测试
  2. 02分类创建、移动、更新与删除
  3. 03规划必要的级联改动
  4. 04标记过时或冲突的方向
  5. 05生成已暂存的变更树

适用场景

  1. 01规划已批准方案影响的文件
  2. 02识别逻辑变更导致失效的测试
  3. 03发现过时实施计划中的阻碍
  4. 04在实施前准备文件级交接

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/venhdev/skills --skill changeset

安装后在 Claude Code 中输入/changeset确认已加载。

详细介绍

changeset — 文件影响与级联规划

领域准则

输入与边界

接收已确定的方向或解决方案，其中包含结果、约束和可用证据。根据当前检出内容和约束性契约进行核实；规划过程保持只读，并保留提供的方向。

追踪直接和间接调用方、实现、导入项、架构和测试。只检查目标及承载关键依赖的级联；排除外观调整、推测性文件和不受影响且向后兼容的调用方。清理已被取代的逻辑：明确安排移除无用的辅助函数、过时分支，以及因解决方案而失效的测试。如果输入计划已过时或自相矛盾，则停止，不要暗中重新设计。

文件操作
  • [CREATE]：解决方案所需的新文件。
  • [MOVE]：移动或重命名，包括受影响的引用。
  • [UPDATE]：现有逻辑、契约、测试或必要的级联。
  • [DELETE]：解决方案要求移除的过时文件。
状态
  • STAGED：变更集树为已确定的方向列出了具体操作及必要的级联。
  • UNRESOLVED：方向缺失、过时或相互冲突，无法可靠地制定变更集；请列出阻碍因素和所需决策。
规范输出契约
# Changeset: <Scope> · STAGED

Basis: <Settled solution and supporting proof/reference.>
Acceptance: <Observable criteria and constraints to carry downstream.>

```text
|-- <subsystem>/
|   |-- <file>
|   |   `-- [UPDATE] <Load-bearing change and invariant>.
|   `-- <new-file>
|       `-- [CREATE] <Required component or regression check>.
`-- <deep/path/to/caller>
    `-- [UPDATE] <Necessary cascade>.

Summary: <N> files affected (<C> created, <U> updated, <M> moved, <D> deleted).
```

对于 UNRESOLVED，将变更集树替换为简明的阻碍因素、证据和所需的重新设计决策；不要虚构文件操作。

路由
  • 过时的计划暴露出未解决的需求 →（经由 /clarify）。
  • 过时的计划需要新的设计方向 →（经由 /architect-decision）。
  • 支持的变更集已获准实施 →（经由 /forge）。
  • 调用方需要跟踪进度或实用的任务拆分 →（经由 /to-tasks）。
执行协议
  1. 检查所提供的方向以及当前代码／契约。如果计划已过时或存在根本性矛盾，则停止，并报告 UNRESOLVED 以及所需的重新设计决策。
  2. 构建变更集树，列出文件操作、直接级联、验收标准和证据来源。合并冗余目录，同时保留文件层级。
  3. 提交 STAGED 后停止，不进行文件系统修改。其他地方生成的内嵌变更集，也适用相同的交接要求，无需使用此技能。

评论

支持 Markdown