PLUGIN & MCP · 调度全景

5 个项目 · 2 种形态
4 种调度方式

4 种 =　Hook 确定性拦截　·　Skill 语义触发　·　MCP 工具 按需调用　·　Slash 人工命令

每个 plugin / MCP 是做什么的，以及它在你写代码时——由什么触发、何时介入、怎么接力。

🧩 3 插件 + 2 MCP 实例🛡️ 6 道 Hook🧠 35 Skill🔌 1 引擎 2 实例

这页讲清楚

这张图只回答两件事

① 每个是做什么的

3 个插件 + 2 个 MCP 实例，各自的职责边界。先用「形态」给它们定调。

② 如何被调度的

运行时谁来决定「现在该谁上」——Hook / Skill / MCP 工具 / Slash 四种触发逻辑。

理解了这四种调度方式，整套体系就不再是黑盒。

先分清两种交付形态

Plugin 与 MCP：装进 Claude Code 的两种方式

形态一Claude Code 插件

用 /plugin install 安装。内部装两种东西：Skill（给 AI 的行为指引）+ Hook（挂在工具生命周期的确定性脚本）。

team-standards 团队开发规范
project-coding-profiles 项目编码画像
yoooni-daily-plugin Yoooni 日常工具箱（含一键安装）

形态二MCP 服务

用 claude mcp add 注册常驻进程（stdio），对外暴露一组工具。AI 需要时主动调用、按需取数，不灌满上下文。

domain-knowledge 业务公共认知库
cross-topology 跨项目拓扑库
两者共用同一引擎、两个实例

核心

四种调度方式 · 谁决定「现在该谁上」

即 Hook 钩子（确定性·机械拦截）　Skill 技能（语义·LLM 判断）　MCP 工具（按需·Agent 主动调）　Slash 命令（人工·用户显式）四种

确定性

🛡️ Hook

运行时调度·与 LLM 无关

PreToolUse 工具调用前按 matcher 自动跑，可放行/警告/硬阻断。绕不过的防护栏。

语义

🧠 Skill

LLM 按 description 判断

把你的意图和技能描述比对，命中就加载这份「作业手册」。无需敲命令。

按需

📚 MCP 工具

Agent 主动调用

需要业务/拓扑认知时主动查。渐进披露：search→get→related。

人工

⌨️ Slash

用户显式输入 /命令

你主动敲的 /命令（如 /plugin install）：最确定（敲啥执行啥、无歧义），但用得最少——日常你大多是自然语言提需求（那是触发 Skill / 让 AI 调 MCP，不算 Slash）。多用于安装注册等一次性动作。

第 4 页详解

四种调度的生命周期：何时载入、何时触发

① 起点 · 人发起

⌨️ Slash / 需求

用户键入 /命令 或直接打字提需求——整件事的触发源，人指挥 AI。

→

② 加载期 · 会话就位

🧠 Skill 描述 · 📚 MCP 工具表

AI 上下文里已就位：每个技能"何时用"的描述 + 可调外部工具清单。Hook 则由宿主从 hooks.json 注册，AI 看不见。

→

③ 干活 · 按需触发

🧠 翻手册 · 📚 取数据

命中意图 → 载入该 Skill 全文照做；需要业务/拓扑 → 主动调 MCP（先 search 摘要、再 get 正文）。

→

④ 落地前 · 拦截

🛡️ Hook 安检

AI 每次"即将 Write/Edit/Bash" → 宿主在落盘前自动跑 hook：放行 / 警告 / exit 2 阻断。绕不过。

🛡️ Hook 凭什么能自动拦？ 真正写文件 / 跑命令的是宿主（Claude Code/Codex），不是模型——模型只发"工具调用请求"，宿主才实际执行，它卡在每次工具调用的咽喉，故能在执行前插一脚（大脑发令、手上装安检，绕不过）。
拦截时机＝PreToolUse：模型请求 Write/Edit/Bash → 宿主在真正落盘/执行前，把入参(路径/内容/命令)喂给 hook → 退出码 2＝拦下(动作不发生、提示回灌让模型改)、0＝放行。(PostToolUse 只能事后补救，能"拦"的只有执行前的 PreToolUse)

