Token导航 LogoToken导航TokenDH.com
待分类只读github未标认证来源可访问许可证需确认审计通过

easysdd-refactor-fastforwardeasysdd 重构 fastforward

Agent Skill

easysdd-refactor-fastforward 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

总安装

349

周安装

14

GitHub Stars

147

下载量

113
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:easysdd-refactor-fastforward(easysdd 重构 fastforward)
来源仓库:https://github.com/liuzhengdongfortest/easysdd
仓库路径:skills/easysdd-refactor-fastforward
安装命令:
npx skills add https://github.com/liuzhengdongfortest/easysdd --skill easysdd-refactor-fastforward
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/liuzhengdongfortest/easysdd --skill easysdd-refactor-fastforward

简介

easysdd-refactor-fastforward 用于单函数或单组件的小重构,跳过 scan/design 直接改代码。

  • 入场需通过三条硬检查:行为不变、范围小(≤1文件、≤3处、≤100行)、有测试自证。
  • 用经典方法不改奇技淫巧,跑测试验证等价性,改完一句话汇报即可。
  • 不适用跨模块、全口味覆盖、生成代码或目视验证类任务,否则退到完整流程。
  • 本质是让 AI 像平时一样写代码,但守住 refactor 的底线,避免范围失控。

SKILL.md

easysdd-refactor-fastforward

用户说"优化一下这个函数"而改动明显很小(单个函数变长了、一个组件里抽个 composable、一段重复代码合并)时,走完整三阶段太重。fastforward 做一件事:让 AI 像平时一样直接改,但守住 refactor 的底线——行为等价、引用经典方法、跑测试自证。

所以这个技能非常轻。没有 scan 清单、没有 design doc、没有 checklist,改完一句话汇报就行。


入场 3 条硬检查(不过就退出到完整流程)

开写前问自己 3 件事,任一不过就退到 easysdd-refactor 走完整流程:

  1. 行为真的不变吗? 用户描述里夹带了"顺便支持 X / 改成 Y"——这是行为改动,不是 refactor,让用户拆出去走 feature / issue
  2. 范围真的小吗? 超过 1 个文件、或单文件超过 100 行改动、或预计改动点超过 3 处——退到完整流程
  3. 有测试能自证吗? 目标代码有覆盖它的测试(单测 / 集成测 / 类型检查能抓到)——没测试就退到完整流程,或先做一个 characterization test 再回来

入场硬检查的 scan 阶段完整版是 7 条,这里压缩成最关键的 3 条——剩下 4 条(跨模块、全口味、生成代码、扫不完)在"范围真的小吗"里已经被隐含排除了。


用经典方法,不发挥

fastforward 不读完整方法库,但要守住:"每一处改动都能对应到一个经典重构方法"。AI 心里想不出"我这步是 Extract Function / Memoization / Guard Clauses /..."里的哪一个,就说明这次改动不是简单重构,退到完整流程去查方法库。

常用的几种(覆盖 fastforward 80% 场景):

  • 提取函数(Extract Function):一段 > 5 行、内聚、能命名的片段 → 抽出独立函数
  • 提取变量(Extract Variable):复杂表达式 → 命名变量或 query
  • 守卫语句(Guard Clauses):开头多层嵌套 if 检查 → 提前 return 拉平
  • 分解条件(Decompose Conditional):复杂 if 条件 → 命名为布尔函数
  • 抽 composable / hook(Extract Composable):组件里封闭的状态 + 副作用 → 独立 composable / hook
  • 记忆化(Memoization):重复计算 → computed / useMemo
  • 守卫清理(Cancellation):副作用缺 cleanup → 加 onUnmounted / useEffect return

想做的动作不在这几种里也不是开箱即用的经典方法(如涉及 Parallel Change / Strangler Fig / 分层纠偏)——退到完整流程。


流程

1. 一次对齐

收到请求后,一句话回用户:"我打算做 {方法名},动 {具体文件/函数},改动点 {N} 处,预计影响 {范围}。确认就开干。"

用户确认就下一步。用户说"还有个 X 要改"——评估这个 X 是否破坏入场 3 条检查,破坏了就退到完整流程。

2. 改

按经典方法的步骤改。不产出 design doc、不产出 checklist。代码改动直接落盘。

3. 自证

  • 跑测试(单元 / 集成 / 类型检查 / lint)
  • grep 检查旧引用是否清理干净(如果做了 Extract Function / Inline Function 这类)
  • 如果改了前端状态逻辑,跑类型检查 + 已有测试;不做 UI 目视验证——要 UI 目视就不该走 fastforward

4. 一句话汇报

格式:

✓ 已完成。方法:{方法名}。改动:{文件路径:行号范围}。验证:{跑了什么测试 / 通过情况}。

有偏离、或 apply 过程中发现想再改点别的——停下问用户,不要发挥


文件产出

默认不在 easysdd/refactors/ 下建目录——fastforward 的价值就在不留存档。

例外:用户明确说"这次小重构要留个记录"——建一个 easysdd/refactors/{YYYY-MM-DD}-{slug}/{slug}-refactor-note.md,内容就是上面那句汇报再加一段"做了什么 / 为什么"。不写 design,不写 checklist。


什么时候跳出 fastforward

改到一半出现下面任一情况,停下来告诉用户"比预期复杂,建议切回完整 refactor 流程"

  • 改动点从 3 个涨到 5+
  • 发现要动的文件不止 1 个
  • 冒出一个不在常用方法清单里的动作
  • 发现没有测试能覆盖改动
  • 用户追加 "顺便改一下 X" 带入行为改动
  • 改完 AI 自证失败(测试挂了)且不是简单修正能搞定

切回方式:触发 easysdd-refactor,从 scan 阶段开始。已改的部分要么提交保留、要么 git restore 回到干净状态再扫,看用户决定。


不做什么

  • 不写 scan 清单 / design doc / checklist —— 写了就违背 fastforward 存在的理由
  • 不跨多文件改 —— 跨文件就不是"小重构"
  • 不做需要 HUMAN 目视的改动 —— 前端渲染 / 交互 / 性能感知要人看的,走完整流程
  • 不碰公开接口 —— 改了公开接口要走 Parallel Change,Parallel Change 不是 fastforward 能做的

容易踩的坑

  • 把"小"判断得太宽:用户说"小重构"但实际要动 3 个文件——AI 要老实说"这不算小,建议走完整流程"
  • 跳过入场 3 条检查就开干:这个技能的意义就在这 3 条
  • 自证偷懒:只跑类型检查不跑单元测试,或完全不 grep 旧引用
  • 改中发挥:看到邻居代码也"顺手改改"——fastforward 的范围在确认那一刻就锁死,后续不扩
  • 行为改动伪装成重构:加个新参数、改返回值格式——这是行为改动,伪装不了

相关

  • easysdd-refactor/SKILL.md — 完整 refactor 流程,复杂时切过来
  • easysdd-refactor/reference/methods.md — 完整方法库(fastforward 用户想查也可以翻,但执行不依赖它)
  • easysdd-core/SKILL.md — easysdd 家族根技能

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明,方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用;具体调用方式请以来源页面和 README 为准。

平台分布

Codex

34.7%
按下载量换算39

Claude

29.73%
按下载量换算34

Cursor

17.71%
按下载量换算20

Gemini CLI

9.17%
按下载量换算10

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

只读

该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。当前只有一个来源,正式发布前建议补源仓库或其他目录站核验。

来源信息

继续浏览同类 Skills