Communitygithub.com

SamuelChien/多知识域扩展技能集

向现有系统添加新的知识域。通过对话推导域特定配置,生成域文件夹、模板和词汇表,同时保留并连接到现有架构。

多知识域扩展技能集 是什么?

该技能用于向已有知识管理系统(如Claude Code的可组合知识系统)中增量添加新的知识域。其核心思想是“组合而非替换”——新域必须与现有域共存并建立连接。该技能通过多阶段工作流实现:首先,自动扫描现有系统以获取配置和现有域;其次,通过1-3轮对话(使用AskUserQuestion)与用户交互,从中提取新域的粒度、处理强度、维护频率、链接需求等关键信号;然后,基于提取的信号和预定义参考集,自动推导域特定配置,包括词汇映射、模式定义和文件夹结构。该技能严格遵循组合规则,确保跨域Wiki链接唯一性、Hub MOC可达性、跨域处理共存性,并通过冲突检测和核验验证防止命名冲突和配置错误。最终,它会生成完整的域基础设施(文件夹、模板、Hub MOC、域指南),更新共享上下文文件和语义搜索索引,并提供清晰的提案供用户审批。它适用于任何支持Markdown和文件系统的知识系统,特别强调多域组合的完整性验证。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/add-domain

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

您正在将一个新知识域扩展到现有的知识系统中。这是一个组合过程,而非替换。新域必须与现有域共存,同时维护自己的词汇、模式和加工流程。共享图(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个追问,针对:

  1. 词汇确认 —— “当您说 [用户用词] 时,您是指单个洞察还是较长的条目?”
  2. 跨域连接模式 —— “[新域] 的笔记会连接到您 [现有域] 的笔记吗?如何连接?”

不要直接问维度相关的问题。在自然的对话中倾听这些信号。


阶段3:推导域配置

3a. 将信号映射到域可调维度

为每个可调维度确定新域的位置:

  • 用户信号(最高优先级)
  • 最接近的用例预置,来自 ${CLAUDE_PLUGIN_ROOT}/reference/use-case-presets.md
  • 系统级维度的级联影响

3b. 构建词汇映射

阅读 ${CLAUDE_PLUGIN_ROOT}/reference/vocabulary-transforms.md 中的转换表。

优先级顺序:

  1. 用户对话中的词汇
  2. 用例预置词汇
  3. 最接近的参考域混合

构建新域的完整映射:

通用术语新域术语来源
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. 冲突检查

这对多域组合至关重要。 验证:

  1. 文件名的唯一性 —— 新域的笔记标题不与现有笔记冲突。Wiki链接根据整个工作空间的文件名解析,因此每个文件名必须是唯一的。

  2. 模式字段名称 —— 新域字段不与现有域字段冲突。如果两个域使用了同一个字段名(如 type),则枚举值必须互斥,或字段必须具有兼容的语义。

  3. 模板名称 —— 新域模板具有与现有模板不同的名称。

  4. 文件夹名称 —— 新域文件夹不与现有文件夹冲突。

如果检测到任何冲突,请在继续之前解决它们。


阶段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:验证

新域文件的核验

针对新域的文件运行核验:

  1. 所有新文件具有有效的 YAML 前置元数据
  2. 新文件中的 Wiki 链接均可解析(包括跨域链接)
  3. 新域 MOC 可从 Hub 到达
  4. 存在描述字段
  5. 主题页脚引用域 MOC

组合验证

  1. 无字段冲突 —— grep 所有模板中的字段名称,验证无语义冲突
  2. Hub 可达性 —— Hub MOC 链接到所有域 MOC,所有域 MOC 链接到其笔记
  3. 跨域链接测试 —— 创建从新域到现有域的测试链接,验证其可解析
  4. 文件名唯一性 —— 验证跨域无重复文件名:
    find . -name
    

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

相关技能