SuperAPI AI 工具集

simplify-work

编程与开发

查看项目

更新于 10-16 09:18

技能介绍

Simplify Work 是一个面向代码或文档的简化技能,适用于已经划定明确边界的区域。它的核心目标是在保持预期行为不变的前提下,让选定区域更容易理解、修改和验证。

用途 该技能用于对已有边界的代码或文档区域进行简化,包括删除、直接流重构、包装器或分支处理等。它接受直接范围、交接、评审发现或 Plan 作为输入,并遵循 engineering-discipline.md 的工程纪律。

主要能力

  • 在编辑前确认有界表面、预期行为、调用方、约束和验证方式。
  • 读取仓库说明和相关当前文档,检查工作区,避免将已有改动误认为任务工作。
  • 追踪相关调用方、数据、组件或控制流,找出承载成本的意外结构。
  • 优先采用删除、直接数据流、规范归属,以及能消除无效状态和分散分支的类型或数据模型。
  • 保持每次改动足够小,便于推理和验证,避免无关清理和推测性抽象。
  • 随工作推进运行聚焦检查,然后运行相关回归或验收门禁,并阅读结果。
  • 对于 Plan 支持的工作,选择请求的或下一个未勾选阶段,遵循其检查点,仅在证据支持后更新任务或验收标准;应用该阶段的 Doc Delta 和引用的草稿工作;经全新评审和修复后,在标记完成前更新 Plan 和文档。
  • 通过 review-work 将整个范围(而不仅是最新补丁)发送给独立的全新上下文评审者,对照主要证据验证被接受的主张,修复被授权的阻塞性发现,并重新运行受影响的检查。
  • 简洁地报告简化内容、行为证据和残余风险。

使用方式 该技能不以行数为目标,而是倾向于在能降低读者负担时减少概念、分支、层级、可变状态和重复规则。它要求保留无关的未提交工作和已有草稿或原型,只清理归属明确的任务创建产物。如果变更需要新产品行为、更改已声明的兼容性契约或未解决的架构归属,应停止以等待负责人判断,或将发现路由到 improve-architecture。默认不扫描整个仓库、不创建 Plan 或交接、不进行访谈、不生成 HTML。

适用场景 适用于已有明确边界的代码或文档区域的简化工作,尤其是删除、直接流重构、包装器或分支处理等场景。也适用于有 Plan 支持的分阶段简化工作。

限制 不改变预期行为;不扫描整个仓库;默认不创建 Plan 或交接、不进行访谈、不生成 HTML;不以行数为目标;不进行无关清理和推测性抽象;涉及新产品行为、兼容性契约变更或架构归属未定时需停止或转向 improve-architecture。