mcpField
S
simplify-work

simplify-work

github.com/klausborges开发1111 次安装2 周前更新
代码仓库

关于 simplify-work

simplify-work 是一项工程技能,指导在不改变预期行为的前提下简化指定范围,使其更易理解和维护。它涵盖范围确认、聚焦修改、验证与评审。

主要功能

  1. 01明确范围和预期行为
  2. 02保留无关的既有改动
  3. 03精简数据流与分支
  4. 04运行针对性和回归检查
  5. 05请求独立评审

适用场景

  1. 01简化指定代码范围
  2. 02减少重复规则或可变状态
  3. 03验证保持行为的重构

安装

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

$npx skills add https://github.com/klausborges/workflow-skills --skill simplify-work

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

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

skill.toml
agents/
openai.yaml
references/
engineering-discipline.md

详细介绍

简化工作

在保留预期行为的同时,让选定区域更易于理解、修改和验证。

使用 engineering-discipline.md。输入可以是明确的范围、交接内容、评审发现或 Plan。

边界

  • 阅读仓库说明和相关的现行文档;检查工作区,避免把预先存在的更改误认为任务工作。
  • 编辑前,确认明确的范围、预期行为、调用方、约束和验证方式。
  • 默认不扫描整个仓库、不创建 Plan 或交接内容、不进行访谈,也不生成 HTML。
  • 不以减少行数为目标。优先减少概念、分支、层次、可变状态和重复规则,以减轻读者负担。
  • 保留无关的未提交工作,以及预先存在的草稿或原型。仅清理由任务创建且处置方式明确的产物。
  • 如果更改需要引入新的产品行为、改变已声明的兼容性契约,或涉及尚未解决的架构归属问题,请暂停并征求负责人判断,或将架构探索转交给 improve-architecture。

简化

  1. 建立针对性的行为检查。只有现有证据无法保护重要行为时,才添加特征测试。
  2. 跟踪相关调用方、数据、组件或控制流,找出造成负担的偶然结构。
  3. 优先删除、直接数据流、规范归属,以及能够消除无效状态和分散分支的类型或数据模型。
  4. 让每项更改都足够小,以便推理和验证。避免无关清理和推测性抽象。
  5. 在工作过程中运行针对性检查,然后运行相关的回归或验收关卡。仔细查看结果。

对于由 Plan 支持的工作,选择指定的或下一个尚未勾选的 Phase,遵循其检查点,并且只有在证据充分时才更新 Tasks 或验收标准。仅应用该 Phase 的 Doc Delta 和引用的草稿内容;经过新一轮评审并修复问题后,更新 Plan/文档,再将其标记为完成。将 Plan 或 Roadmap 的清理留到最终评审。没有 Plan 时,不要凭空引入 Plan 流程。

收尾

自行检查行为是否得到保留,以及结果是否显著减轻读者负担。通过 review-work 将完整范围(而非仅最新补丁)交给具备独立新上下文的评审者;依据一手证据核实已接受的结论,修复获准处理的阻塞问题,并重新运行受影响的检查。简洁报告简化内容、行为证据和剩余风险。

评论

支持 Markdown