mcpField
Z
zero-tech-debt

zero-tech-debt

github.com/jnsahaj开发106545 次安装3 周前更新
代码仓库

关于 zero-tech-debt

zero-tech-debt 是一项编码技能,指导开发者按预期的最终形态重构代码。它强调清理无调用方的兼容路径、集中共享规则并验证新流程。

主要功能

  1. 01明确预期的最终形态
  2. 02保留兼容前先查找调用方
  3. 03围绕产品界面调整代码
  4. 04集中管理共享规则
  5. 05验证行为及已删除的假设

适用场景

  1. 01按预期设计重构代码变更
  2. 02删除无用模式与回退路径
  3. 03整合重复的权限或路由规则

安装

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

$npx skills add https://github.com/jnsahaj/skills --skill zero-tech-debt

安装后在 Claude Code 中输入/zero-tech-debt确认已加载。

详细介绍

零技术债

从预期的最终状态重新设计这项变更,而不是沿着产生当前补丁的历史路径修改。

步骤

  1. 用一两句话说明预期的最终状态。

  2. 在保留兼容性之前,先查找实际调用方。 如果某个模式、属性、包装器、路由别名或回退逻辑当前没有调用方,就删除它。

  3. 围绕最终产品形态重新组织。 优先选择一个清晰的组件或流程,而不是使用模式标志。只有在能形成明显边界(例如状态、布局、控件或领域命令)时才拆分。

  4. 将共享规则集中到一处。 功能标志、权限、路由控制、URL 状态和命令命名不应在多个页面间重复,也不应隐藏在视图组件中。

  5. 验证预期流程。 测试新行为,以及任何会影响导航、权限或持久化状态的已删除假设。

规则

  • 优化代码应有的样子,而不是尽可能缩小相对于旧结构的差异。
  • 删除无用的兼容路径,而不是改进它们。
  • 不要为单个功能臆造通用框架。
  • 仅将重构范围限定在让最终结构保持一致所必需的部分。
  • 优先使用描述产品意图的名称,而不是体现实现历史的名称。

评论

支持 Markdown