메뉴
在代码库中寻找深化机会, 参考 CONTEXT.md 中的领域语言和 docs/adr/ 中的决策. 当用户想要改进架构, 寻找重构机会, 整合紧密耦合的模块, 使代码库更可测试和 AI 可导航, 提到 "架构改进" 或 "架构梳理" 时使用.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Convert EPUB books into clean, narration-friendly plain text for local VibeVoice audiobook generation, with optional chunking for stable long-form TTS. Use when the user has an .epub and wants text cleanup, chunk prep, or a local audiobook workflow for VibeVoice.
Convert technical book chapters, papers, tutorials, or lecture notes into precise but listenable audiobook narration scripts, especially when the source contains LaTeX formulas and code in Lisp, C, Java, C#, or similar languages. Use this skill for math/code narration, SSML scripts, audiobook production plans, synchronized transcripts, and compact-vs-precise reading policies.
Help build, debug, refactor, test, and review ClojureDart applications that target Flutter, native mobile/desktop, web, or plain Dart. Use when the user asks about ClojureDart, .cljd files, cljd.build, deps.edn :cljd/opts, cljd.flutter, Dart package interop from Clojure syntax, Flutter widget construction in ClojureDart, hot reload, REPL, or ClojureDart testing.
使用捆绑的 Babashka 脚本修复 Emacs Lisp、Scheme、Common Lisp 等 Lisp 文件的括号/分隔符错误。 当用户提到 Lisp 括号错配、Paren Edit Death Loop、`.el/.lisp/.scm` 文件修复，或想在 Claude Code、Codex、Gemini 中批量修复非 Clojure Lisp 文件时使用。
从当前对话中提取 DDD 风格的通用语言术语表, 标记歧义并提出规范术语. 保存到 UBIQUITOUS_LANGUAGE.md. 当用户想要定义领域术语, 构建术语表, 强化术语, 创建通用语言, 提到 "通用语言", "术语表", "domain model" 或 "DDD" 时使用.
在 Clojure 项目中组合使用 `clj-nrepl-eval`、`clj-paren-repair-claude-hook` 和 `clj-paren-repair` 来完成 nREPL 求值与分隔符修复. 当用户提到 Clojure、nREPL、括号/分隔符错误、Paren Edit Death Loop、Claude hooks，或想在 Claude Code、Codex、Gemini 中验证和修复 `.clj/.cljs/.cljc/.bb` 文件时使用.
| name | improve-codebase-architecture |
| description | 在代码库中寻找深化机会, 参考 CONTEXT.md 中的领域语言和 docs/adr/ 中的决策. 当用户想要改进架构, 寻找重构机会, 整合紧密耦合的模块, 使代码库更可测试和 AI 可导航, 提到 "架构改进" 或 "架构梳理" 时使用. |
浮出架构摩擦并提出深化机会 -- 将浅层模块转变为深度模块的重构. 目标是可测试性和 AI 可导航性.
在每个建议中准确使用这些术语. 一致的语言是重点 -- 不要漂移到 "component", "service", "API" 或 "boundary". 完整定义在 LANGUAGE.md 中.
关键原则(完整列表见 LANGUAGE.md):
此技能受项目领域模型的_影响_ -- CONTEXT.md 和任何 docs/adr/. 领域语言为好的 seams 命名; ADRs 记录技能不应重新争论的决策. 见 CONTEXT-FORMAT.md 和 ADR-FORMAT.md.
首先阅读现有文档:
CONTEXT.md(或 CONTEXT-MAP.md + 多上下文仓库中的每个 CONTEXT.md)docs/adr/ 中的相关 ADRs(以及任何上下文范围的 docs/adr/ 目录)如果这些文件不存在, 请默默继续 -- 不要标记它们的缺席或建议预先创建它们.
然后使用 Agent 工具(subagent_type=Explore)遍历代码库. 不要遵循严格的启发式 -- 有机地探索并注意你遇到摩擦的地方:
对你怀疑是浅层的任何东西应用删除测试: 删除它会集中复杂性, 还是只是移动它?"是的, 集中"是你想要的信号.
呈现深化机会的带编号列表. 对于每个候选:
*对领域使用 CONTEXT.md 词汇, 对架构使用 LANGUAGE.md 词汇. * 如果 CONTEXT.md 定义了 "Order", 就说 "Order intake module" -- 而不是 "FooBarHandler", 也不是 "Order service".
ADR 冲突: 如果候选与现有 ADR 矛盾, 仅当摩擦足够真实以值得重新审视 ADR 时浮出它. 清楚标记它(例如 "与 ADR-0007 冲突 -- 但值得重新开启讨论, 因为..."). 不要列出 ADR 禁止的每个理论重构.
还不要提出接口. 询问用户: "你想探索其中哪一个?"
一旦用户选择了候选, 进入质询对话. 与他们一起遍历设计树 -- 约束, 依赖, 深化模块的形状, seam 后面是什么, 什么测试存活.
副作用在决策具体化时内联发生:
CONTEXT.md 中没有的概念命名深化模块? * 将术语添加到 CONTEXT.md -- 与 /domain-model 相同的纪律(见 CONTEXT-FORMAT.md). 如果不存在则懒惰创建文件.CONTEXT.md.