domain-modeling
Skill27 starsChanged 3 months agoMITView on GitHub
构建并打磨项目的领域模型。当用户想要确定领域术语或通用语言、记录一项架构决策,或当其他技能需要维护领域模型时使用。
Files
领域建模
在设计过程中主动构建并磨锐项目的领域模型。这是一门主动的纪律——挑战术语、构造边缘场景,并在术语表和决策成形的那一刻就把它们写下来。(仅仅阅读 CONTEXT.md 来获取词汇并不是这个技能——那是任何技能都能做的一行习惯。这个技能是为你在改变模型(而不只是消费它)时准备的。)
文件结构
大多数仓库只有单一上下文:
/
├── CONTEXT.md
├── docs/
│ └── adr/
│ ├── 0001-event-sourced-orders.md
│ └── 0002-postgres-for-write-model.md
└── src/如果根目录存在 CONTEXT-MAP.md,则该仓库有多个上下文。地图指向每个上下文所在的位置:
/
├── CONTEXT-MAP.md
├── docs/
│ └── adr/ ← 系统级决策
├── src/
│ ├── ordering/
│ │ ├── CONTEXT.md
│ │ └── docs/adr/ ← 上下文专属决策
│ └── billing/
│ ├── CONTEXT.md
│ └── docs/adr/惰性创建文件——只在你有东西要写时才创建。如果不存在 CONTEXT.md,在第一个术语被确定下来时创建一个。如果不存在 docs/adr/,在第一个 ADR 需要时创建它。
会话期间
对照术语表进行挑战
当用户使用的术语与 CONTEXT.md 中现有的语言冲突时,立即指出来。「你的术语表把『cancellation』定义为 X,但你似乎指的是 Y——到底是哪个?」
磨锐模糊的语言
当用户使用含糊或多义的术语时,提出一个精确的规范术语。「你说的是『account』——你指的是 Customer 还是 User?那是两个不同的东西。」
讨论具体场景
当在讨论领域关系时,用具体场景对它们进行压力测试。构造能探测边缘情况的场景,迫使用户对各概念之间的边界表述得精确。
与代码交叉引用
当用户陈述某个东西是如何工作的时候,检查代码是否与之一致。如果你发现矛盾,就把它摆出来:「你的代码取消的是整个 Order,但你刚说部分取消是可能的——哪个才对?」
就地更新 CONTEXT.md
当一个术语被确定下来时,当场更新 CONTEXT.md。不要把它们攒起来——在它们发生的当下就捕获下来。使用 CONTEXT-FORMAT.md 中的格式。
CONTEXT.md 应完全不含实现细节。不要把 CONTEXT.md 当作规格说明、草稿纸或实现决策的仓库。它是一个术语表,仅此而已。
谨慎地提议 ADR
只有在以下三点全部成立时,才提议创建 ADR:
- 难以逆转——日后改变主意的代价是实质性的
- 没有上下文就令人费解——未来的读者会想「他们为什么要这样做?」
- 是真实权衡的结果——存在真正的备选方案,而你出于具体理由选了其中一个
如果三者中缺了任何一个,就跳过 ADR。使用 ADR-FORMAT.md 中的格式。
Other versions195 projects use a version of this.
Word for word · 0
None found.
Edited · 1
- devcxl/mattpocock-skills-zh★ 52211% same
Wrote their own version · 194
- mattpocock/skills★ 309ksame name
- QuivrHQ/quivr★ 40ksame name
- windmill-labs/windmill★ 18ksame name
- GreyDGL/PentestGPT★ 16ksame name
- formbricks/formbricks★ 13ksame name
- ArcReel/ArcReel★ 6ksame name
- vinvcn/mattpocock-skills-zh-CN★ 5.5ksame name
- withcoral/coral★ 4.9ksame name
- bestofjs/bestofjs★ 3.1ksame name
- rohitg00/pro-workflow★ 2.9ksame name
184 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
Used alongsideProjects with it also use decision-mapping and remove-slop.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
FabienDehopreSkilldecision-mapping
Turn a loose idea into a sequenced map of investigation tickets, then drive them to resolution one at a time.
Also in 8 projects that use this
Akindu23Skillremove-slop
Remove generated slop from a change set so code matches the file and prose keeps a human voice.
Also in 3 projects that use this
In this repository36 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- ask-mattSkill
- codebase-designSkill
- code-reviewSkill
- diagnosing-bugsSkill
- grill-with-docsSkill
- implementSkill
- improve-codebase-architectureSkill
- prototypeSkill
- researchSkill
- resolving-merge-conflictsSkill
- setup-matt-pocock-skillsSkill
- tddSkill
- to-specSkill
- to-ticketsSkill
- triageSkill
- wayfinderSkill
- wizardSkill
- claude-handoffSkill
- loop-meSkill
- setup-ts-deep-modulesSkill
- writing-beatsSkill
- writing-fragmentsSkill
- writing-shapeSkill
- git-guardrails-claude-codeSkill
- migrate-to-shoehornSkill
- scaffold-exercisesSkill
- setup-pre-commitSkill
- grillingSkill
- grill-meSkill
- handoffSkill
- teachSkill
- to-questionnaireSkill
- wait-whatSkill
- writing-for-agentsSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

