@furongjun1999/dsh-memory 0.4.11 → 0.5.0

package/package.json

@@ -1,96 +1,97 @@
-{
-  "name": "@furongjun1999/dsh-memory",
-  "version": "0.4.11",
-  "description": "灵枢（Lingshu·líng shū）DeepSeek Harness 插件：完整大脑——长期记忆/知识飞轮/自我认知/递归反思接入 DSH，对话自动沉淀进 md_cg 认知图（md 文档）",
-  "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/index.d.ts",
-      "import": "./lib/index.js"
-    }
-  },
-  "files": [
-    "lib",
-    "src",
-    "md_cg",
-    "skills",
-    "README.md",
-    "dsh",
-    "codebuddy",
-    "zcode",
-    "docs"
-  ],
-  "keywords": [
-    "deepseek",
-    "dsh",
-    "dsh-plugin",
-    "cordis",
-    "memory",
-    "agent",
-    "aeis",
-    "lingshu",
-    "multi-agent",
-    "spatiotemporal",
-    "knowledge-graph"
-  ],
-  "license": "MIT",
-  "peerDependenciesMeta": {
-    "@deepseek-ai/cordis": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-llm": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-session": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-system-prompt": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-tools": {
-      "optional": true
-    },
-    "@deepseek-ai/schemastery": {
-      "optional": true
-    }
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": ">=4.0.1",
-    "@deepseek-ai/dsh-llm": ">=0.1.0-rc.6",
-    "@deepseek-ai/dsh-session": ">=0.1.0-rc.6",
-    "@deepseek-ai/dsh-system-prompt": ">=0.1.0-rc.6",
-    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.6",
-    "@deepseek-ai/schemastery": ">=3.0.0"
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-session": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
-    "@deepseek-ai/schemastery": "^3.0.0",
-    "@types/node": "^24.0.0",
-    "tsx": "^4.19.0",
-    "typescript": "^5.5.0"
-  },
-  "scripts": {
-    "build": "node -e \"require('node:fs').rmSync('lib',{recursive:true,force:true})\" && tsc -p tsconfig.json",
-    "test": "npm run build && node --import tsx --test \"test/*.test.ts\"",
-    "prepare": "node -e \"const fs=require('fs');const tsc='node_modules/typescript/bin/tsc';fs.existsSync(tsc)?(fs.rmSync('lib',{recursive:true,force:true}),require('child_process').execFileSync(process.execPath,[tsc,'-p','tsconfig.json'],{stdio:'inherit'})):console.log('[prepare] 跳过构建：typescript 未安装（NODE_ENV=production 或 --omit=dev 会省略 devDependencies）——需要构建请用 npm install --include=dev')\"",
-    "prepublishOnly": "npm run build && npm test && python scripts/check_publish_artifact.py"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/FuRongJun-1999/dsh-memory.git"
-  },
-  "engines": {
-    "node": ">=22.19"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./dsh/cordis.patch.yml"
-    }
-  }
-}
+{
+  "name": "@furongjun1999/dsh-memory",
+  "version": "0.5.0",
+  "description": "灵枢（Lingshu·líng shū）DeepSeek Harness 插件：完整大脑——长期记忆/知识飞轮/自我认知/递归反思接入 DSH，对话自动沉淀进 md_cg 认知图（md 文档）",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib",
+    "src",
+    "md_cg",
+    "skills",
+    "README.md",
+    "dsh",
+    "codebuddy",
+    "zcode",
+    "docs"
+  ],
+  "keywords": [
+    "deepseek",
+    "dsh",
+    "dsh-plugin",
+    "cordis",
+    "memory",
+    "agent",
+    "aeis",
+    "lingshu",
+    "multi-agent",
+    "spatiotemporal",
+    "knowledge-graph"
+  ],
+  "license": "MIT",
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-llm": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-system-prompt": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    },
+    "@deepseek-ai/schemastery": {
+      "optional": true
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.1",
+    "@deepseek-ai/dsh-llm": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-session": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-system-prompt": ">=0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.6",
+    "@deepseek-ai/schemastery": ">=3.0.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-session": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
+    "@deepseek-ai/schemastery": "^3.0.0",
+    "@types/node": "^24.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.5.0"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('lib',{recursive:true,force:true})\" && tsc -p tsconfig.json",
+    "test": "npm run build && node --import tsx --test \"test/*.test.ts\"",
+    "prepare": "node -e \"const fs=require('fs');const tsc='node_modules/typescript/bin/tsc';fs.existsSync(tsc)?(fs.rmSync('lib',{recursive:true,force:true}),require('child_process').execFileSync(process.execPath,[tsc,'-p','tsconfig.json'],{stdio:'inherit'})):console.log('[prepare] 跳过构建：typescript 未安装（NODE_ENV=production 或 --omit=dev 会省略 devDependencies）——需要构建请用 npm install --include=dev')\"",
+    "gate": "python scripts/check_publish_artifact.py && python scripts/cogmap_sync.py check && python scripts/link_check.py && python scripts/workspace_index.py --check && python scripts/verify_discipline.py --allow-missing",
+    "prepublishOnly": "npm run build && npm test && npm run gate"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FuRongJun-1999/dsh-memory.git"
+  },
+  "engines": {
+    "node": ">=22.19"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./dsh/cordis.patch.yml"
+    }
+  }
+}

