izittmarvin/agent-skills-zh/codebase-design
Claude Code and agent skill by izittmarvin/agent-skills-zh
- community
Checking that the SKILL.md file is still in the repository.
依据源码寻找架构改进机会，或设计指定模块的接口、职责与测试边界。适用于架构体检、深模块设计、接口方案比较；单批变更的代码审查使用 code-review。
Install
npx vskill@latest install izittmarvin/agent-skills-zh/codebase-designSKILL.md
Codebase Design
先识别用户要探索候选、设计已知模块，还是仅查询概念。遵循现有领域语言、ADR 和受保护契约；设计请求默认只交付方案，实施需由用户当前授权覆盖。
选择路径
- 寻找机会：用户要求架构体检或寻找简化点时，读取 EXPLORE.md。有指定范围就沿该范围调查；没有时从近期热点和真实痛点开始。
- 设计指定模块：先追踪调用方、接口、状态归属、依赖和测试，再读取 DEEPENING.md。已有目标时不再要求全库扫描、候选报告或二次选题。
- 查询概念：读取 VOCABULARY.md，只解释相关概念，不启动设计流程。
讨论深度、局部性或 seam 时按需查阅 VOCABULARY.md。这些词用于辅助判断，项目既有的 service、API、component 等名称继续保留。
设计与取舍
从真实调用与需求出发，列出拟保留的契约、复杂度归属、失败路径和验证方式。只有多个方案会实质改变结果或用户明确要求比较时，读取 DESIGN-IT-TWICE.md；不为未提出的未来需求增加适配器和扩展点。
能自行查证的事实先查；属于用户的实质决策用当前可用提问方式确认，也可使用已安装的 grilling。缺少其他 Skill 或子代理时自行完成对应调查，不让辅助能力成为阻塞。
完成与后续
方案需说明源码依据、前后职责与状态来源、保护的调用行为、迁移成本、验证方案和未决项。没有足够证据支持改造时，报告调查结果和缺口，不强行推荐重构。
仅讨论时交付方案即完成。用户要求落盘时使用项目计划约定或已安装的 to-checklist；已授权实施时按确认范围继续，可使用 implement。选中候选不自动授权生产改造。
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/extend/codebase-design/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/izittmarvin/agent-skills-zh/codebase-design)