关于 simplify-work
simplify-work 是一项工程技能,指导在不改变预期行为的前提下简化指定范围,使其更易理解和维护。它涵盖范围确认、聚焦修改、验证与评审。
主要功能
- 01明确范围和预期行为
- 02保留无关的既有改动
- 03精简数据流与分支
- 04运行针对性和回归检查
- 05请求独立评审
适用场景
- 01简化指定代码范围
- 02减少重复规则或可变状态
- 03验证保持行为的重构
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ klausborges/ workflow-skills --skill simplify-work安装后在 Claude Code 中输入/simplify-work确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
skill.tomlagents/openai.yamlreferences/engineering-discipline.md详细介绍
简化工作
在保留预期行为的同时,让选定区域更易于理解、修改和验证。
使用 engineering-discipline.md。输入可以是明确的范围、交接内容、评审发现或 Plan。
边界
- 阅读仓库说明和相关的现行文档;检查工作区,避免把预先存在的更改误认为任务工作。
- 编辑前,确认明确的范围、预期行为、调用方、约束和验证方式。
- 默认不扫描整个仓库、不创建 Plan 或交接内容、不进行访谈,也不生成 HTML。
- 不以减少行数为目标。优先减少概念、分支、层次、可变状态和重复规则,以减轻读者负担。
- 保留无关的未提交工作,以及预先存在的草稿或原型。仅清理由任务创建且处置方式明确的产物。
- 如果更改需要引入新的产品行为、改变已声明的兼容性契约,或涉及尚未解决的架构归属问题,请暂停并征求负责人判断,或将架构探索转交给
improve-architecture。
简化
- 建立针对性的行为检查。只有现有证据无法保护重要行为时,才添加特征测试。
- 跟踪相关调用方、数据、组件或控制流,找出造成负担的偶然结构。
- 优先删除、直接数据流、规范归属,以及能够消除无效状态和分散分支的类型或数据模型。
- 让每项更改都足够小,以便推理和验证。避免无关清理和推测性抽象。
- 在工作过程中运行针对性检查,然后运行相关的回归或验收关卡。仔细查看结果。
对于由 Plan 支持的工作,选择指定的或下一个尚未勾选的 Phase,遵循其检查点,并且只有在证据充分时才更新 Tasks 或验收标准。仅应用该 Phase 的 Doc Delta 和引用的草稿内容;经过新一轮评审并修复问题后,更新 Plan/文档,再将其标记为完成。将 Plan 或 Roadmap 的清理留到最终评审。没有 Plan 时,不要凭空引入 Plan 流程。
收尾
自行检查行为是否得到保留,以及结果是否显著减轻读者负担。通过 review-work 将完整范围(而非仅最新补丁)交给具备独立新上下文的评审者;依据一手证据核实已接受的结论,修复获准处理的阻塞问题,并重新运行受影响的检查。简洁报告简化内容、行为证据和剩余风险。
评论
支持 Markdown