调度

何时载入（就位）

何时触发（起作用）

谁决定

🧠 Skill 技能

会话开始：只载入"有哪些技能 + 各管啥"的描述

对话命中 description → 载入该技能全文按它执行

LLM 语义

📚 MCP 工具

连接后：外部工具清单（名+schema）进可用表

AI 判断需要外部数据 → 主动调用、按需取

Agent 主动

🛡️ Hook 钩子

宿主启动：从 hooks.json 注册，AI 不感知

AI 每次"即将执行工具" → 宿主自动安检/拦截

运行时·确定性

⌨️ Slash 命令

命令清单在宿主注册，用户可见

用户显式键入 /命令（或直接提需求）

人

🔗 关系链：人(Slash/需求) ▶ Skill 领路 ▶ MCP 供料 ▶ AI 产出 ▶ Hook 把关 ▶ 落地。Skill/MCP 是 AI 主动（按语义、按需），Slash 人发起、Hook 被动拦截。⚠️ Hook 不是"AI 记得自己的禁区"——AI 事前并不知道，是宿主在动作落地前替它把关，所以绕不过。

第 5 页详解 · Hook 拆解

Hook 的触发与判定：绑定 → 喂数据 → 看退出码

🛡️ 触发时序：宿主启动读 hooks.json 登记 → 模型请求 Bash / Write → 命中 matcher → 执行前 spawn 脚本、stdin 喂 JSON（命令/路径/内容）→ 脚本判定 → exit 2 拦 / exit 0 放

// ① 触发：hooks.json —— 把「事件+工具」绑到脚本，宿主启动时登记进事件表 "PreToolUse": [{ "matcher": "Bash", // 哪类工具调用前拦（Bash / Write|Edit…） "hooks": [{ "command": "node …/check-commit-no-ai-signature.js" }] }] // ② 判定：脚本核心 —— 拿宿主喂来的命令，套「写死的正则」算真假（非 AI，确定性） const cmd = payload.tool_input.command; // 宿主 stdin 喂来的 git commit 全文 if (!/\bgit\b.*\bcommit\b/i.test(cmd)) process.exit(0); // 不是 commit → 放行 const 命中 = /(^|\n)\s*co-authored-by:.*\b(claude|anthropic)\b/i.test(cmd) // 署名行指向 AI || /🤖|noreply@anthropic\.com/i.test(cmd); // 机器人 emoji / 机器邮箱 process.exit(命中 ? 2 : 0); // 命中 → exit 2 拦截；否则 exit 0 放行

▶ 命中示例：提交信息结尾带 Co-Authored-By: Claude <noreply@anthropic.com> → 正则命中 → exit 2，commit 被拦，stderr 提示回灌、让模型删署名重提。
⚖️ 判定是确定性死规则（正则/布尔，不是模型理解）：同输入永远同结果。规则写得越紧越少误判（正文普通提 "claude" 不命中）；留 =warn / off 旁路兜底。

拟人化总览 · 用人话理解

把它想成：一个超级员工 + 老板下令 + 技能点 + 外部资料库 + 安检

🦸 超级员工＝ AI 本体

手快、不知疲倦、什么都肯干——但要「武装」(技能 / 资料)才靠谱，要「约束」(安检)才放心。下面四个角色围着他转：

👔 老板（你）

＝ Slash 命令

下达需求「做这个 / 改那个」——一切的起点，人发号施令。

🎯 技能点

＝ Skill

员工内化的本领 / 招式书：先知道「我会哪些招」，命中场景就放对应招（先设计、按规范…）。

📚 外部资料库

＝ MCP

随时打电话查的资料库 / 外援专家：业务真理、DDL、跨项目地图，缺料就查、不瞎编。

🛡️ 安检 / 纪委

＝ Hook

不在员工身上，是公司装在流程上的关卡：他每次「交付 / 动手」前都要过安检，不合规当场拦、绕不过。

🎬 老板下令(Slash) ▶ 超级员工凭技能点(Skill)干活、缺料就查外部资料库(MCP) ▶ 每次交付前过公司安检(Hook) ▶ 放行才落地。技能点 / 外援是「他自己」的延伸（主动用）；安检是「公司」的外挂（被动拦、确定性）。

