您正在将一个新知识域扩展到现有的知识系统中。这是一个组合过程,而非替换。新域必须与现有域共存,同时维护自己的词汇、模式和加工流程。共享图(Wiki链接、Hub MOC、描述字段)将连接一切。
您的任务
添加新知识域:$ARGUMENTS
参考文件
请在这些推导阶段阅读以下文件:
组合规则:
${CLAUDE_PLUGIN_ROOT}/reference/derivation-validation.md-- 测试4(多域组合)验证此模式${CLAUDE_PLUGIN_ROOT}/reference/three-spaces.md-- 三空间架构(跨域共享)${CLAUDE_PLUGIN_ROOT}/reference/interaction-constraints.md-- 域配置的一致性验证
域配置:
${CLAUDE_PLUGIN_ROOT}/reference/vocabulary-transforms.md-- 域原生术语映射${CLAUDE_PLUGIN_ROOT}/reference/tradition-presets.md-- 预验证的域配置${CLAUDE_PLUGIN_ROOT}/reference/use-case-presets.md-- 3个包含配置的预置${CLAUDE_PLUGIN_ROOT}/reference/dimension-claim-map.md-- 维度位置的研究支持${CLAUDE_PLUGIN_ROOT}/reference/failure-modes.md-- 域漏洞矩阵
验证:
${CLAUDE_PLUGIN_ROOT}/reference/kernel.yaml-- 12个不可协商的原语${CLAUDE_PLUGIN_ROOT}/reference/validate-kernel.sh-- 核验脚本
阶段1:扫描现有系统
自动执行。在添加内容之前先了解现有系统。
1a. 读取系统配置
读取 ops/derivation.md 以获取:
- 当前维度位置
- 词汇映射
- 平台和自动化级别
- 启用的功能模块
读取 ops/config.yaml 以获取实时配置值。
1b. 盘点现有域
识别所有当前知识域:
- 主要笔记文件夹及其域词汇
- 任何现有的次要域(文件夹、模板、MOC)
- 每个域中使用的模式字段
1c. 识别维度类型
将8个维度分类为系统级或域可调:
| 维度 | 类型 | 理由 |
|---|---|---|
| 组织方式 | 系统级 | 扁平/层级结构适用于整个工作空间 |
| 自动化 | 系统级 | 钩子和技能是工作空间级别的基础设施 |
| 导航深度 | 系统级 | Hub MOC结构是共享的 |
| 粒度 | 域可调 | 不同域可能需要不同的粒度 |
| 加工强度 | 域可调 | 研究需要高加工,关系需要轻加工 |
| 维护频率 | 域可调 | 不同域增长率需要不同的条件阈值 |
| 模式 | 域可调 | 特定于域的字段各不相同 |
| 链接方式 | 域可调 | 某些域需要语义搜索,其他则不需要 |
系统级维度由现有系统固定。域可调维度可以针对新域进行调整。
阶段2:对话
1-3轮对话,用于理解新域。每轮使用 AskUserQuestion。
开场问题
针对新域提出一个有重点的问题:
“给我讲讲 [来自 $ARGUMENTS 的域提示] —— 您将追踪什么类型的事物,以及这与您现有的 [当前域词汇] 工作有什么关系?”
第二部分至关重要:理解域之间的关系驱动组合决策。
信号提取
当用户回应时,提取域可调维度的信号:
| 信号 | 维度 | 位置 |
|---|---|---|
| “关于人的快速笔记” | 粒度 | 中等 |
| “对对话的深入分析” | 加工强度 | 高 |
| “只记住关键时刻” | 加工强度 | 低 |
| “我会经常重新查看和更新” | 维护频率 | 严格阈值 |
| “一旦捕获后基本不变” | 维护频率 | 宽松阈值 |
| “需要跨条目寻找模式” | 链接方式 | 显式+隐式 |
同时提取:
- 数量估算 —— 每个加工批次有多少笔记
- 时间动态 —— 内容变化的速度有多快
- 词汇 —— 用户自己对笔记、流程、组织的用词
- 跨域关系 —— 这与现有域如何连接
追问策略
在开场回应后,提出1-2个追问,针对:
- 词汇确认 —— “当您说 [用户用词] 时,您是指单个洞察还是较长的条目?”
- 跨域连接模式 —— “[新域] 的笔记会连接到您 [现有域] 的笔记吗?如何连接?”
不要直接问维度相关的问题。在自然的对话中倾听这些信号。
阶段3:推导域配置
3a. 将信号映射到域可调维度
为每个可调维度确定新域的位置:
- 用户信号(最高优先级)
- 最接近的用例预置,来自
${CLAUDE_PLUGIN_ROOT}/reference/use-case-presets.md - 系统级维度的级联影响
3b. 构建词汇映射
阅读 ${CLAUDE_PLUGIN_ROOT}/reference/vocabulary-transforms.md 中的转换表。
优先级顺序:
- 用户对话中的词汇
- 用例预置词汇
- 最接近的参考域混合
构建新域的完整映射:
| 通用术语 | 新域术语 | 来源 |
|---|---|---|
| note | [术语] | [用户 / 预置 / 混合] |
| extract / reduce | [术语] | [用户 / 预置 / 混合] |
| connect / reflect | [术语] | [用户 / 预置 / 混合] |
| MOC | [术语] | [用户 / 预置 / 混合] |
| description | [术语] | [用户 / 预置 / 混合] |
| topics | [术语] | [用户 / 预置 / 混合] |
| inbox | [术语] | [用户 / 预置 / 混合] |
3c. 设计域特定模式
从基础笔记模式(description, topics)开始,添加域特定字段:
_schema:
entity_type: "[域]-note"
applies_to: "[域-folder]/*.md"
required:
- description
- topics
optional:
- [基于对话信号的域特定字段]
enums:
[字段]:
- [域相关值]
3d. 冲突检查
这对多域组合至关重要。 验证:
-
文件名的唯一性 —— 新域的笔记标题不与现有笔记冲突。Wiki链接根据整个工作空间的文件名解析,因此每个文件名必须是唯一的。
-
模式字段名称 —— 新域字段不与现有域字段冲突。如果两个域使用了同一个字段名(如
type),则枚举值必须互斥,或字段必须具有兼容的语义。 -
模板名称 —— 新域模板具有与现有模板不同的名称。
-
文件夹名称 —— 新域文件夹不与现有文件夹冲突。
如果检测到任何冲突,请在继续之前解决它们。
阶段4:检查组合规则
阅读 ${CLAUDE_PLUGIN_ROOT}/reference/derivation-validation.md(测试4:多域组合)以获取已验证的组合模式。
验证每一条组合规则:
规则1:Wiki链接在共享命名空间中无歧义地解析
所有笔记文件名必须在所有域中唯一。新域的命名约定必须与现有域兼容。
规则2:Hub MOC链接到所有域MOC
必须更新现有的Hub MOC(index.md或等效文件),以包含新域的入口点MOC。层级结构变为:
hub -> 现有域 MOC
-> 新域 MOC
规则3:跨域反思搜索所有笔记文件夹
如果连接查找(reflect)处于活动状态,它必须搜索所有域——新域中的笔记可能连接到现有域中的笔记。语义搜索集合必须包含新域文件夹。
规则4:域特定加工可以共存
如果新域需要与现有域不同的加工强度,则处理管道必须根据笔记类型进行路由。研究笔记高加工,关系笔记轻加工,等等。
规则5:上下文文件加载是渐进的
新域的方法论指南应该仅在处理该域时加载,而不是在每次会话启动时加载。这可以防止随着域的积累而导致上下文膨胀。
一致性检查
通过 ${CLAUDE_PLUGIN_ROOT}/reference/interaction-constraints.md 运行新域的配置:
- 新域配置与系统级维度之间的硬约束违反
- 特定于新域的软约束警告
- 对现有域的级联影响
阶段5:呈现提案
向用户精确展示将创建什么,以及它如何与现有系统连接。
输出格式:
=== 添加域提案 ===
新域:[域名称]
词汇:[关键术语映射]
--- 将创建的内容 ---
文件夹结构:
[域-folder]/ <- [描述]
index.md <- 域Hub MOC
[域-inbox]/ <- 捕获区域(如果加工强度 >= 中)
templates/[域]-note.md <- 包含域模式的笔记模板
--- 与现有系统的连接 ---
- Hub MOC (index.md):添加 [新域] 部分,包含指向 [[domain-index]] 的链接
- 跨域链接:[新域] 笔记可以链接到 [现有域] 笔记,反之亦然
- 共享基础设施:self/、ops/、templates/ 保持共享
- 语义搜索:[已添加新集合 / 当前数量下不需要]
--- 不会改变的内容 ---
- 现有的 [域] 文件夹:保持不变
- 现有的模板:保持不变
- 现有的 MOC 层级:保持不变(Hub 增加一个新链接)
- self/ 空间:共享(methodology.md 更新为包含多域模式)
- ops/ 空间:共享(derivation.md 更新为包含域添加记录)
--- 域配置 ---
| 维度 | 位置 | 理由 |
|-----------|----------|-----------|
| 粒度 | [值] | [理由] |
| 加工强度 | [值] | [理由] |
| 维护频率 | [值] | [理由] |
| 模式 | [值] | [理由] |
| 链接方式 | [值] | [理由] |
| (继承自现有系统的系统级维度) |
--- 模式预览 ---
[显示新域模板的 _schema 块]
--- 词汇映射 ---
| 通用 | 新域 | 现有域 |
|-----------|-----------|-----------------|
| note | [术语] | [现有术语] |
| ... | ... | ... |
您希望我创建这个吗?在生成之前我可以进行任何调整。
=== 结束提案 ===
等待用户批准后再继续。
阶段6:生成
创建新域的基础设施。顺序很重要——后续工件会引用前面的。
步骤1:域文件夹结构
创建域的笔记文件夹和可选的收件箱文件夹:
mkdir -p [域-folder]
mkdir -p [域-inbox] # 如果加工强度 >= 中
步骤2:域笔记模板
创建 templates/[域]-note.md,包含派生的 _schema 块、必填和可选字段,以及在注释和示例中的域词汇。
步骤3:域Hub MOC
创建 [域-folder]/index.md:
---
description: [使用域词汇的入口点描述]
type: moc
---
# index
[使用域词汇的定位段落]
## [域:主题]
(主题将随着笔记积累而自然形成)
## 入门
1. 捕获您的第一个 [域:note]
2. 将其连接到这个Hub
步骤4:域指南
创建一个域特定的方法论文档,在该域中工作时加载。对于Claude Code:.claude/skills/[域]-guide/SKILL.md 或上下文文件中的一个部分。对于其他平台:一个独立的指南文件。
该指南涵盖:
- 如何在此域中捕获
- 如何加工(按派生强度)
- 何时进行跨域连接
- 域特定质量标准
- 域词汇参考
步骤5:更新Hub MOC
将新域添加到现有的Hub MOC(index.md):
## [新域名]
- [[domain-index]] -- [该域追踪内容的描述]
步骤6:更新上下文文件
添加到上下文文件:
- 域路由:当在 [域] 中工作时,加载 [域指南]
- 词汇:将新域术语添加到词汇参考
- 加工:如果加工强度不同,记录路由规则
- 跨域链接:何时以及如何跨域连接
步骤7:更新 self/methodology.md
添加多域工作模式:
- 如何在域之间切换
- 何时创建跨域连接
- 每个域的加工触发条件
步骤8:更新 ops/derivation.md
记录域添加操作:
- 新域名和词汇
- 域可调维度位置及其理由
- 已验证的组合规则
- 跨域连接模式
- 添加日期和上下文
步骤9:更新语义搜索(如果已配置)
如果配置了 qmd 或等效工具:
# 为域文件夹添加新集合
qmd update
qmd embed
更新 .mcp.json 或等效配置以包含新的集合。
步骤10:域加工技能(如果加工强度 >= 中)
如果新域需要自己的加工技能(因为加工强度或词汇与现有域不同),则生成 reduce/reflect/verify 技能的域适配版本。
如果现有技能可以通过笔记类型处理多域路由,则更新它们而不是创建副本。
阶段7:验证
新域文件的核验
针对新域的文件运行核验:
- 所有新文件具有有效的 YAML 前置元数据
- 新文件中的 Wiki 链接均可解析(包括跨域链接)
- 新域 MOC 可从 Hub 到达
- 存在描述字段
- 主题页脚引用域 MOC
组合验证
- 无字段冲突 —— grep 所有模板中的字段名称,验证无语义冲突
- Hub 可达性 —— Hub MOC 链接到所有域 MOC,所有域 MOC 链接到其笔记
- 跨域链接测试 —— 创建从新域到现有域的测试链接,验证其可解析
- 文件名唯一性 —— 验证跨域无重复文件名:
find . -name