[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79FZWJ2WJ20GA4YR6QEEZPX":3,"skill-same:01M79FZWJ2WJ20GA4YR6QEEZPX":56},{"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":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":45},"01M79FZWJ2WJ20GA4YR6QEEZPX","improve-codebase-architecture",null,"扫描代码库中的深化机会，以可视化 HTML 报告呈现，然后针对你选中的机会深入追问。","15102045545\u002Fskills-cn","15102045545","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F168414493?v=4","01M79FZ671W8T1KPST7GRYEG3T","xiaokeer","01M79FZ67MMMDE1RZYSQGCPWK9",1,"MIT","https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fengineering\u002Fimprove-codebase-architecture\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: improve-codebase-architecture\ndescription: 扫描代码库中的深化机会，以可视化 HTML 报告呈现，然后针对你选中的机会深入追问。\ndisable-model-invocation: true\n---\n\n# 改进代码库架构\n\n找出架构摩擦并提出**深化机会**——将浅模块转变为深模块的重构。目标是提高可测试性和 AI 可导航性。\n\n此命令以项目领域模型为 _依据_，并建立在共享设计词汇之上：\n\n- 运行 `\u002Fcodebase-design` 技能，获取架构词汇（**模块**、**接口**、**深度**、**接缝**、**适配器**、**杠杆效应**、**局部性**）及其原则（删除测试、“接口就是测试表面”、“一个适配器 = 假想接缝，两个适配器 = 真实接缝”）。每项建议都必须准确使用这些术语——不要偏移到“component”“service”“API”或“boundary”。\n- `CONTEXT.md` 中的领域语言为良好接缝命名；`docs\u002Fadr\u002F` 中的 ADR 记录本命令不应重新争论的决策。\n\n## 流程\n\n### 1. 探索\n\n**扫描前先确定范围——YAGNI。** 深化模块的价值在于让未来对它的修改更容易，因此要格外关注代码库中最近发生变更的部分。先决定要看*哪里*，再开始查看：\n\n- 如果用户指定了方向——某个模块、子系统或痛点——就按该方向处理，跳过下面的推断。\n- 否则，沿提交历史向前查看足够长的一段（`git log --oneline`），找出代码库的热点——反复出现的文件和区域——并优先让这些路径引导你的注意力。如果变更分散、没有明显热点，则扩大范围。\n\n首先阅读项目领域术语表（`CONTEXT.md`）以及所涉及区域的所有 ADR。\n\n然后使用 Agent 工具并设置 `subagent_type=Explore`，遍历代码库。不要遵循僵化的启发式规则——自然地探索，并记录你在何处遇到摩擦：\n\n- 在哪里，理解一个概念需要在许多小模块之间反复跳转？\n- 哪些模块很**浅**——接口几乎与实现一样复杂？\n- 哪些地方仅为可测试性提取了纯函数，但真正的缺陷却隐藏在调用方式中（缺少**局部性**）？\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** 实现布局和样式，并在图\u002F流程\u002F时序能够可靠传达结构时，通过 **CDN 中的 Mermaid** 绘制图表。将 Mermaid 与手工编写的 CSS\u002FSVG 视觉元素混用——当关系呈图结构（调用图、依赖关系、时序）时使用 Mermaid；需要更具编辑设计感的效果（体量图、剖面图、收拢动画）时使用手工 div\u002FSVG。每个候选项都要有**之前\u002F之后的可视化**。务必以视觉呈现。\n\n为每个候选项渲染一张卡片，其中包含：\n\n- **文件**——涉及哪些文件\u002F模块\n- **问题**——当前架构为何造成摩擦\n- **解决方案**——用平实中文描述将发生的变更\n- **收益**——用局部性和杠杆效应解释，并说明测试将如何改进\n- **之前\u002F之后图**——并排、定制绘制，展示浅薄结构和深化结果\n- **推荐强度**——`强烈推荐`、`值得探索`、`推测性` 三者之一，以徽章呈现\n\n报告最后以**首选建议**章节收尾：你会优先处理哪个候选项，以及原因。\n\n**领域方面使用 CONTEXT.md 词汇，架构方面使用 `\u002Fcodebase-design` 词汇。** 如果 `CONTEXT.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用户选定候选项后，运行 `\u002Fgrilling` 技能，与用户一起遍历设计树——约束、依赖、深化后模块的形态、接缝后面的内容，以及哪些测试能够保留。\n\n决策逐渐明确时，要就地产生相应副作用——运行 `\u002Fdomain-modeling` 技能，在推进过程中保持领域模型最新：\n\n- **以 `CONTEXT.md` 中不存在的概念命名深化后的模块？** 将该术语添加到 `CONTEXT.md`。如果文件不存在，则延迟创建。\n- **在对话中推敲含糊术语？** 就地更新 `CONTEXT.md`。\n- **用户因不可或缺的原因拒绝候选项？** 提议创建 ADR，表述为：_“需要我把这项决策记录为 ADR，避免未来的架构审查再次提出它吗？”_ 只有当未来的探索者确实需要该原因才能避免重复建议时才提议——跳过临时原因（“现在不值得做”）和不言自明的原因。\n- **想探索深化后模块的备选接口？** 运行 `\u002Fcodebase-design` 技能，并使用其中“设计两次”的并行子智能体模式。\n","# 改进代码库架构\n\n找出架构摩擦并提出**深化机会**——将浅模块转变为深模块的重构。目标是提高可测试性和 AI 可导航性。\n\n此命令以项目领域模型为 _依据_，并建立在共享设计词汇之上：\n\n- 运行 `\u002Fcodebase-design` 技能，获取架构词汇（**模块**、**接口**、**深度**、**接缝**、**适配器**、**杠杆效应**、**局部性**）及其原则（删除测试、“接口就是测试表面”、“一个适配器 = 假想接缝，两个适配器 = 真实接缝”）。每项建议都必须准确使用这些术语——不要偏移到“component”“service”“API”或“boundary”。\n- `CONTEXT.md` 中的领域语言为良好接缝命名；`docs\u002Fadr\u002F` 中的 ADR 记录本命令不应重新争论的决策。\n\n## 流程\n\n### 1. 探索\n\n**扫描前先确定范围——YAGNI。** 深化模块的价值在于让未来对它的修改更容易，因此要格外关注代码库中最近发生变更的部分。先决定要看*哪里*，再开始查看：\n\n- 如果用户指定了方向——某个模块、子系统或痛点——就按该方向处理，跳过下面的推断。\n- 否则，沿提交历史向前查看足够长的一段（`git log --oneline`），找出代码库的热点——反复出现的文件和区域——并优先让这些路径引导你的注意力。如果变更分散、没有明显热点，则扩大范围。\n\n首先阅读项目领域术语表（`CONTEXT.md`）以及所涉及区域的所有 ADR。\n\n然后使用 Agent 工具并设置 `subagent_type=Explore`，遍历代码库。不要遵循僵化的启发式规则——自然地探索，并记录你在何处遇到摩擦：\n\n- 在哪里，理解一个概念需要在许多小模块之间反复跳转？\n- 哪些模块很**浅**——接口几乎与实现一样复杂？\n- 哪些地方仅为可测试性提取了纯函数，但真正的缺陷却隐藏在调用方式中（缺少**局部性**）？\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** 实现布局和样式，并在图\u002F流程\u002F时序能够可靠传达结构时，通过 **CDN 中的 Mermaid** 绘制图表。将 Mermaid 与手工编写的 CSS\u002FSVG 视觉元素混用——当关系呈图结构（调用图、依赖关系、时序）时使用 Mermaid；需要更具编辑设计感的效果（体量图、剖面图、收拢动画）时使用手工 div\u002FSVG。每个候选项都要有**之前\u002F之后的可视化**。务必以视觉呈现。\n\n为每个候选项渲染一张卡片，其中包含：\n\n- **文件**——涉及哪些文件\u002F模块\n- **问题**——当前架构为何造成摩擦\n- **解决方案**——用平实中文描述将发生的变更\n- **收益**——用局部性和杠杆效应解释，并说明测试将如何改进\n- **之前\u002F之后图**——并排、定制绘制，展示浅薄结构和深化结果\n- **推荐强度**——`强烈推荐`、`值得探索`、`推测性` 三者之一，以徽章呈现\n\n报告最后以**首选建议**章节收尾：你会优先处理哪个候选项，以及原因。\n\n**领域方面使用 CONTEXT.md 词汇，架构方面使用 `\u002Fcodebase-design` 词汇。** 如果 `CONTEXT.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用户选定候选项后，运行 `\u002Fgrilling` 技能，与用户一起遍历设计树——约束、依赖、深化后模块的形态、接缝后面的内容，以及哪些测试能够保留。\n\n决策逐渐明确时，要就地产生相应副作用——运行 `\u002Fdomain-modeling` 技能，在推进过程中保持领域模型最新：\n\n- **以 `CONTEXT.md` 中不存在的概念命名深化后的模块？** 将该术语添加到 `CONTEXT.md`。如果文件不存在，则延迟创建。\n- **在对话中推敲含糊术语？** 就地更新 `CONTEXT.md`。\n- **用户因不可或缺的原因拒绝候选项？** 提议创建 ADR，表述为：_“需要我把这项决策记录为 ADR，避免未来的架构审查再次提出它吗？”_ 只有当未来的探索者确实需要该原因才能避免重复建议时才提议——跳过临时原因（“现在不值得做”）和不言自明的原因。\n- **想探索深化后模块的备选接口？** 运行 `\u002Fcodebase-design` 技能，并使用其中“设计两次”的并行子智能体模式。\n",{"name":5,"description":7,"disable-model-invocation":24},true,"master","a7a44e6effe5a404eb8b622483896d79904f0c69","skills\u002Fengineering\u002Fimprove-codebase-architecture",0,"https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn","https:\u002F\u002Fgithub.com\u002F15102045545","软件开发工程师","2026-07-23 11:44:15",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":24},[35,38,41],{"tool":36,"command":37},"npx","npx skills add 15102045545\u002Fskills-cn --skill improve-codebase-architecture",{"tool":39,"command":40},"bunx","bunx skills add 15102045545\u002Fskills-cn --skill improve-codebase-architecture",{"tool":42,"command":43},"pnpm","pnpm dlx skills add 15102045545\u002Fskills-cn --skill improve-codebase-architecture","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fengineering\u002Fimprove-codebase-architecture\u002FSKILL.md",[46,52],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"agents\u002Fopenai.yaml","REFERENCE","参考文档",157,"https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fengineering\u002Fimprove-codebase-architecture\u002Fagents\u002Fopenai.yaml",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"HTML-REPORT.md",6899,"https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fengineering\u002Fimprove-codebase-architecture\u002FHTML-REPORT.md",[57,64,71,78,85,92],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M79G19FBV713ADE9Q95Y4D8E","writing-great-skills","出色编写和编辑技能的参考资料——让技能具备可预测性的词汇与原则。","https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fproductivity\u002Fwriting-great-skills\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"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},"01M79G1888W4AQP8N9D2X0XYV4","teach","在此工作区内向用户教授新的技能或概念。","https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fproductivity\u002Fteach\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},"01M79G15Z3NX0EJBP03A6VC3GJ","handoff","将当前对话压缩成交接文档，以便另一个智能体接手。","https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fproductivity\u002Fhandoff\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M79G14SKDFSWTADQZMQSCN9Q","grilling","围绕计划、决策或想法对用户进行不留情面的深度追问。当用户想对自己的思路进行压力测试，或使用任何“深度追问”触发措辞时使用。","https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fproductivity\u002Fgrilling\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M79G12NEZDVFGG45SP50P37Q","grill-me","通过不留情面的深度追问打磨计划或设计。","https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fproductivity\u002Fgrill-me\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M79G1198KAG4PE1YADT2G30R","obsidian-vault","使用 wikilink 和索引笔记搜索、创建和管理 Obsidian 仓库中的笔记。当用户想要在 Obsidian 中查找、创建或整理笔记时使用。","https:\u002F\u002Fgithub.com\u002F15102045545\u002Fskills-cn\u002Fblob\u002Fmaster\u002Fskills\u002Fpersonal\u002Fobsidian-vault\u002FSKILL.md",[],[]]