逐个项目 · 做什么 + 怎么调度

⚖️ team-standards 插件

26 skills + 6 hooks

团队通用「流程监理 + 编码规范」：先设计后编码、规范提交、知识沉淀，覆盖研发全流程。

HOOKPreToolUse·Bash（2 道）：check-git-commit-skill（提交规范检查）、check-commit-no-ai-signature（AI 署名拦截）

HOOKPreToolUse·Write|Edit（4 道）：check-design-doc（设计文档检查）、check-backend-kg-readiness（知识图谱预读）、check-comment-density（注释红线）、check-sql-ddl-readiness（写 SQL 前核对 DDL）

SKILL语义触发 26 个，如：design-doc-required（先出设计文档）、coding-standards-common（通用编码规范）、git-commit-standards（提交规范）、daily-work-log（工作日志）…

Hook 支持 warn / block / off 环境变量调档

📌 几个真实例子（问题 → 因 → 解）

🔴 做「打版进度展示染厂收胚时间」，AI 直接改 Morder.xml，方向反复（先 Revert 又重做）
🔍 没先理清取数口径/坐标就动手
✅ design-doc-required 先出设计、定位坐标再写

🔴 提交打版进度改动时被自动加 Co-Authored-By: Claude 署名
🔍 宿主默认指令擅自追加
✅ check-commit-no-ai-signature 落盘前机械拦下

🔴 把「染厂收胚时间」误取 transfer.tdate（应为 checkdate）
🔍 写 SQL 前没核对 DDL/字段口径
✅ check-sql-ddl-readiness 改 SQL 前必读 DDL 基线

规则怎么落地 · 先 warn 后 block

不一上来就拦：warn 先行，用命中数据决定升不升 block

同事最反感「一改代码就被硬拦」。所以新规则默认 warn（只提示、放行），命中时悄悄记一笔，攒一段数据再决定要不要升 block——拦不拦，用数字说话。

① warn 命中

team-standards / coding-profiles

4 道 warn hook 命中即放行，同时本地记一行——只写本地、绝不阻断编辑。

→

② 落本地

~/.kai-toolbox/hook-events.jsonl

ts/user/rule/mode/tool/file，best-effort，失败也不影响放行/拦截。

→

③ 汇聚

\\IT01\版本更新\vibecoding

计划任务 / SessionStart 顺手同步，每人一文件、无写冲突。

→

④ 周报定夺

yoooni-hook-report

聚合出命中排行 / warn-block 占比 → 用数据决定升不升 block。

📊 周报出什么

规则命中 Top · 谁命中最多 · warn vs block · 按 hook / 插件。命中量大且集中 → 真痛点，可升 block；分散且多为一次性 → 疑似误报，先优化判定。

🎛️ 一键调档

每条规则三档：warn（默认提示）/ block（硬拦）/ off（关）。环境变量即时切，无需改代码。

把「拦不拦」从拍脑袋变成 数据驱动：先观察、再收紧——同事更买账，规则也更准。

逐个项目 · 做什么 + 怎么调度

🧷 project-coding-profiles 插件

2 skills + 2 hooks

项目专属「编码画像」：GBK/UTF-8 编码守护、前端控件红线、新模块脚手架。仅在登记过画像的项目内生效。

HOOKPreToolUse·Write|Edit → check-file-encoding（编码守护）：防 GBK 存量被 UTF-8 重存致乱码

