# lingshu-skills · 灵枢自我认知技能包 > 灵枢(AEIS · Agent Engineering Implementation Specification)· CommonTrustProtocol 主仓库内部 > **本质:灵枢了解自身的工具**——不是独立仓库,是灵枢项目的一部分。 > 用灵枢自己构建的条件单元,描述灵枢自己如何认知(白箱自举的对外投影)。 --- ## 这是什么 一个 **Agent Plugins 1.0.0 兼容包**(agent-plugins.org),内含 **686 个 Agent Skills(六域条件单元)+ 1 个元技能(设计者视角)**: | 域 | 单元数 | 内容 | |---|---|---| | compiler | 116 | 中文编译器(词法/语法/编译/VM/调试/分析)| | pylang | 120 | Python 语言机制(表达式/函数/类/闭包)| | graph | 117 | 图算法与图数据库 | | os | 112 | 操作系统(进程/调度/文件系统)| | browser | 104 | 浏览器与网页 | | net | 117 | 网络(协议/传输/安全)| | **合计** | **686** | 白箱六域条件单元 | 每个技能描述灵枢在**什么条件下**能做什么、**怎么执行**、**克制什么**——比标准 Agent Skills 多出 **KCCS 四要素(生效条件/子功能/执行/不适用条件)** 与**不适用条件三通道**(description「Not for」+ metadata.kccs.not_applicable + 正文克制条款章节)。 ## 三层关系(知识 → 说明书 → 执行) ``` 知识真源(本仓 md_cg) md_cg/whitebox_kb/wisdom/*_code_units.py(KCCS 四要素,真源) ↓ 导出(tools/skill_export.py + skill_export_verify.py 门禁,工具置身体仓) 说明书(本包) skills/ —— Agent Skills:何时用/怎么用/克制什么 ↓ 执行 MCP(灵枢 33 工具) md_cg-mcp(MCP stdio)· 随 dsh-memory 插件自带——物理基底裁决 ``` | 层 | 是什么 | 作用 | |---|---|---| | 知识真源 | 条件单元库(686 单元)| 知道什么、条件是什么 | | **本技能包**(说明书)| SKILL.md 技能 | 告诉 agent 何时用、怎么用、克制什么(认知自身)| | MCP(执行)| 灵枢 77 工具 | 提供实际能力执行(编译/运行/断言 = 物理基底)| **技能包的 Verification 由灵枢 MCP 工具执行**——技能说「怎么验证」,MCP 负责「真去跑」。 ## 元技能层(设计者视角) 除 686 个操作层条件单元外,本包含 1 个**元技能** `designer-perspective`: | 维度 | 说明 | |---|---| | 定位 | 不承担操作层执行,只赋予全局观测 / 结构识别 / 方向判断 / 资格裁决 / 条件层归因(《智能论3.4》1.4.2 视角层次)| | 与条件路由的关系 | 互补:686 条件单元回答「怎么做」,元技能回答「该不该做 / 为什么做 / 条件够不够」;`condition-route.unit-count` 仍为 686,元技能单列 | | 真源 | 手写(真源即 `skills/designer-perspective/SKILL.md`);不属于六域条件单元,不经 `tools/skill_export.py` 生成 | | 认知图接入 | 只读调用 md_cg(dsh-memory):`mdcg_metacognition.self_check`(回答前自检)/ `mdcg_search`(四态阶梯)/ `mdcg_evolution`(账本);写操作须由 agent 显式发起 | | 自证 | `python skills/designer-perspective/tests/selftest.py` → 逐项结果 + 通过率 | ```bash cd skills/designer-perspective python scripts/designer.py declare --position designer --space 观测工具=条件证据 python scripts/designer.py judge --query "..." --conditions '{"观测位置":"操作层"}' --emit-mcp python tests/selftest.py # 认知能力验收(17 条用例,输出通过率) ``` ## 为什么是「自我认知」 - 每个技能描述的是**灵枢自己的能力**(如「编译-递归」= 灵枢编译器如何编译递归函数) - 整包 = 灵枢把自己「会做什么、在什么条件下做、克制什么」显式写成说明书 - 与「认知自身的图」(archify 认知图补强)同思想:图 = 视觉化自我认知,技能包 = 文本化自我认知 - **白箱自举的对外形态**:灵枢用自己构建的条件单元描述自己 ## 结构 **v2.0 层级化布局**(2026-09-11 重组):687 个平铺条目收敛为 **7 个顶层技能**(6 域入口 + 1 元技能)。 入口层进 agent 上下文做域级命中;686 个单元收进 `<域>/units/` 按需回读,单元内容零改动。 ``` aeis/skills/ ├── plugin.json # Agent Plugins manifest(condition-route 已层级化声明) ├── skills/lingshu-/ # 6 个域入口(compiler/pylang/graph/os/browser/net) │ ├── SKILL.md # 域级 KCCS 四要素 + 子域路由表(子域→单元 slug)+ 路由流程 │ └── units//SKILL.md # 686 个条件单元(原样收纳;KCCS 单元级四要素;按需回读) ├── skills/designer-perspective/ # 元技能(手写真源,不属六域) │ ├── SKILL.md # 设计者视角主说明书(三通道负路由 + KCCS 四要素) │ ├── references/ # 5 份方法论(每条附《智能论3.4》行号锚点) │ ├── scripts/ # designer.py(声明/四态判定/五失配归因/蒸馏/--emit-mcp) │ └── tests/ # cases.jsonl + selftest.py(认知能力验收,输出通过率) └── README.md # 本文件 ``` ### 路由三通道(替代 686 description 全量加载) | 通道 | 载体 | 适用 | |---|---|---| | 词面路由 | 域入口路由表(子域→单元 slug)| 任务含明确触发词 | | 语义路由 | `mdcg cg op=route intent=<任务>` | 语义模糊/跨子域 | | 全量索引 | `md_cg/whitebox_kb/wisdom/trigger_words_index.json` + 认知图 index_doc 索引 | 离线盘点/批量检索 | ## 使用 1. **作为 Agent Plugins 包**:任意符合 agentskills.io/agent-plugins.org 规范的 agent 可加载本包 2. **配合灵枢 MCP**:技能的 Verification(物理基底)由灵枢 MCP 工具执行(md_cg-mcp,随插件自带) 3. **再生成**:改知识源(`md_cg/whitebox_kb/wisdom/` 单元库)后,用身体仓的 `tools/skill_export.py --out skills` 重新导出, `tools/skill_export_verify.py` 作为发布门禁(验证全绿才允许提交;默认 clean-room——导出前清空输出目录,历史残留不计入校验)。 ⚠️ v2.0 起导出器须适配层级布局:单元写入 `lingshu-/units//` 并保留 6 份域入口(入口由导出器按 trigger_words_index 生成路由表),身体仓工具更新前勿触发重新导出 ## 验证状态(发布门禁) - ✅ 686/686 单元通过格式 + 三通道校验(六域) - ✅ not_applicable / when / execute / 正文克制条款 全部 686/686 - ✅ 元技能 designer-perspective 认知能力验收 17/17(tests/selftest.py) - ✅ plugin.json 符合 agent-plugins.org schema(含 extensions 扩展:self-cognition/condition-route/meta-skill/mcp) ## 与主仓库纪律 - 真源 = `aeis/wisdom/*_code_units.py`(R1 主仓库唯一真源) - 本包 = 生成投影(R3 运行时产物不入库——但本包是发布物,随主仓库版本化) - 变更须重新导出 + 验证门禁通过(R6 变更验证) --- *灵枢自我认知技能包 · 白箱条件化知识 · KCCS 四要素不放弃 · MCP 物理基底执行*