菜单
Scan a codebase for architecture friction and deepening opportunities. Use when Codex needs to audit old code, find shallow modules, improve testability, identify seams before implementation, or report architecture blockers without directly changing product code.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Shared vocabulary and decision process for designing module interfaces and test seams. Use when Codex needs to decide where a seam belongs, judge whether a module is deep or shallow, design an interface that serves slicing and acceptance, or make code easier to test and navigate.
Maintain a repository's domain vocabulary and architecture decision records. Use when Codex needs to sharpen terminology, resolve ambiguous domain concepts, update CONTEXT.md, create ADRs, or support grill-with-docs, triage, TDD, diagnosis, or architecture work with durable domain language.
Clarify a feature, refactor, architecture idea, or product plan against existing code and domain docs. Use when requirements, terminology, constraints, or success signals are unclear before to-prd, to-issues, triage, or implementation, and Codex should update CONTEXT.md or ADRs only when domain terms or decisions crystallize.
Move issues, external PRs, new ideas, manual test feedback, existing-codebase audits, and regression reports through workflow triage states. Use when Codex needs to classify work, verify claims, detect already-implemented behavior, ask for missing info, create agent-ready briefs, or route changes before implementation.
Lightweight acceptance gate for completed slices, bug fixes, PRs, or implementation branches. Use when Codex needs to verify that work matches the originating issue or PRD, prove acceptance criteria and regression checks, decide pass/fail/blocked before handoff, or record acceptance evidence in GitHub, a PR, or local markdown.
Break a PRD, plan, spec, or parent issue into independently grabbable vertical-slice issues on the configured issue tracker. Use when Codex needs to convert a durable contract into implementation slices with acceptance and regression evidence requirements.
| name | improve-codebase-architecture |
| description | Scan a codebase for architecture friction and deepening opportunities. Use when Codex needs to audit old code, find shallow modules, improve testability, identify seams before implementation, or report architecture blockers without directly changing product code. |
Find architecture friction that blocks delivery, testability, or understanding. This skill reports options; it does not implement refactors unless the user explicitly asks afterward.
Use codebase-design vocabulary: module, interface, implementation, depth, seam, adapter, leverage, locality.
Read docs/agents/domain.md, docs/agents/verification.md, relevant CONTEXT.md, and ADRs when available.
Anchor the scan to a request, PRD, issue, bug, audit finding, or code area. Avoid whole-repo wandering unless the user explicitly asks.
Look for:
Use the deletion test and current verification commands.
For each candidate, include:
Strong, Worth exploring, or Speculative.For a visual report, use HTML-REPORT.md. Otherwise a concise markdown report is enough.
Choose one: