Communitygithub.com

SamuelChien/mega-skills-collection

為您現有的知識系統新增一個知識領域。透過對話推導出領域專屬設定,自動產生領域資料夾、範本與詞彙,同時保留並連結至您現有的系統架構。

mega-skills-collection 是什麼?

此技能旨在讓使用者以組合(composition)而非取代的方式,為既有知識系統新增一個知識領域。它透過與使用者進行簡短的對話,理解新領域的獨特需求後,自動推導出該領域的設定,包括詞彙映射、資料結構(Schema)和處理模式。此技能支援 Claude Code、Cursor 等平台,其設計核心在於確保新領域能與現有領域和諧共存、避免衝突(如檔案名稱、欄位名稱),並透過 Hub MOC、Wiki 連結與語意搜尋等機制,將新領域無縫整合進現有的知識圖譜中。整個流程包含掃描現有系統、對話推導、設定產生、衝突檢查、規則驗證、架構生成與最終驗證,確保新增領域的過程嚴謹且不破壞現有系統的完整性。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

您正在擴展現有的知識系統,新增一個領域。這是組合(composition),而非取代。新領域必須與現有領域共存,同時維護自己的詞彙、資料結構(schema)和處理模式。共享的圖譜(Wiki 連結、樞紐 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 個維度分類為系統層級或領域可調整:

維度類型理由
組織系統層級扁平/階層適用於整個工作區
自動化系統層級掛鉤和技能是整個工作區的基礎設施
導覽深度系統層級樞紐 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. 最接近的參考領域混合

為新領域建構完整的映射:

通用詞彙新領域詞彙來源
筆記[詞彙][使用者 / 預設 / 混合]
萃取 / 濃縮[詞彙][使用者 / 預設 / 混合]
連結 / 反思[詞彙][使用者 / 預設 / 混合]
MOC[詞彙][使用者 / 預設 / 混合]
描述[詞彙][使用者 / 預設 / 混合]
主題[詞彙][使用者 / 預設 / 混合]
收件匣[詞彙][使用者 / 預設 / 混合]

3c. 設計領域專屬資料結構

從基礎筆記資料結構(描述、主題)開始,並新增領域專屬欄位:

_schema:
  entity_type: "[領域]-note"
  applies_to: "[領域資料夾]/*.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:樞紐 MOC 連結至所有領域 MOC

必須更新現有的樞紐 MOC(index.md 或等效檔案),以包含新領域的入口 MOC。階層結構變為:

hub -> 現有領域 MOC
    -> 新領域 MOC

規則 3:跨領域反思搜尋所有筆記資料夾

如果連線查找(反思)功能已啟用,它必須搜尋所有領域——新領域中的筆記可能連結到現有領域中的筆記。語意搜尋集合必須包含新領域資料夾。

規則 4:領域專屬處理可以共存

如果新領域需要與現有領域不同的處理強度,則管線必須根據筆記類型進行路由。研究筆記使用重度處理,關係筆記使用輕度處理,依此類推。

規則 5:上下文檔案載入是漸進的

新領域的方法論指南應僅在處理該領域時載入,而不是在每次工作階段開始時載入。這可以防止隨著領域累積而導致的上下文膨脹。

一致性檢查

透過 ${CLAUDE_PLUGIN_ROOT}/reference/interaction-constraints.md 執行新領域的設定:

  • 新領域設定與系統層級維度之間的硬性限制違反
  • 特定於新領域的軟性限制警告
  • 對現有領域的串聯效應

階段 5:提出方案

向使用者精確展示將要建立的內容以及它如何與現有系統連結。

輸出格式:

=== 新增領域方案 ===
新領域:[領域名稱]
詞彙:[關鍵詞彙映射]

--- 將建立的內容 ---

資料夾結構:
  [領域資料夾]/           <- [描述]
    index.md                 <- 領域樞紐 MOC
  [領域收件匣]/            <- 捕捉區(如果處理強度 >= 適中)
  templates/[領域]-note.md <- 包含領域資料結構的筆記範本

--- 與現有系統的連結 ---

- 樞紐 MOC(index.md):新增 [新領域] 區塊,包含指向 [[領域-index]] 的連結
- 跨領域連結:[新領域] 筆記可以連結到 [現有領域] 筆記,反之亦然
- 共享基礎設施:self/、ops/、templates/ 保持共享
- 語意搜尋:[新增集合 / 目前數量下不需要]

--- 不變的部分 ---

- 現有 [領域] 資料夾:不受影響
- 現有範本:不受影響
- 現有 MOC 階層:不受影響(樞紐新增一個連結)
- self/ 空間:共享(methodology.md 更新為包含多領域模式)
- ops/ 空間:共享(derivation.md 更新為包含領域新增)

--- 領域設定 ---

| 維度 | 定位 | 理由 |
|-----------|----------|-----------|
| 粒度 | [值] | [原因] |
| 處理 | [值] | [原因] |
| 維護 | [值] | [原因] |
| 資料結構 | [值] | [原因] |
| 連結 | [值] | [原因] |
| (系統層級維度繼承自現有系統) |

--- 資料結構預覽 ---

[顯示新領域範本的 _schema 區塊]

--- 詞彙映射 ---

| 通用 | 新領域 | 現有領域 |
|-----------|-----------|-----------------|
| 筆記 | [詞彙] | [現有詞彙] |
| ... | ... | ... |

您希望我建立這個嗎?在生成之前,我可以調整任何內容。
=== 方案結束 ===

等待使用者批准後再繼續。


階段 6:生成

建立新領域的基礎設施。順序很重要——後續的產物會參考先前的產物。

步驟 1:領域資料夾結構

建立領域的筆記資料夾和可選的收件匣資料夾:

mkdir -p [領域資料夾]
mkdir -p [領域收件匣]  # 如果處理強度 >= 適中

步驟 2:領域筆記範本

建立 templates/[領域]-note.md,包含推導出的 _schema 區塊、必要和選用欄位,並在註解和範例中使用領域詞彙。

步驟 3:領域樞紐 MOC

建立 [領域資料夾]/index.md:

---
description: [以領域詞彙描述的入口點]
type: moc
---

# index

[以領域詞彙撰寫的導覽段落]

## [領域:主題]
(主題會隨著筆記累積而浮現)

## 開始使用
1. 捕捉您的第一則 [領域:筆記]
2. 將其連結至此樞紐

步驟 4:領域指南

建立一個領域專屬的方法論文件,在處理此領域時載入。對於 Claude Code:.claude/skills/[領域]-guide/SKILL.md 或上下文檔案中的一個章節。對於其他平台:一個獨立的指南檔案。

指南涵蓋:

  • 如何在此領域中捕捉
  • 如何處理(以推導出的強度)
  • 何時進行跨領域連結
  • 領域專屬的品質標準
  • 領域詞彙參考

步驟 5:更新樞紐 MOC

將新領域新增至現有的樞紐 MOC(index.md):

## [新領域名稱]
- [[領域-index]] -- [描述此領域追蹤的內容]

步驟 6:更新上下文檔案

新增至上下文檔案:

  • 領域路由:當在 [領域] 中工作時,載入 [領域指南]
  • 詞彙:新領域詞彙已新增至詞彙參考
  • 處理:如果處理強度不同,請記錄路由方式
  • 跨領域連結:何時以及如何進行跨領域連結

步驟 7:更新 self/methodology.md

新增多領域工作模式:

  • 如何在領域之間切換
  • 何時建立跨領域連結
  • 各領域的處理觸發條件

步驟 8:更新 ops/derivation.md

記錄領域新增:

  • 新領域名稱和詞彙
  • 領域可調整維度定位及其理由
  • 已驗證的組合規則
  • 跨領域連結模式
  • 新增的日期和背景

步驟 9:更新語意搜尋(如果已設定)

如果已設定 qmd 或等效工具:

# 為領域資料夾新增集合
qmd update
qmd embed

更新 .mcp.json 或等效設定以包含新集合。

步驟 10:領域處理技能(如果處理強度 >= 適中)

如果新領域需要自己的處理技能(因為處理強度或詞彙與現有領域不同),請生成適用於該領域的濃縮/反思/驗證技能版本。

如果現有技能可以透過筆記類型處理多領域路由,則更新它們而不是建立副本。


階段 7:驗證

新領域檔案的核心檢查

對新領域的檔案執行核心驗證:

  1. 所有新檔案上的 YAML frontmatter 都有效
  2. 新檔案中的 Wiki 連結能夠解析(包括跨領域連結)
  3. 從樞紐可以到達新領域 MOC
  4. 描述欄位存在
  5. 主題頁尾參考了領域 MOC

組合驗證

  1. 無欄位衝突——在所有範本中 grep 欄位名稱,驗證無語意衝突
  2. 樞紐可達性——樞紐 MOC 連結至所有領域 MOC,所有領域 MOC 連結至其筆記
  3. 跨領域連結測試——從新領域建立一個測試連結到現有領域,驗證其可解析
  4. 檔案名稱唯一性——驗證跨領域無重複檔案名稱:
    find . -name "*.md" | xargs -I {} basename {} | sort | uniq -d
    
  5. 資料結構一致性——驗證新領域的資料結構與其詞彙一致(例如,如果使用者使用「日誌條目」這個詞,則 entity_type 應為 log-entry)

最終一致性檢查

  1. 從使用者對話到維度定位的逆向鏈結是否一致?
  2. 新領域的詞彙是否與其用例語意一致?
  3. 跨領域連結模式是否與使用者的工作流程相符?
  4. 隨著新領域的新增,系統是否仍然保持可組合性(即,第 5 個領域能否乾淨地新增)?

如有任何檢查失敗,請修正後再繼續。

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".

相關技能