用途
Domain Analysis 用于为一个真实系统、功能或系统之系统（包括由用户、编排器、委托者、工具与执行框架组成的智能体系统）建立持久的模型。它把系统建模为五个层级上的节点，并与从整体系统到组件的粒度交叉，节点之间以手段—目的和部分—整体关系连接，并记录谁对每个节点施加动作、谁能看到每个节点。记录本身就是模型：后续运行会加载它并扩展它。
主要能力
- 五层建模：功能目的（purpose）、抽象功能（value）、通用功能（function）、物理功能（process）、物理形态（form）。
- 粒度划分：从最粗到最细命名系统的粒度，如系统、子系统、组件，或领域自身的用词。
- 关系链接：
- 手段—目的链接（means-of）：每个节点链接到它服务的上一层节点，向上读回答“为什么”，向下读回答“如何”。
- 部分—整体链接（part-of）：每个节点链接到同层中更粗一级、包含它的节点。
- 缺口识别：功能目的之下不服务任何节点的节点，或物理形态之上没有节点承载的节点，记为缺口（open line）。
- 行为者记录：命名每个行为者（person 或 agent），记录其施加动作的节点和可见的节点；某人施加动作却看不到、或某个目的/价值没有行为者看到，记为发现（finding）。
- 持久记录：记录保存在存储中，并在镜像文件夹保留副本；支持恢复运行、追加答案、跳过与开放项。
使用方式
- 开始：在存储中查找主题命名该系统的记录。若存在则恢复：读取它，取每个节点、链接、行为者的最新行作为当前模型，先回答其开放行再添加新内容。
- 确定范围：把系统、边界、模型服务的任务以及阅读方式（即将工作的领域或智能体系统）写入运行行的 subject。
- 命名粒度：从最粗到最细命名系统的粒度。
- 构建：当目的已知时从功能目的向下工作；为解释故障时从物理形态向上工作。放置节点，赋予稳定 id（层级 id 词 + 连字符 + 数字，如 function-3，永不复用）。当领域是代码时，为每个物理功能和物理形态节点给出其所在路径，无路径的节点在证据中标记为未验证。
- 链接：建立手段—目的链接和部分—整体链接，双向测试每条链接。
- 记录缺口与行为者：记录缺口为开放行，记录行为者为 actor 行。
- 展示：以 assets/playback.md 的形式在回复中展示整个模型，先 Model 部分，再是发现和开放项，每项命名其节点。围绕它写平实的陈述句，说明模型显示了什么以及每个发现对模型服务的任务为何重要。每个主张都绑定到节点的证据，或标记为假设。
- 记录：记录保存在 ${CLAUDE_PLUGIN_DATA}/records/，并在镜像文件夹 ${user_config.records_mirror} 保留副本。当存储路径不是绝对路径时，不存在存储，仍构建记录并在回复末尾以 jsonl 块形式给出文件名供用户保存。当镜像路径为空或仍是占位符时跳过镜像。否则在运行最后一行之后，把记录文件复制到镜像下同名文件。
记录格式
文件名：domain-analysis_[start time, UTC, YYYYMMDDTHHMMSSZ]_[topic].jsonl
每行一个 JSON 对象，按事件发生顺序，每个括号值替换。kind 按运行产生情况写入，未产生的 kind 省略。时间取 UTC 时钟。topic 为两到六个小写单词用连字符连接。answer 的 q 命名它回答的问题或开放项。
追加行；永不更改或删除一行。共享 id 的行中最新者胜。链接的 id 是其 from、to 和 rel。"retired": true 移除条目。
恢复运行时，读取其文件（仅镜像持有时先从镜像复制），追加带 "resumed": true 的 run 行。回答记录问题的 agent 把其 answer、skip 和 open 行追加到同一文件，并在 by 中命名自己。
运行结束时，以 assets/playback.md 的形式回放记录：保存到的路径，然后是回复尚未展示的每个部分。永不展示原始行。
记录范围作为 subject；每个节点、链接和行为者放置时各占一行；每个缺口作为关于其节点的开放行；每个发现作为 result；恢复时每个已回答的开放项作为 answer 行。
适用场景
- 对代码系统进行领域建模，理解其目的、功能、组件与形态。
- 对智能体系统建模，包括用户、编排器、委托者、工具与执行框架。
- 解释系统故障时从物理形态向上追溯。
- 需要持久、可扩展、可恢复的系统模型记录。
限制
- 记录格式和字段由模板严格定义，需按模板写入。
- 当存储路径不是绝对路径时，不存在存储，只能以 jsonl 块形式输出供用户保存。
- 当镜像路径为空或仍是占位符时，跳过镜像。
- 节点 id 永不复用；修正为新行同 id，移除为 "retired": true。
- 未提供关于收费、价格、平台或效果的信息。