HOOK写 WebRoot/**.{jsp,js} → check-frontend-controls（前端控件红线）：拦原生 alert/confirm/prompt

SKILLencoding-guard（编码守护指引：GBK↔UTF-8 回环）、module-scaffold（新模块脚手架：说"加个模块"自动生成骨架）

仅当 profile.json 的 rootMarkers 命中、且只查本次新增内容才触发

📌 几个真实例子（问题 → 因 → 解）

🔴 改打版工艺单上传的 jsp/Action，中文变乱码、编译不过
🔍 Yoooni 源码是 GBK，AI 默认按 UTF-8 写盘
✅ check-file-encoding+encoding-guard GBK↔UTF-8 安全回环

🔴 打版进度页面弹窗用了原生 alert/confirm
🔍 AI 不知 Yoooni 前端控件红线
✅ check-frontend-controls 拦原生弹窗、强制公共控件

🔴 加「打版工艺单批量文件上传」，从 Action 到 jsp 手写一堆样板
🔍 没有项目专属脚手架
✅ module-scaffold 一句「加个模块」生成纵向切片

逐个项目 · 两个 MCP

业务认知 + 跨项目拓扑（同一引擎）

📖 domain-knowledge

project-domain-knowledge · MCP

业务公共认知：计价/状态/流程/规则。「换代码重写也成立」的业务真理。

调度：Agent 按需 → search_knowledge → get_knowledge → get_related；reload_knowledge 热加载

🗺️ cross-topology

cross-project-topology · 复用同一 server.js

跨项目拓扑：调用链 / 数据流 / 接口契约 / 服务依赖。「当前怎么连」的实现级地图。

工具集与 domain-knowledge 完全一致；靠 DOMAIN_KB_DIR 指向本仓库知识根

📌 几个真实例子（问题 → 因 → 解）

🔴 写打版进度取数，不知「配送染厂/染厂收胚」各取哪个时间字段
🔍 业务口径散在人脑/口头，没集中
✅ domain-knowledge 自助查：makedate=配送、checkdate=收胚

🔴 改打版进度牵动 develop→织造收货→调拨入仓 多处，不知影响面
🔍 跨模块/单据关联没人记录
✅ cross-topology 查调用链/影响面

🔴「染厂收胚=checkdate」口径每人各记一份、易漂移
🔍 没有集中权威源
✅ 集中 PDK：场景卡「打版送染厂调拨关联」+ DDL 基线，全员同步

逐个项目 · 日常工具箱

🧰 yoooni-daily-plugin 插件

7 skills

Yoooni 日常工具箱：新人入职、本地启动、生产日志排查。也是整套体系的「总开关」。

SKILL语义触发：「我是新人怎么开始」「启动 Yoooni」「查生产日志」「装公司工具」…

SLASHyoooni-install-team-tools：一键拉取+构建+注册前面四件套（team-standards / coding-profiles / domain-knowledge / cross-topology）

它们怎么接力 · 让 AI 改一个「面料计价」功能

调度时序（上半场）

1

SKILL你说「改一下计价逻辑」

design-doc-required 自动介入：先别写码，产出设计文档、定位代码坐标。

2

MCPAI 查业务真理

调 domain-knowledge：search("计价") → 取「计价口径」「成本构成」，不用你逐条口述。

3

MCPAI 查跨项目链路

调 cross-topology：看计价涉及哪些项目/接口，改动会牵动谁。

4

HOOK即将写代码（拦截关卡）

PreToolUse·Write 触发多道 hook：设计文档？读过知识图谱？GBK 会乱码？前端用了原生弹窗？不合规 → 阻断。

它们怎么接力

调度时序（下半场）

5

SKILL按规矩落代码

coding-standards-common + encoding-guard：分层、GBK 编码回环、命名规范。

6

HOOK提交时再设一关

PreToolUse·Bash → check-git-commit-skill：大改没走提交规范 skill 就拦下。

7

SKILL沉淀

daily-work-log 记日志；新业务规则回写 domain-knowledge 即时生效——下次别人直接复用。

🔑 Skill 先把你拉进流程 → MCP 喂认知 → Hook 每次落盘/提交把关 → Skill 收尾沉淀。Hook 不讲情面（确定性阻断），Skill/MCP 灵活（按语义和需要）。

这套东西怎么装起来的

注册接线 · 一个引擎，跑两个 MCP 实例

# 在 Claude Code 里说一句「安装公司团队工具」→ yoooni-install-team-tools skill 启动 # 全程脚本(install-team-tools.ps1)自动执行 —— 无需手敲；已装的自动跳过(更新走「更新公司套件」skill) git clone 缺失的 4 个仓(已存在则跳过，不重复 clone) cd project-domain-knowledge && npm install && npm run build # 构建唯一引擎 claude mcp add domain-knowledge -e DOMAIN_KB_DIR=.../knowledge '--' node .../dist/server.js # 实例① claude mcp add cross-topology -e DOMAIN_KB_DIR=.../knowledge '--' node .../dist/server.js # 实例②(同引擎) claude plugin marketplace add https://gitee.com/wyoooni/team-standards.git # 注册市场(来源) claude plugin install team-standards@team-standards # 从市场装(脚本代敲，不用 slash) claude plugin marketplace add https://gitee.com/wyoooni/project-coding-profiles.git claude plugin install project-coding-profiles@project-coding-profiles

✅ 全自动：claude mcp add（2 个 MCP 实例）+ claude plugin install（2 个插件）一把梭，幂等——已装的自动跳过、不重装。MCP 必须 clone（跑本地 dist/server.js + knowledge）；插件不 clone，走市场由 Claude Code 自取。
🔁 唯一人工：第一次装 yoooni-daily-plugin 那一下；装完插件重启会话生效。更新别重跑安装——交给「更新公司套件」skill。
⚠️ 两个坑：PowerShell 里 '--' 要带引号（否则变参 -e 吞掉 node 路径报错）；插件名须带 @marketplace 全限定（裸名 not found）。

🔌 domain-knowledge

引擎指向 project-domain-knowledge/knowledge · 业务真理（稳定少改）

🔌 cross-topology

同引擎 + DOMAIN_KB_DIR 指向 cross-project-topology/knowledge · 拓扑（随代码变）

一句话收尾

四种调度各司其职：
Hook 把关、Skill 领路、MCP 供料、Slash 启动。
你只管提需求，装备自动各就各位。

        Hook 确定性阻断
        Skill 语义领路
        MCP 按需供料
        Slash 人工启动
      

尾页 · 落地即自动维护

装一个插件，全套自己保鲜

① 一次安装

yoooni-daily-plugin

一次 marketplace add + install，从此它当"管家"。

→

② 开会话即刷

SessionStart hook

每天后台 git pull + 必要时重建 MCP 仓 + claude plugin update 自动更新插件，不阻塞会话。

→

③ 会话外也刷

Windows 计划任务

每 4 小时自动同步 MCP + 插件，Claude Code 没开也保持最新。

→

④ 插件有新版

自动更新 · 重启生效

marketplace update + plugin update 自动跑完，重启会话即加载新版。

✅ MCP 层 = 全自动

业务知识 / DDL / 引擎跑本地文件，git pull + 重建即最新，零操作。

✅ 插件层 = 全自动

走 claude plugin CLI（marketplace update + update）脚本代跑，更新后重启会话生效，不再需要手敲 slash。

规范、知识、套件——装一次，之后自己保持最新。
人只管提需求，工具自己进化。

5 个项目 · 2 种形态4 种调度方式

这张图只回答两件事

① 每个是做什么的

② 如何被调度的

Plugin 与 MCP：装进 Claude Code 的两种方式

形态一Claude Code 插件

形态二MCP 服务

四种调度方式 · 谁决定「现在该谁上」

确定性

语义

按需

人工

四种调度的生命周期：何时载入、何时触发

Hook 的触发与判定：绑定 → 喂数据 → 看退出码

把它想成：一个超级员工 + 老板下令 + 技能点 + 外部资料库 + 安检

👔 老板（你）

🎯 技能点

📚 外部资料库

🛡️ 安检 / 纪委

不一上来就拦：warn 先行，用命中数据决定升不升 block

📊 周报出什么

🎛️ 一键调档

业务认知 + 跨项目拓扑（同一引擎）

📖 domain-knowledge

🗺️ cross-topology

调度时序（上半场）

SKILL你说「改一下计价逻辑」

MCPAI 查业务真理

MCPAI 查跨项目链路

HOOK即将写代码（拦截关卡）

调度时序（下半场）

SKILL按规矩落代码

HOOK提交时再设一关

SKILL沉淀

注册接线 · 一个引擎，跑两个 MCP 实例

装一个插件，全套自己保鲜

✅ MCP 层 = 全自动

✅ 插件层 = 全自动

5 个项目 · 2 种形态
4 种调度方式