[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EEPBX0PJAVN73QKDRADGC4":3,"skill-same:01M7EEPBX0PJAVN73QKDRADGC4":57},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":33,"install":34,"resources":46},"01M7EEPBX0PJAVN73QKDRADGC4","improve-codebase-architecture",null,"扫描代码库，找出深化机会，以可视化 HTML 报告呈现，然后对你选中的那个进行拷问。","luestr\u002Fskills","luestr","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F152216177?v=4","01M7EEH85TQXC26ZZTNFPWV5E9","可莉","01M7EEH86EYXTVTCERP22VMFXX",94,"MIT","https:\u002F\u002Fgithub.com\u002Fluestr\u002Fskills\u002Fblob\u002Fmain\u002Fmattpocock\u002Fzh-CN\u002Fengineering\u002Fimprove-codebase-architecture\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: improve-codebase-architecture\ndescription: 扫描代码库，找出深化机会，以可视化 HTML 报告呈现，然后对你选中的那个进行拷问。\nmetadata:\n  language: zh-CN\n  disable-model-invocation: true\n---\n\n# 改进代码库架构\n\n浮现架构摩擦，提出**深化机会**：把浅模块变成深模块的重构。目标是可测试性与 AI 可导航性。\n\n本命令_依据_项目的领域模型，并建立在一套共享的设计词汇之上：\n\n- 调用 Skill 工具（传入 “codebase-design”）获取架构词汇（**模块**、**接口**、**深度**、**接缝**、**适配器**、**杠杆**、**局部性**）及其原则（删除检验、“接口就是测试面”、“一个适配器 = 假想的接缝，两个 = 真实的接缝”）。每个建议都严格使用这些术语，不要漂移到“组件”“服务”“API”或“边界”。\n- `GLOSSARY.md` 里的领域语言为好接缝命名；`docs\u002Fadr\u002F` 里的 ADR 记录了本命令不应重新争辩的决策。\n\n## 流程\n\n### 1. 探索\n\n**先定范围，再扫描：YAGNI。**深化一个模块的回报，是让它未来的改动更容易，所以给代码库中最近发生过变化的部分额外加权。看之前先决定*看哪里*：\n\n- 如果用户点名了方向（某个模块、子系统、痛点），就照做，跳过下面的推断。\n- 否则，回溯相当长一段提交历史（`git log --oneline`），找出代码库的热点——反复出现的文件和区域——先让这些路径吸引你的注意。如果改动分散、没有明显热点，就把网撒得更大。\n\n先读项目的领域术语表（`GLOSSARY.md`），以及你要触碰区域里的所有 ADR。\n\n然后派出一个子 Agent 走查代码库。不要套用刻板的启发式规则；有机地探索，并记下你体验到摩擦的地方：\n\n- 哪里理解一个概念需要在许多小模块之间来回跳转？\n- 哪里模块**浅**，接口几乎和实现一样复杂？\n- 哪里为了可测试性抽出了纯函数，但真正的 bug 藏在它们的调用方式里（没有**局部性**）？\n- 哪里紧耦合的模块越过接缝泄漏？\n- 代码库的哪些部分没有测试，或难以通过当前接口测试？\n\n对你怀疑是浅的所有东西应用**删除检验**：删除它会浓缩复杂度，还是只是把它挪个位置？你要找的信号是“是的，会浓缩”。\n\n### 2. 以 HTML 报告呈现候选方案\n\n把自包含的 HTML 文件写到操作系统临时目录，这样仓库里不会落下任何东西。临时目录优先取 `$TMPDIR`，回退到 `\u002Ftmp`（Windows 上为 `%TEMP%`），写入 `\u003Ctmpdir>\u002Farchitecture-review-\u003Ctimestamp>.html`，让每次运行都有一个新文件。为用户打开它（Linux 用 `xdg-open \u003Cpath>`，macOS 用 `open \u003Cpath>`，Windows 用 `start \u003Cpath>`），并告诉他们绝对路径。\n\n报告用 **CDN 引入的 Tailwind** 做布局和样式，用 **CDN 引入的 Mermaid** 画图——当图形\u002F流程\u002F时序能可靠传达结构时。把 Mermaid 与手工打造的 CSS\u002FSVG 视觉混用：关系呈图形状时（调用图、依赖、时序）用 Mermaid，想要更偏编辑风格的效果时（体量图、横截面、折叠动画）用手工搭建的 div\u002FSVG。每个候选方案都配一幅**前\u002F后对比可视化**。要有视觉表现力。\n\n每个候选方案渲染一张卡片，包含：\n\n- **文件**：涉及哪些文件\u002F模块\n- **问题**：当前架构为何造成摩擦\n- **方案**：用平实的语言描述将会改变什么\n- **收益**：用局部性和杠杆来解释，以及测试将如何改善\n- **前 \u002F 后对比图**：并排、手工绘制，展示其浅薄与深化\n- **推荐强度**：`Strong`、`Worth exploring`、`Speculative` 之一，渲染成徽章\n\n报告以**首要推荐**小节收尾：你会先处理哪个候选方案，为什么。\n\n**领域词汇用 GLOSSARY.md，架构词汇用 `\u002Fcodebase-design`。**如果 `GLOSSARY.md` 定义了 “Order”，就说“Order 接收模块”，不要说 “FooBarHandler”，也不要说“Order 服务”。\n\n**ADR 冲突**：如果某个候选方案与现有 ADR 相抵触，只有当摩擦足够真实、值得重新审视该 ADR 时才提出来。在卡片里清楚标出（例如一个警告提示框：_“与 ADR-0007 相抵触，但值得重新开启，因为……”_）。不要罗列 ADR 禁止的每一个理论上的重构。\n\n完整的 HTML 脚手架、图表模式和样式指引见 [HTML-REPORT.md](HTML-REPORT.md)。\n\n先**不要**提出接口。文件写好后，问用户：“你想深入探索其中哪一个？”\n\n### 3. 拷问循环\n\n用户选定一个候选方案后，调用 Skill 工具（传入 “grilling”），与他们一起走查决策树：约束、依赖、深化后模块的形态、接缝背后是什么、哪些测试能存活下来。\n\n决策成形时，副作用就地发生；调用 Skill 工具（传入 “domain-modeling”），让领域模型在过程中保持最新：\n\n- **用 `GLOSSARY.md` 里没有的概念给深化后的模块命名？**把这个术语加进 `GLOSSARY.md`。文件不存在就按需创建。\n- **在对话中把模糊的术语磨精准？**当场更新 `GLOSSARY.md`。\n- **用户以一条承重理由拒绝候选方案？**提出写一份 ADR，措辞为：_“要我把这件事记录成 ADR，让未来的架构评审不再重复推荐它吗？”_只有当未来的探索者确实需要这个理由来避免重复建议同一件事时才提出；短暂的理由（“现在不值得做”）和不言自明的理由都跳过。\n- **想为深化后的模块探索替代接口？**调用 Skill 工具（传入 “codebase-design”），使用它的 design-it-twice 并行子 Agent 模式。\n","# 改进代码库架构\n\n浮现架构摩擦，提出**深化机会**：把浅模块变成深模块的重构。目标是可测试性与 AI 可导航性。\n\n本命令_依据_项目的领域模型，并建立在一套共享的设计词汇之上：\n\n- 调用 Skill 工具（传入 “codebase-design”）获取架构词汇（**模块**、**接口**、**深度**、**接缝**、**适配器**、**杠杆**、**局部性**）及其原则（删除检验、“接口就是测试面”、“一个适配器 = 假想的接缝，两个 = 真实的接缝”）。每个建议都严格使用这些术语，不要漂移到“组件”“服务”“API”或“边界”。\n- `GLOSSARY.md` 里的领域语言为好接缝命名；`docs\u002Fadr\u002F` 里的 ADR 记录了本命令不应重新争辩的决策。\n\n## 流程\n\n### 1. 探索\n\n**先定范围，再扫描：YAGNI。**深化一个模块的回报，是让它未来的改动更容易，所以给代码库中最近发生过变化的部分额外加权。看之前先决定*看哪里*：\n\n- 如果用户点名了方向（某个模块、子系统、痛点），就照做，跳过下面的推断。\n- 否则，回溯相当长一段提交历史（`git log --oneline`），找出代码库的热点——反复出现的文件和区域——先让这些路径吸引你的注意。如果改动分散、没有明显热点，就把网撒得更大。\n\n先读项目的领域术语表（`GLOSSARY.md`），以及你要触碰区域里的所有 ADR。\n\n然后派出一个子 Agent 走查代码库。不要套用刻板的启发式规则；有机地探索，并记下你体验到摩擦的地方：\n\n- 哪里理解一个概念需要在许多小模块之间来回跳转？\n- 哪里模块**浅**，接口几乎和实现一样复杂？\n- 哪里为了可测试性抽出了纯函数，但真正的 bug 藏在它们的调用方式里（没有**局部性**）？\n- 哪里紧耦合的模块越过接缝泄漏？\n- 代码库的哪些部分没有测试，或难以通过当前接口测试？\n\n对你怀疑是浅的所有东西应用**删除检验**：删除它会浓缩复杂度，还是只是把它挪个位置？你要找的信号是“是的，会浓缩”。\n\n### 2. 以 HTML 报告呈现候选方案\n\n把自包含的 HTML 文件写到操作系统临时目录，这样仓库里不会落下任何东西。临时目录优先取 `$TMPDIR`，回退到 `\u002Ftmp`（Windows 上为 `%TEMP%`），写入 `\u003Ctmpdir>\u002Farchitecture-review-\u003Ctimestamp>.html`，让每次运行都有一个新文件。为用户打开它（Linux 用 `xdg-open \u003Cpath>`，macOS 用 `open \u003Cpath>`，Windows 用 `start \u003Cpath>`），并告诉他们绝对路径。\n\n报告用 **CDN 引入的 Tailwind** 做布局和样式，用 **CDN 引入的 Mermaid** 画图——当图形\u002F流程\u002F时序能可靠传达结构时。把 Mermaid 与手工打造的 CSS\u002FSVG 视觉混用：关系呈图形状时（调用图、依赖、时序）用 Mermaid，想要更偏编辑风格的效果时（体量图、横截面、折叠动画）用手工搭建的 div\u002FSVG。每个候选方案都配一幅**前\u002F后对比可视化**。要有视觉表现力。\n\n每个候选方案渲染一张卡片，包含：\n\n- **文件**：涉及哪些文件\u002F模块\n- **问题**：当前架构为何造成摩擦\n- **方案**：用平实的语言描述将会改变什么\n- **收益**：用局部性和杠杆来解释，以及测试将如何改善\n- **前 \u002F 后对比图**：并排、手工绘制，展示其浅薄与深化\n- **推荐强度**：`Strong`、`Worth exploring`、`Speculative` 之一，渲染成徽章\n\n报告以**首要推荐**小节收尾：你会先处理哪个候选方案，为什么。\n\n**领域词汇用 GLOSSARY.md，架构词汇用 `\u002Fcodebase-design`。**如果 `GLOSSARY.md` 定义了 “Order”，就说“Order 接收模块”，不要说 “FooBarHandler”，也不要说“Order 服务”。\n\n**ADR 冲突**：如果某个候选方案与现有 ADR 相抵触，只有当摩擦足够真实、值得重新审视该 ADR 时才提出来。在卡片里清楚标出（例如一个警告提示框：_“与 ADR-0007 相抵触，但值得重新开启，因为……”_）。不要罗列 ADR 禁止的每一个理论上的重构。\n\n完整的 HTML 脚手架、图表模式和样式指引见 [HTML-REPORT.md](HTML-REPORT.md)。\n\n先**不要**提出接口。文件写好后，问用户：“你想深入探索其中哪一个？”\n\n### 3. 拷问循环\n\n用户选定一个候选方案后，调用 Skill 工具（传入 “grilling”），与他们一起走查决策树：约束、依赖、深化后模块的形态、接缝背后是什么、哪些测试能存活下来。\n\n决策成形时，副作用就地发生；调用 Skill 工具（传入 “domain-modeling”），让领域模型在过程中保持最新：\n\n- **用 `GLOSSARY.md` 里没有的概念给深化后的模块命名？**把这个术语加进 `GLOSSARY.md`。文件不存在就按需创建。\n- **在对话中把模糊的术语磨精准？**当场更新 `GLOSSARY.md`。\n- **用户以一条承重理由拒绝候选方案？**提出写一份 ADR，措辞为：_“要我把这件事记录成 ADR，让未来的架构评审不再重复推荐它吗？”_只有当未来的探索者确实需要这个理由来避免重复建议同一件事时才提出；短暂的理由（“现在不值得做”）和不言自明的理由都跳过。\n- **想为深化后的模块探索替代接口？**调用 Skill 工具（传入 “codebase-design”），使用它的 design-it-twice 并行子 Agent 模式。\n",{"name":5,"metadata":24,"description":7},{"language":25,"disable-model-invocation":26},"zh-CN",true,"main","e755255990a0250bbae1a416cea9388f10b6bf6a","mattpocock\u002Fzh-CN\u002Fengineering\u002Fimprove-codebase-architecture",1,"https:\u002F\u002Fgithub.com\u002Fluestr\u002Fskills","https:\u002F\u002Fgithub.com\u002Fluestr","2026-11-14 01:15:26",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":26},[36,39,42],{"tool":37,"command":38},"npx","npx skills add luestr\u002Fskills --skill improve-codebase-architecture",{"tool":40,"command":41},"bunx","bunx skills add luestr\u002Fskills --skill improve-codebase-architecture",{"tool":43,"command":44},"pnpm","pnpm dlx skills add luestr\u002Fskills --skill improve-codebase-architecture","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fluestr\u002Fskills\u002Fblob\u002Fmain\u002Fmattpocock\u002Fzh-CN\u002Fengineering\u002Fimprove-codebase-architecture\u002FSKILL.md",[47,53],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"agents\u002Fopenai.yaml","REFERENCE","参考文档",156,"https:\u002F\u002Fgithub.com\u002Fluestr\u002Fskills\u002Fblob\u002Fmain\u002Fmattpocock\u002Fzh-CN\u002Fengineering\u002Fimprove-codebase-architecture\u002Fagents\u002Fopenai.yaml",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"HTML-REPORT.md",6643,"https:\u002F\u002Fgithub.com\u002Fluestr\u002Fskills\u002Fblob\u002Fmain\u002Fmattpocock\u002Fzh-CN\u002Fengineering\u002Fimprove-codebase-architecture\u002FHTML-REPORT.md",[58,65,71,78,84,91],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M7EESZM2QJKA5M0QS4M0WNGA","write-ublock-origin-filters","完整的 uBlock Origin (uBO) 静态过滤语法参考。编写 uBlock Origin 自定义过滤规则时使用此技能，涵盖广告拦截、隐私保护或内容过滤。包含基础网络过滤模式（||、*、^、|）、所有网络过滤选项（$domain、$third-party、$important、$redirect、$removeparam、$csp、$replace、$header、$method、$denyallow、$badfilter、$all 等）、内容类型选项（$script、$image、$stylesheet、$font、$media、$xhr、$popup、$document、$frame 等）、元素隐藏规则（## 选择器、实体匹配、主机名正则）、过程式元素隐藏过滤器（:has、:has-text、:matches-css、:upward、:xpath、:matches-path、:watch-attr 等）、动作操作符（:remove、:style、:remove-attr、:remove-class）、HTML 过滤器（##^）、响应头过滤（##^responseheader）、脚本注入（##+js()）以及预处理指令（!#include、!#if）。当用户提到 uBlock Origin 过滤规则、uBO 语法、广告拦截规则、元素隐藏规则、过程式选择器、脚本注入或希望编写\u002F调试任何 uBO 兼容过滤列表时触发。即使用户只是在编写或调试 uBlock Origin 过滤规则、创建自定义过滤列表或从 AdBlock Plus\u002FAdGuard 迁移过滤规则到 uBO，也应使用此技能。","https:\u002F\u002Fgithub.com\u002Fluestr\u002Fskills\u002Fblob\u002Fmain\u002Fwrite-ublock-origin-filters\u002Fzh-CN\u002Fwrite-ublock-origin-filters\u002FSKILL.md",[],[],{"skillNo":66,"name":60,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7EESN8NBTRJE793B87NBGA5","Complete uBlock Origin (uBO) static filter reference. Use this skill when writing or debugging uBO custom filters or filter lists for ad blocking, privacy or content filtering, or when migrating filters from AdBlock Plus\u002FAdGuard. Covers network patterns (||, *, ^, |) and options ($domain, $third-party, $important, $redirect, $removeparam, $csp, $replace, $header, $method, $badfilter, $all), content-type options ($script, $image, $stylesheet, $font, $media, $xhr, $popup, $document, $frame), cosmetic filters (##, CSS selectors, entity matching), procedural filters (:has, :has-text, :matches-css, :upward, :xpath, :matches-path, :watch-attr), action operators (:remove, :style, :remove-attr), HTML filters (##^), response-header filtering (##^responseheader), scriptlet injection (##+js()), and pre-parsing directives (!#include, !#if). Trigger whenever the user mentions uBO syntax, ad blocking rules, element hiding, procedural selectors, scriptlet injection, or a uBO-compatible filter list.","https:\u002F\u002Fgithub.com\u002Fluestr\u002Fskills\u002Fblob\u002Fmain\u002Fwrite-ublock-origin-filters\u002Fen-US\u002Fwrite-ublock-origin-filters\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M7EESH94GM6NWB3JAFRH7D8S","write-tampermonkey-scripts","引导 AI 代理规划、编写、调试、测试和维护 Tampermonkey 用户脚本。当用户请求用户脚本、浏览器页面自动化、DOM 增强、Tampermonkey 元数据、GM_* API、@match、@grant、@run-at、@connect、跨源请求、SPA 页面集成或脚本注入任务时使用此技能，即使用户没有明确提及 Tampermonkey。","https:\u002F\u002Fgithub.com\u002Fluestr\u002Fskills\u002Fblob\u002Fmain\u002Fwrite-tampermonkey-scripts\u002Fzh-CN\u002Fwrite-tampermonkey-scripts\u002FSKILL.md",[],[],{"skillNo":79,"name":73,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7EESCKXFQ793C4TCKSV0GZ1","Guide an AI agent through planning, writing, debugging, testing, and maintaining Tampermonkey userscripts. Use this skill whenever a user asks for a userscript, browser-page automation, DOM enhancement, Tampermonkey metadata, GM_* API, @match, @grant, @run-at, @connect, cross-origin request, SPA page integration, or script injection task, even when Tampermonkey is not named explicitly.","https:\u002F\u002Fgithub.com\u002Fluestr\u002Fskills\u002Fblob\u002Fmain\u002Fwrite-tampermonkey-scripts\u002Fen-US\u002Fwrite-tampermonkey-scripts\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7EES6SHP4F6DTQYRJ944KMR","write-adguard-filters","编写 AdGuard 自定义过滤规则时使用此技能。涵盖基本规则语法、所有修饰符（$domain\u002F$third-party\u002F$important\u002F$redirect\u002F$replace\u002F$removeparam\u002F$cookie\u002F$csp 等）、外观规则（元素隐藏\u002FCSS\u002FExtended CSS 选择器）、HTML 过滤、JavaScript\u002F脚本片段规则、非基本规则修饰符、预处理器指令和调试技巧。当用户提及 AdGuard 过滤规则、广告拦截规则语法、过滤器列表编写、ABP 语法兼容、元素隐藏规则、Extended CSS 选择器（:has\u002F:contains\u002F:matches-css 等）时触发。即使用户只是在编写或调试任何类型的广告过滤规则，也应使用此技能。","https:\u002F\u002Fgithub.com\u002Fluestr\u002Fskills\u002Fblob\u002Fmain\u002Fwrite-adguard-filters\u002Fzh-CN\u002Fwrite-adguard-filters\u002FSKILL.md",[],[],{"skillNo":92,"name":86,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M7EERZ661557QAD511EBSCCK","Complete AdGuard filtering rules syntax reference. Use this skill when writing AdGuard custom filters. Covers basic rule syntax, all modifiers ($domain\u002F$third-party\u002F$important\u002F$redirect\u002F$replace\u002F$removeparam\u002F$cookie\u002F$csp etc.), cosmetic rules (element hiding\u002FCSS\u002FExtended CSS selectors), HTML filtering, JavaScript\u002Fscriptlet rules, non-basic rule modifiers, preprocessor directives, and debugging. Trigger when user mentions AdGuard filtering rules, ad blocking rule syntax, filter list authoring, ABP syntax compatibility, element hiding rules, Extended CSS selectors (:has\u002F:contains\u002F:matches-css etc.). Use this skill even when the user is just writing or debugging any type of ad filtering rules.","https:\u002F\u002Fgithub.com\u002Fluestr\u002Fskills\u002Fblob\u002Fmain\u002Fwrite-adguard-filters\u002Fen-US\u002Fwrite-adguard-filters\u002FSKILL.md",[],[]]