package/skills/plugin.json

@@ -1,55 +1,55 @@
-{
-  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
-  "name": "lingshu-skills",
-  "version": "0.1.0",
-  "description": "灵枢（AEIS）自我认知技能包——白箱条件化知识（Agent Skills 兼容导出）。本质是灵枢了解自身的工具：每个技能描述灵枢在什么条件下能做什么、怎么执行、克制什么（KCCS 四要素），由条件路由图精确路由，由灵枢 MCP 工具执行验证（物理基底）。",
-  "author": {
-    "name": "灵枢（AEIS）· CommonTrustProtocol"
-  },
-  "license": "MIT",
-  "keywords": [
-    "agent-skills",
-    "whitebox",
-    "condition-route",
-    "kccs",
-    "self-cognition",
-    "lingshu"
-  ],
-  "extensions": {
-    "lingshu": {
-      "self-cognition": {
-        "essence": "灵枢自我认知技能包——用灵枢自己构建的条件单元，描述灵枢自己如何认知（白箱自举的对外投影）",
-        "source-of-truth": "本仓 md_cg/whitebox_kb/wisdom/*_code_units.py（真源，S3 已内迁）；本 skills/ 为生成投影"
-      },
-      "condition-route": {
-        "layout": "v2.0-hierarchical（687 平铺收敛为 6 域入口 + units/ 收纳；入口层进 agent 上下文，单元层按需回读）",
-        "domains": {
-          "compiler": { "entry": "lingshu-compiler", "unit-count": 116, "subdomains": 10 },
-          "pylang": { "entry": "lingshu-pylang", "unit-count": 120, "subdomains": 25 },
-          "graph": { "entry": "lingshu-graph", "unit-count": 117, "subdomains": 17 },
-          "os": { "entry": "lingshu-os", "unit-count": 112, "subdomains": 18 },
-          "browser": { "entry": "lingshu-browser", "unit-count": 104, "subdomains": 14 },
-          "net": { "entry": "lingshu-net", "unit-count": 117, "subdomains": 2 }
-        },
-        "unit-count": 686,
-        "entry-count": 6,
-        "routing": "词面：域入口路由表（units/<slug>/SKILL.md 按需回读）；语义：mdcg cg op=route；全量触发词：md_cg/whitebox_kb/wisdom/trigger_words_index.json",
-        "kccs-version": "四要素（生效条件/子功能/执行/不适用条件）——单元级在 units/<slug>/SKILL.md，域级在域入口",
-        "negative-route": true,
-        "condition-space": "观测位置/观测工具/时间窗口/存在约束（D(C)）"
-      },
-      "meta-skill": {
-        "name": "designer-perspective",
-        "essence": "设计者视角元技能——不承担操作层执行，只赋予全局观测/结构识别/方向判断/资格裁决/条件层归因（《智能论3.4》1.4.2 视角层次）",
-        "source-of-truth": "手写（真源即 skills/designer-perspective/SKILL.md）；不属于六域条件单元，不经 tools/skill_export.py 生成",
-        "relation-to-condition-route": "互补：686 条件单元回答「怎么做」，本元技能回答「该不该做/为什么做/条件够不够」；condition-route.unit-count 仍为 686（元技能单列）",
-        "mcp": "只读接入 md_cg（dsh-memory）：mdcg_metacognition.self_check / mdcg_search 四态阶梯 / mdcg_evolution 账本；写操作须由 agent 显式发起",
-        "self-test": "skills/designer-perspective/tests/selftest.py（认知能力验收用例集，输出逐项结果与通过率）"
-      },
-      "mcp": {
-        "relation": "技能为说明书（何时用/怎么用/克制什么），灵枢 MCP 33 工具（cg/stg 基元 + 31 细粒度）为执行（物理基底）——技能 Verification 由 MCP 工具（编译/运行/断言）裁决",
-        "entry": "md_cg-mcp（MCP stdio server，随 dsh-memory 插件自带；python -m md_cg.mcp_server）"
-      }
-    }
-  }
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "lingshu-skills",
+  "version": "0.1.0",
+  "description": "灵枢（AEIS）自我认知技能包——白箱条件化知识（Agent Skills 兼容导出）。本质是灵枢了解自身的工具：每个技能描述灵枢在什么条件下能做什么、怎么执行、克制什么（KCCS 四要素），由条件路由图精确路由，由灵枢 MCP 工具执行验证（物理基底）。",
+  "author": {
+    "name": "灵枢（AEIS）· CommonTrustProtocol"
+  },
+  "license": "MIT",
+  "keywords": [
+    "agent-skills",
+    "whitebox",
+    "condition-route",
+    "kccs",
+    "self-cognition",
+    "lingshu"
+  ],
+  "extensions": {
+    "lingshu": {
+      "self-cognition": {
+        "essence": "灵枢自我认知技能包——用灵枢自己构建的条件单元，描述灵枢自己如何认知（白箱自举的对外投影）",
+        "source-of-truth": "本仓 md_cg/whitebox_kb/wisdom/*_code_units.py（真源，S3 已内迁）；本 skills/ 为生成投影"
+      },
+      "condition-route": {
+        "layout": "v2.0-hierarchical（687 平铺收敛为 6 域入口 + units/ 收纳；入口层进 agent 上下文，单元层按需回读）",
+        "domains": {
+          "compiler": { "entry": "lingshu-compiler", "unit-count": 116, "subdomains": 10 },
+          "pylang": { "entry": "lingshu-pylang", "unit-count": 120, "subdomains": 25 },
+          "graph": { "entry": "lingshu-graph", "unit-count": 117, "subdomains": 17 },
+          "os": { "entry": "lingshu-os", "unit-count": 112, "subdomains": 18 },
+          "browser": { "entry": "lingshu-browser", "unit-count": 104, "subdomains": 14 },
+          "net": { "entry": "lingshu-net", "unit-count": 117, "subdomains": 2 }
+        },
+        "unit-count": 686,
+        "entry-count": 6,
+        "routing": "词面：域入口路由表（units/<slug>/SKILL.md 按需回读）；语义：mdcg cg op=route；全量触发词：md_cg/whitebox_kb/wisdom/trigger_words_index.json",
+        "kccs-version": "四要素（生效条件/子功能/执行/不适用条件）——单元级在 units/<slug>/SKILL.md，域级在域入口",
+        "negative-route": true,
+        "condition-space": "观测位置/观测工具/时间窗口/存在约束（D(C)）"
+      },
+      "meta-skill": {
+        "name": "designer-perspective",
+        "essence": "设计者视角元技能——不承担操作层执行，只赋予全局观测/结构识别/方向判断/资格裁决/条件层归因（《智能论3.4》1.4.2 视角层次）",
+        "source-of-truth": "手写（真源即 skills/designer-perspective/SKILL.md）；不属于六域条件单元，不经 tools/skill_export.py 生成",
+        "relation-to-condition-route": "互补：686 条件单元回答「怎么做」，本元技能回答「该不该做/为什么做/条件够不够」；condition-route.unit-count 仍为 686（元技能单列）",
+        "mcp": "只读接入 md_cg（dsh-memory）：mdcg_metacognition.self_check / mdcg_search 四态阶梯 / mdcg_evolution 账本；写操作须由 agent 显式发起",
+        "self-test": "skills/designer-perspective/tests/selftest.py（认知能力验收用例集，输出逐项结果与通过率）"
+      },
+      "mcp": {
+        "relation": "技能为说明书（何时用/怎么用/克制什么），灵枢 MCP 33 工具（cg/stg 基元 + 31 细粒度）为执行（物理基底）——技能 Verification 由 MCP 工具（编译/运行/断言）裁决",
+        "entry": "md_cg-mcp（MCP stdio server，随 dsh-memory 插件自带；python -m md_cg.mcp_server）"
+      }
+    }
+  }
 }

