一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | domain-modeling | 合集仓库子目录名（见下方说明） |
| 所属合集仓库 | mattpocock/skills（Matt Pocock 个人维护的 Agent Skills 公开仓库） | GitHub |
| 作者/维护者 | Matt Pocock（Total TypeScript 创始人，AI 工程教育者，个人 Newsletter 约 6 万订阅者） | 仓库 README |
| 来源链接 | https://github.com/mattpocock/skills/tree/main/skills/engineering/domain-modeling | — |
| 许可证 | MIT | GitHub API |
| 所属仓库整体 Stars/Forks | 198,157 / 17,060（注：该数字属整个合集，不代表本技能自身热度，仅供了解仓库规模） | GitHub API |
| 该技能自身活跃度 | GitHub 全站代码搜索中，“domain-modeling/SKILL.md” 精确路径命中约 1,940 个独立仓库（抽样核实内容确为本技能原文而非同名巧合）；Anthropic 官方 Claude 插件市场页面明确将 /domain-modeling 列为该插件 21 个技能之一，该插件当前安装量 1,745 |
GitHub Code Search API、claude.com/plugins 官方页面 |
| 最新版本 | v1.1.0（2026-07-08 发布，全仓库统一发版） | GitHub Releases API |
| 安装方式 | Claude Code 插件市场一条命令，或 npx skills@latest add mattpocock/skills 按需勾选单个技能（见第十章） |
官方 README |
二、功能介绍与亮点
domain-modeling 让编码 agent 在设计过程中主动构建并打磨项目的领域模型——不是被动读取术语表，而是持续挑战、追问、记录。
核心能力：
- 对照术语表纠偏：当用户使用的词与
CONTEXT.md中已定义的术语冲突时，立即指出并要求澄清（如“你的术语表里’取消’指 X，但你刚才的意思像 Y，到底是哪个？”） - 模糊语言精确化：遇到笼统或多义词汇（如“账户”）时，主动追问并提炼出精确的规范用词
- 场景压力测试：针对讨论中的领域关系，构造具体边界场景，逼迫用户说清概念边界
- 代码与陈述交叉核对：当用户描述的行为与代码实际逻辑矛盾时主动指出
- 文件结构规范：单一上下文用
CONTEXT.md；多上下文仓库用根级CONTEXT-MAP.md索引各子上下文，文件按需懒创建，不预先铺摊子 - ADR 出手节制：仅当“难以撤销、缺乏背景会让人困惑、确有真实权衡”三条同时成立时才建议写架构决策记录，避免为不重要的决定制造文档噪音
- 目录内附带
CONTEXT-FORMAT.md、ADR-FORMAT.md两份格式规范，保证不同项目产出的术语表与决策记录结构一致
三、适用场景
固定分类：工程效率与代码质量
适用于：与 AI 协作编码时统一业务术语与“通用语言”（ubiquitous language）、在设计阶段把模糊需求逼问清楚、为重要且难以撤销的架构选择留下决策记录。受益人群：独立开发者与小团队工程师、希望减少因术语理解偏差导致返工的团队、需要养成 ADR 记录习惯但缺乏统一格式的技术负责人。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方 README 提供 Claude Code 插件市场一键安装（claude plugins install mattpocock-skills），Anthropic 官方插件页面明确列出本技能；技能目录内含 agents/ 元数据目录 |
| Codex | 原生支持 | 官方 README 明确标注“Codex, and other agents”一节，可用 npx skills@latest add mattpocock/skills 按需安装到遵循 Agent-Skills 标准的运行时；目录内 agents/openai.yaml 提供跨 agent 展示元数据 |
| OpenClaw | 未验证 | 已抓取材料未提及 OpenClaw 专门支持 |
| Hermes Agent | 未验证 | 同上 |
五、推荐理由
AI 辅助编码中很大一部分返工，源头不是代码写错，而是人和 agent 对同一个业务概念的理解从一开始就没对齐。domain-modeling 把“统一术语、记录决策”从一次性口头约定变成持续执行的纪律：每次用词出现漂移就当场纠正，每次真正重要的权衡就当场落笔，术语表和决策记录随对话自然生长而不是事后补写。相比一次性输出文档的工具，它的价值在于全程主动介入而非被动响应。
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 单个子技能维度：GitHub 代码搜索精确路径命中约 1,940 个独立仓库且抽样核实为真实内容复用；Anthropic 官方插件市场页面点名收录本技能，插件安装量 1,745；独立技术媒体 Developers Digest 专文评测该仓库架构类技能时点名本技能（合集仓库整体 stars 不作为本项依据） |
| 可用性 | 9 | npx skills@latest add 支持按需只勾选这一个技能安装，纯 Markdown 三文件（SKILL.md/CONTEXT-FORMAT.md/ADR-FORMAT.md），无需任何配置或付费依赖；仓库持续活跃维护（最近提交 2026-07-31） |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 8.7 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行及权限范围 | 无——技能主体及配套文档均为纯自然语言指令，不含任何脚本 |
| ② 运行时联网外发数据 | 无——不发起任何网络请求 |
| ③ API Key/凭据要求及存储方式 | 无需任何凭据 |
| ④ 可疑指令/Prompt Injection 迹象 | 未发现——已逐字审阅 SKILL.md、CONTEXT-FORMAT.md、ADR-FORMAT.md 全文，均为正常设计指导内容 |
| ⑤ 作者/组织信誉 | 良好——真实身份可查（Total TypeScript 创始人，长期公开发布 TypeScript/AI 工程教育内容），无刷星或自我造假迹象 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护时间 | 活跃，2026-07-31 有提交 |
七、跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| codebase-design（mattpocock/skills） | 提供“深模块设计”共享词汇表（Module/Interface/Depth 等），聚焦接口与模块边界判断 | 关注点是代码结构本身该怎么切分，本技能关注的是业务概念该怎么命名与固化，两者服务设计的不同层面 |
| wiki-architect（microsoft/skills deep-wiki 插件） | 分析已有代码库结构，自动生成文档站点式 Wiki 页面 | 是“事后梳理已有代码”生成说明文档，本技能是“设计过程中同步”构建术语表与决策记录，产出对象与介入时机都不同 |
八、用户评价
该技能目前在第三方平台尚无具名用户评价。独立技术媒体 Developers Digest 在专门评测该仓库架构类技能的文章中评价：“to-prd、improve-codebase-architecture、domain-modeling 和 codebase-design 都在推动 agent 认真思考模块边界、词汇一致性与设计质量”（2026-05-13）。
九、其他补充
同仓库还提供两个可搭配使用的姊妹技能：codebase-design（深模块设计共享词汇表）与 improve-codebase-architecture（扫描代码库生成可视化 HTML 深化建议报告，会引用本技能维护的术语表）。仓库提供多语言 README 翻译，含简体中文版。
十、安装使用方式
方式一（Claude Code 插件市场，安装全部技能）：
/plugin install mattpocock-skills方式二（按需只装这一个技能，支持 Codex 等其他 agent）：
npx skills@latest add mattpocock/skills运行后在交互式列表中只勾选 domain-modeling（以及要安装的目标 agent），无需重启，安装完成后即可在对话中直接引用或用 /domain-modeling 触发。
注意事项：官方建议首次使用前运行一次 /setup-matt-pocock-skills 完成议题跟踪工具等基础配置；该配置主要服务于同仓库的 triage 等技能，仅使用 domain-modeling 本身可跳过。
十一、注意事项
- 本技能依赖 agent 在对话中持续主动介入（纠偏、追问、记录），而非一次性生成文档，效果与使用频率正相关
CONTEXT.md被明确定位为“纯术语表”，不用于记录实现细节或临时笔记，混用会削弱其效果- 与
improve-codebase-architecture搭配使用时收益更完整，单独安装同样可作为术语与决策记录的独立工具使用 - OpenClaw、Hermes Agent 的兼容性未获第三方证据验证，实际使用前建议先行小范围测试