plugins/tools/cortex/skills/cortex-refactor/SKILL.md
vault 重构 — rename/merge/split/dedupe/extract/inline/migrate-locale/evolution-apply, --apply 才落盘 backup。仅显式触发。Triggers on "重命名", "rename", "merge", "split", "重构 vault".
npx skillsauth add lazygophers/ccplugin cortex-refactorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
vault 大动干戈类操作的统一入口。全部默认 dry-run, 用户明确 --apply 才改盘。
/cortex:lint 命中 path-naming-violation / filename-illegal 后用户授权修复/cortex:refactor evolution-apply 消化 cortex-digest 抽出的 proposal| 子操作 | 说明 | References |
|---|---|---|
| rename | 改文件名 + 全 vault wikilink 同步 | rename-merge.md |
| merge | 两页合一, src 移到 归档/ | rename-merge.md |
| migrate-locale | 切 vault.lang 时一次性 rename 业务目录 | rename-merge.md |
| dedupe | TF-IDF cosine 找相似页对, --apply 调 merge | rename-merge.md |
| split | 一页按 H2 拆多页, 原页留 callout | split-page.md |
| extract | 抽 H2 节为独立 concept 页 | split-page.md |
| inline | 子页内联回父页, 子页归档 | split-page.md |
| graph-rebalance | orphan/hub 扫, 自动补 link_gaps | split-page.md |
| evolution-apply | 消化 cortex-digest 写的 proposal, patch SKILL/AGENT | evolution-apply.md |
--apply 前在 _meta/.cortex-backup/refactor-<op>/<ts>/ 全量 backup 涉及文件--apply 跑一个文件验证, 再扩大范围auto 后缀触发)--apply 显式时才落盘)--apply)evolution-apply 不接 AUTO_MODE 跳问, 仍走 AskUserQuestion 一条条问 (单条用户授权)| 文件 | 用途 |
|---|---|
| references/rename-merge.md | rename / merge / migrate-locale / dedupe 详细命令 + dry-run 输出示例 |
| references/split-page.md | split / extract / inline / graph-rebalance 详细命令 |
| references/evolution-apply.md | evolution-apply 串行流程 + safety gate + AskUserQuestion 单条循环 |
tools
UI/UX 与布局设计——做界面布局/结构/导航/组件/交互的设计决策。触发:做UI/UX/布局/排版/导航/组件/交互/栅格/响应式/图表选型/字体配对。按媒介路由 HTML/Web、原生 App(iOS/Android/桌面)、CLI、TUI。需后端动态系统不适用;配色/主题/色板走姊妹 skill design-color。
tools
主题与配色设计——做颜色搭配/调色板/主题/品牌色阶/暗模式的设计决策。触发:选配色/调色/主题/色板/品牌色/暗模式/对比度/色盲/UI风格。按媒介路由 HTML/Web(CSS变量)、原生App(平台token)、CLI(ANSI)、TUI(真彩/256/16降级)。保证可访问性(对比度/色盲安全)。需后端动态系统不适用;UI/UX 布局/组件/交互走姊妹 skill design-uiux。
tools
跨任意组件(plugin/skill/agent/command)的验证驱动优化循环纪律 skill。当用户要优化某个已有组件却无明确方向、或要防止改了反而更差(自评乐观偏差 / 多维同改归因失效 / 为凑分加废话膨胀)、或要把一套通用「评分→单变量改→改后验证严格更好才留否则回滚→触顶停」的纪律套到任意组件上时使用。管优化过程本身的纪律(validation gate / ratchet / 独立验证 / 触顶停),不评单组件深度(交 skill-dev),不查插件接线(交 plugin-dev)。仅手动 /optimize-any 触发。
data-ai
两层规则记忆 (基于 .skein/spec)。planning 时 recall 召回相关规则、task finish 后 sediment 沉淀学习 + prune 自动精简过期/重复/断链规则。core 常驻硬规 + recall 按需召回, 经判定门自动写盘 (不逐次问用户)。产出 .skein/spec 下 core/recall 规则文件 + index。另支持空仓 bootstrap 播种规则基线、记忆大面积失效 (大重构/换栈) 时 reconstruct 可逆归档后按项目类型分型重建、maintain 手动体检 (超预算/stale/断链/重复/废弃, --apply 自动修复)、auto-fix (Stop hook 写 .pending-fix 标记 → main 派 skein-specer bg 跑 maintain --apply 全自动修, 断链只报告)。