代码库设计
设计深度模块:通过小型接口暴露大量行为,置于干净的接缝处,并可通过该接口进行测试。在设计和重构代码的任何地方使用这套语言和原则。目标是:为调用者提供杠杆效应,为维护者提供局部性,为所有人提供可测试性。
术语表
务必精确使用这些术语——不要替换为
用于设计深度模块的共享词汇。当用户想要设计或改进模块的接口、寻找加深机会、决定接缝位置、使代码更可测试或更易被AI导航,或者其他技能需要深度模块词汇时使用。
该技能提供了一套精确、一致的词汇表和设计原则,用于在代码库中设计和重构**深度模块**。深度模块的定义是:通过一个小型接口暴露大量行为,接口置于一个干净的接缝处,并且可以通过该接口进行测试。这套语言旨在为调用者提供杠杆效应,为维护者提供局部性,并为所有人提供可测试性。核心术语包括:**模块**(Module,包含接口与实现)、**接口**(Interface,调用者需要掌握的所有信息)、**深度**(Depth,行为量与接口学习成本的比值)、**接缝**(Seam,无需修改模块本身即可改变行为的位置)和**适配器**(Adapter,填充接缝的具体实现)。该技能通过词汇表、深度与浅度的对比示例、可测试性设计原则(如依赖注入、无副作用)以及模块各要素之间的关系图,为开发者提供了在代码设计中思考和沟通的共享框架。它支持任何编程语言和平台(如Claude Code、Cursor等),核心价值在于用统一语言消除歧义,并使设计决策可被明确评估和改进。
npx skills add https://github.com/mattpocock/skills/tree/main/skills/engineering/codebase-designInstalled? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →
设计深度模块:通过小型接口暴露大量行为,置于干净的接缝处,并可通过该接口进行测试。在设计和重构代码的任何地方使用这套语言和原则。目标是:为调用者提供杠杆效应,为维护者提供局部性,为所有人提供可测试性。
务必精确使用这些术语——不要替换为
This repo contains 20 individual skills — each has its own dedicated page.
Ask which skill or flow fits your situation. A router over the skills in this repo.
Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman.
Hand the current conversation off to a fresh background agent that picks up the work immediately.
Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".
Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.
Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.
Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model.
Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.
Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.
Grill the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases.
Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
Compact the current conversation into a handoff document for another agent to pick up.
Implement a piece of work based on a PRD or set of issues.
Implement a specification in code.
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
Grill me about specs for the workflows I want to build, within this workspace.
Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.
Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.
Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.
Send and manage iMessages via BlueBubbles, including attachments, tapbacks, edits, replies, and groups.
Control Eight Sleep pods (status, temperature, alarms, schedules).
BluOS CLI (blu) for discovery, playback, grouping, and volume.
Create, search, and manage Bear notes via grizzly CLI.
Capture frames or clips from RTSP/ONVIF cameras.
Search GIF providers with CLI/TUI, download results, and extract stills/sheets.