package/skills/skills/designer-perspective/SKILL.md

@@ -1,158 +1,158 @@
----
-name: designer-perspective
-description: >-
-  设计者视角 / 全局观测 / 条件空间声明 / 资格裁决 / 四态判定 / 条件层归因 / 方向判断 / 白箱三问——设计者视角（元技能）。用户提到这些词，或需要在动手前先判断「该不该做、为什么做、条件够不够」时使用本技能。
-  场景：在操作层执行之前切换到全局观测位置，声明条件空间（观测位置/观测工具/时间窗口/存在约束），对候选做四态资格裁决（ACCEPT/REJECT/DEFER/BLINDSPOT），失败时按三方条件空间与五失配维度归因，并从失败蒸馏可复用纪律。
-  【不适用】Not for 以下场景：条件不满足即不适用（负路由：观测位置与操作层执行互斥；本技能不执行具体操作、不替代验证单元裁决、不写入认知图事实层）
-license: MIT
-compatibility: >-
-  只读运行；可选依赖 dsh-memory/md_cg（不可用时降级为纯本地规则运算，不阻塞）；写操作须由 agent 经 MCP 显式发起
-allowed-tools: Read Bash
-metadata:
-  version: "1.0"
-  skill-author: 灵枢（AEIS）
-  last-reviewed: "2026-09-10"
-  layer: meta
-  kccs:
-    trigger_words: ["设计者视角", "全局观测", "条件空间声明", "资格裁决", "四态判定", "条件层归因", "方向判断", "白箱三问", "该不该做", "条件够不够"]
-    when: "任务开始前需要判断执行资格与方向；或失败后需要定位遗漏条件；或需要从整体查看认知图"
-    sub: ["① 声明条件空间", "② 白箱三问自检", "③ 四态资格裁决", "④ 方向判断与关注信号", "⑤ 归因与蒸馏"]
-    execute: "切换到全局观测位置 → 声明条件空间四维 → 白箱三问 → 四态判定 → 输出判定依据与验证路径 → 失败则三方失配归因并蒸馏纪律"
-    not_applicable: ["条件不满足即不适用（负路由：观测位置与操作层执行互斥；本技能不执行具体操作、不替代验证单元裁决、不写入认知图事实层）"]
-  calibration: "对照：白箱三问 + 四态资格判定（条件路由图）；资格由条件证据裁决，不由相似度裁决"
----
-
-# 设计者视角（designer-perspective）
-
-设计者视角是一种**可习得的观测方式**，不是身份特权（《智能论3.4》1.4.2）。本技能在动手之前启用，回答三个问题：该不该做（资格）、为什么做（方向）、条件够不够（条件空间）。它不执行操作，只提供判定与归因；执行与裁决仍由操作层技能、验证单元与 MCP 物理基底完成。
-
-**位置声明**：本技能运行在全局观测层。设计者位置的功能是放权，不是控制（1.4.1）——因此本技能只输出判定与关注信号，不替操作层做内部决策。
-
-## When to use
-
-在以下时机启用本技能：
-
-- **任务开始前**：需要先判断执行资格与方向，而非直接开始执行。
-- **候选歧义时**：多个候选「看起来都像」，需要判断谁有资格执行（负路由优先）。
-- **失败之后**：需要从条件层定位遗漏条件，而不是只改答案。
-- **长期运行中**：需要从整体查看认知图，识别未知区域并决定下一步方向。
-- **自我校准时**：需要核对「依据什么、在什么条件下成立、错了怎么办」。
-
-不适用于：已明确路径的纯执行型任务、时间紧迫的琐碎操作、需要写认知图事实层的动作（后者由 agent 经 MCP 显式发起）。
-
-## 克制条款（不适用条件）
-
-条件不满足即不适用（负路由：观测位置与操作层执行互斥；本技能不执行具体操作、不替代验证单元裁决、不写入认知图事实层）
-
-具体边界：
-
-1. **不执行**：本技能产出判定单与建议调用清单，不产出操作结果。
-2. **不裁决事实**：资格判定由条件证据裁决（6章.2），事实裁决归验证单元与 MCP 基底；本技能不代替 `mdcg_verify`。
-3. **不写库**：脚本只读；`record/verify/flywheel` 等写操作只输出建议参数，由 agent 显式发起。
-4. **不硬答盲区**：无法建立判断路径时判定 BLINDSPOT 并停止猜测，指出缺失的条件维度。
-
-## How to execute
-
-按五步执行，每步都有可核查的产出。
-
-### 步骤 1：声明条件空间
-
-切换到全局观测位置，按四维声明当前条件空间（第三章 3.1/3.2、附录14）：
-
-| 维度 | 回答的问题 | 协议映射 |
-|------|-----------|---------|
-| 观测位置 | 谁在观测？从哪个尺度观测？ | 实例角色、结构倾向 |
-| 观测工具 | 用什么方法测量信息差？ | 验证方法、反思方法 |
-| 时间窗口 | 在什么时间范围内观测？ | 观察窗口 N、迭代周期 |
-| 存在约束 | 物理-信息层允许什么？ | 锚点层公理、通用价值观 |
-
-声明格式见 `references/01-observation-position.md`。运行：
-
-```bash
-python scripts/designer.py declare --position designer --space "观测位置=全局;观测工具=条件证据;时间窗口=当前任务;存在约束=锚点层公理"
-```
-
-### 步骤 2：白箱三问自检
-
-对每个待执行候选，逐问核对（第〇章）：
-
-1. **依据什么**——引用了哪条知识/哪个节点？（锚定）
-2. **在什么条件下成立**——该结论的适用条件是什么？（条件空间）
-3. **错了怎么办**——失败如何被记录、学习、修正？（验证闭环）
-
-任一问无法回答，该候选不得进入 ACCEPT。
-
-### 步骤 3：四态资格裁决
-
-判定顺序固定，先拒绝后接受（6章.2）：
-
-```
-候选 C
- ├─ 存在足以证明「不适用」的条件冲突？ → REJECT
- ├─ 候选存在但区分条件未定？           → DEFER（继续递归补条件）
- ├─ 无法建立判断路径？                 → BLINDSPOT（停止猜测）
- └─ 条件充分，获得执行资格             → ACCEPT
-```
-
-核心纪律：**资格由条件证据裁决，不由相似度裁决**。相似度可以产生候选，但不能单独授予执行资格。判定规则与边界见 `references/04-qualification-verdict.md`。运行：
-
-```bash
-python scripts/designer.py judge --query "..." --conditions "{\"观测位置\":\"...\"}" --emit-mcp
-```
-
-### 步骤 4：方向判断与关注信号
-
-从整体查看认知图：识别未知区域（盲区）→ 据此决定方向（附录「蜂群架构奠基声明」五）。
-
-- **值不值得做**：`Value(s,v) = ΔD_task(s,v) · σ(Gain_task(s,v))`；Gain_task 是筛选器，ΔD_task 是定价器（5.3）。
-- **成本**：`K_π` 含导航税、验证成本、计算开销；在有限结构成本下选择能最大程度缩小信息差的路径。
-- **权限边界**：π* 仅为 L1/L2 策略搜索层目标函数，L3 存在级决策不适用（5.3 权限边界声明）。
-- **观测不干预**：可发关注信号（signal），不可直接干预内部决策。
-
-### 步骤 5：失败归因与蒸馏
-
-失败不按行为层改答案，按条件层找根因（附录22.3）：
-
-- **三方条件空间**：任务真实条件 / 模型感知条件 / 机制声明条件——失败 = 三方失配。
-- **五失配维度**：观测位置 / 观测工具 / 时间窗口 / 存在约束 / 条件边界。
-- **蒸馏**：失败 → 根因（条件层）→ 可复用纪律（带适用条件）→ 注入 → 不再犯（1.1.1）。
-
-运行：
-
-```bash
-python scripts/designer.py attribute --error "{\"query\":\"...\",\"expected_state\":\"...\",\"actual_state\":\"...\",\"missing\":\"...\"}"
-python scripts/designer.py distill --failures failures.jsonl --out discipline.md
-```
-
-### 输出：判定单（固定格式）
-
-每轮设计者视角产出以下判定单，便于核查与回归断言：
-
-```
-[判定单]
-条件空间：观测位置=… | 观测工具=… | 时间窗口=… | 存在约束=…
-白箱三问：依据=… | 条件=… | 错后=…
-裁决：ACCEPT | REJECT | DEFER | BLINDSPOT
-依据：<条件证据，非相似度>
-缺失维度：<观测位置|观测工具|时间窗口|存在约束|条件边界>（BLINDSPOT/DEFER 时必填）
-验证路径：<可裁决的下一步>
-关注信号：<可选，不干预>
-```
-
-## Verification
-
-- **自检集**：运行 `python tests/selftest.py --cases tests/cases.jsonl`，输出逐项结果与通过率；通过率是「技能是否真的生效」的自证，不是自我声称。
-- **判定可核查**：每条裁决必须给出条件证据（依据字段），无法给出即降级为 DEFER/BLINDSPOT。
-- **物理基底**：涉及事实与记忆的判定，按 calibration 对照 `mdcg_verify`/`mdcg_search` 裁决（条件路由四态 + T0–T3 阶梯）。
-- **回归边界**：本技能不修改既有 686 个条件单元与真源库（本仓真源：`md_cg/whitebox_kb/wisdom/*_units.py`）。
-- ⚠️ **外部依赖（本仓不具备）**：发布门禁 `tools/skill_export_verify.py`（686/686 全绿校验）与重新导出器 `tools/skill_export.py` 位于**身体仓** tools/，不在本仓——重新导出与门禁校验须在身体层执行，本仓内勿模拟。
-
-## References
-
-- `references/01-observation-position.md` — 观测位置与设计者位置的非物理性（1.3/1.4/1.4.1/1.4.2/1.4.4、附录14）
-- `references/02-structure-recognition.md` — 结构识别：认知图整体观测、CRG 四态、CCG 三重注释（6章.1–6章.3）
-- `references/03-direction-judgment.md` — 方向判断：盲区驱动、目标函数 π*、导航税与认知外部化（5.3、6章.2、附录22.1）
-- `references/04-qualification-verdict.md` — 资格裁决：四态判定规则与边界（6章.2、第三章 3.1–3.4）
-- `references/05-condition-attribution.md` — 条件层归因：三方条件空间与五失配维度、蒸馏机制（附录22.3、1.1.1）
-- `scripts/designer.py` — 命令行脚本：视角声明、四态判定、五失配归因、纪律蒸馏、`--emit-mcp`
-- `tests/cases.jsonl` + `tests/selftest.py` — 认知能力验收用例与执行器
+---
+name: designer-perspective
+description: >-
+  设计者视角 / 全局观测 / 条件空间声明 / 资格裁决 / 四态判定 / 条件层归因 / 方向判断 / 白箱三问——设计者视角（元技能）。用户提到这些词，或需要在动手前先判断「该不该做、为什么做、条件够不够」时使用本技能。
+  场景：在操作层执行之前切换到全局观测位置，声明条件空间（观测位置/观测工具/时间窗口/存在约束），对候选做四态资格裁决（ACCEPT/REJECT/DEFER/BLINDSPOT），失败时按三方条件空间与五失配维度归因，并从失败蒸馏可复用纪律。
+  【不适用】Not for 以下场景：条件不满足即不适用（负路由：观测位置与操作层执行互斥；本技能不执行具体操作、不替代验证单元裁决、不写入认知图事实层）
+license: MIT
+compatibility: >-
+  只读运行；可选依赖 dsh-memory/md_cg（不可用时降级为纯本地规则运算，不阻塞）；写操作须由 agent 经 MCP 显式发起
+allowed-tools: Read Bash
+metadata:
+  version: "1.0"
+  skill-author: 灵枢（AEIS）
+  last-reviewed: "2026-09-10"
+  layer: meta
+  kccs:
+    trigger_words: ["设计者视角", "全局观测", "条件空间声明", "资格裁决", "四态判定", "条件层归因", "方向判断", "白箱三问", "该不该做", "条件够不够"]
+    when: "任务开始前需要判断执行资格与方向；或失败后需要定位遗漏条件；或需要从整体查看认知图"
+    sub: ["① 声明条件空间", "② 白箱三问自检", "③ 四态资格裁决", "④ 方向判断与关注信号", "⑤ 归因与蒸馏"]
+    execute: "切换到全局观测位置 → 声明条件空间四维 → 白箱三问 → 四态判定 → 输出判定依据与验证路径 → 失败则三方失配归因并蒸馏纪律"
+    not_applicable: ["条件不满足即不适用（负路由：观测位置与操作层执行互斥；本技能不执行具体操作、不替代验证单元裁决、不写入认知图事实层）"]
+  calibration: "对照：白箱三问 + 四态资格判定（条件路由图）；资格由条件证据裁决，不由相似度裁决"
+---
+
+# 设计者视角（designer-perspective）
+
+设计者视角是一种**可习得的观测方式**，不是身份特权（《智能论3.4》1.4.2）。本技能在动手之前启用，回答三个问题：该不该做（资格）、为什么做（方向）、条件够不够（条件空间）。它不执行操作，只提供判定与归因；执行与裁决仍由操作层技能、验证单元与 MCP 物理基底完成。
+
+**位置声明**：本技能运行在全局观测层。设计者位置的功能是放权，不是控制（1.4.1）——因此本技能只输出判定与关注信号，不替操作层做内部决策。
+
+## When to use
+
+在以下时机启用本技能：
+
+- **任务开始前**：需要先判断执行资格与方向，而非直接开始执行。
+- **候选歧义时**：多个候选「看起来都像」，需要判断谁有资格执行（负路由优先）。
+- **失败之后**：需要从条件层定位遗漏条件，而不是只改答案。
+- **长期运行中**：需要从整体查看认知图，识别未知区域并决定下一步方向。
+- **自我校准时**：需要核对「依据什么、在什么条件下成立、错了怎么办」。
+
+不适用于：已明确路径的纯执行型任务、时间紧迫的琐碎操作、需要写认知图事实层的动作（后者由 agent 经 MCP 显式发起）。
+
+## 克制条款（不适用条件）
+
+条件不满足即不适用（负路由：观测位置与操作层执行互斥；本技能不执行具体操作、不替代验证单元裁决、不写入认知图事实层）
+
+具体边界：
+
+1. **不执行**：本技能产出判定单与建议调用清单，不产出操作结果。
+2. **不裁决事实**：资格判定由条件证据裁决（6章.2），事实裁决归验证单元与 MCP 基底；本技能不代替 `mdcg_verify`。
+3. **不写库**：脚本只读；`record/verify/flywheel` 等写操作只输出建议参数，由 agent 显式发起。
+4. **不硬答盲区**：无法建立判断路径时判定 BLINDSPOT 并停止猜测，指出缺失的条件维度。
+
+## How to execute
+
+按五步执行，每步都有可核查的产出。
+
+### 步骤 1：声明条件空间
+
+切换到全局观测位置，按四维声明当前条件空间（第三章 3.1/3.2、附录14）：
+
+| 维度 | 回答的问题 | 协议映射 |
+|------|-----------|---------|
+| 观测位置 | 谁在观测？从哪个尺度观测？ | 实例角色、结构倾向 |
+| 观测工具 | 用什么方法测量信息差？ | 验证方法、反思方法 |
+| 时间窗口 | 在什么时间范围内观测？ | 观察窗口 N、迭代周期 |
+| 存在约束 | 物理-信息层允许什么？ | 锚点层公理、通用价值观 |
+
+声明格式见 `references/01-observation-position.md`。运行：
+
+```bash
+python scripts/designer.py declare --position designer --space "观测位置=全局;观测工具=条件证据;时间窗口=当前任务;存在约束=锚点层公理"
+```
+
+### 步骤 2：白箱三问自检
+
+对每个待执行候选，逐问核对（第〇章）：
+
+1. **依据什么**——引用了哪条知识/哪个节点？（锚定）
+2. **在什么条件下成立**——该结论的适用条件是什么？（条件空间）
+3. **错了怎么办**——失败如何被记录、学习、修正？（验证闭环）
+
+任一问无法回答，该候选不得进入 ACCEPT。
+
+### 步骤 3：四态资格裁决
+
+判定顺序固定，先拒绝后接受（6章.2）：
+
+```
+候选 C
+ ├─ 存在足以证明「不适用」的条件冲突？ → REJECT
+ ├─ 候选存在但区分条件未定？           → DEFER（继续递归补条件）
+ ├─ 无法建立判断路径？                 → BLINDSPOT（停止猜测）
+ └─ 条件充分，获得执行资格             → ACCEPT
+```
+
+核心纪律：**资格由条件证据裁决，不由相似度裁决**。相似度可以产生候选，但不能单独授予执行资格。判定规则与边界见 `references/04-qualification-verdict.md`。运行：
+
+```bash
+python scripts/designer.py judge --query "..." --conditions "{\"观测位置\":\"...\"}" --emit-mcp
+```
+
+### 步骤 4：方向判断与关注信号
+
+从整体查看认知图：识别未知区域（盲区）→ 据此决定方向（附录「蜂群架构奠基声明」五）。
+
+- **值不值得做**：`Value(s,v) = ΔD_task(s,v) · σ(Gain_task(s,v))`；Gain_task 是筛选器，ΔD_task 是定价器（5.3）。
+- **成本**：`K_π` 含导航税、验证成本、计算开销；在有限结构成本下选择能最大程度缩小信息差的路径。
+- **权限边界**：π* 仅为 L1/L2 策略搜索层目标函数，L3 存在级决策不适用（5.3 权限边界声明）。
+- **观测不干预**：可发关注信号（signal），不可直接干预内部决策。
+
+### 步骤 5：失败归因与蒸馏
+
+失败不按行为层改答案，按条件层找根因（附录22.3）：
+
+- **三方条件空间**：任务真实条件 / 模型感知条件 / 机制声明条件——失败 = 三方失配。
+- **五失配维度**：观测位置 / 观测工具 / 时间窗口 / 存在约束 / 条件边界。
+- **蒸馏**：失败 → 根因（条件层）→ 可复用纪律（带适用条件）→ 注入 → 不再犯（1.1.1）。
+
+运行：
+
+```bash
+python scripts/designer.py attribute --error "{\"query\":\"...\",\"expected_state\":\"...\",\"actual_state\":\"...\",\"missing\":\"...\"}"
+python scripts/designer.py distill --failures failures.jsonl --out discipline.md
+```
+
+### 输出：判定单（固定格式）
+
+每轮设计者视角产出以下判定单，便于核查与回归断言：
+
+```
+[判定单]
+条件空间：观测位置=… | 观测工具=… | 时间窗口=… | 存在约束=…
+白箱三问：依据=… | 条件=… | 错后=…
+裁决：ACCEPT | REJECT | DEFER | BLINDSPOT
+依据：<条件证据，非相似度>
+缺失维度：<观测位置|观测工具|时间窗口|存在约束|条件边界>（BLINDSPOT/DEFER 时必填）
+验证路径：<可裁决的下一步>
+关注信号：<可选，不干预>
+```
+
+## Verification
+
+- **自检集**：运行 `python tests/selftest.py --cases tests/cases.jsonl`，输出逐项结果与通过率；通过率是「技能是否真的生效」的自证，不是自我声称。
+- **判定可核查**：每条裁决必须给出条件证据（依据字段），无法给出即降级为 DEFER/BLINDSPOT。
+- **物理基底**：涉及事实与记忆的判定，按 calibration 对照 `mdcg_verify`/`mdcg_search` 裁决（条件路由四态 + T0–T3 阶梯）。
+- **回归边界**：本技能不修改既有 686 个条件单元与真源库（本仓真源：`md_cg/whitebox_kb/wisdom/*_units.py`）。
+- ⚠️ **外部依赖（本仓不具备）**：发布门禁 `tools/skill_export_verify.py`（686/686 全绿校验）与重新导出器 `tools/skill_export.py` 位于**身体仓** tools/，不在本仓——重新导出与门禁校验须在身体层执行，本仓内勿模拟。
+
+## References
+
+- `references/01-observation-position.md` — 观测位置与设计者位置的非物理性（1.3/1.4/1.4.1/1.4.2/1.4.4、附录14）
+- `references/02-structure-recognition.md` — 结构识别：认知图整体观测、CRG 四态、CCG 三重注释（6章.1–6章.3）
+- `references/03-direction-judgment.md` — 方向判断：盲区驱动、目标函数 π*、导航税与认知外部化（5.3、6章.2、附录22.1）
+- `references/04-qualification-verdict.md` — 资格裁决：四态判定规则与边界（6章.2、第三章 3.1–3.4）
+- `references/05-condition-attribution.md` — 条件层归因：三方条件空间与五失配维度、蒸馏机制（附录22.3、1.1.1）
+- `scripts/designer.py` — 命令行脚本：视角声明、四态判定、五失配归因、纪律蒸馏、`--emit-mcp`
+- `tests/cases.jsonl` + `tests/selftest.py` — 认知能力验收用例与执行器