一个
/king命令,解决一个项目文件夹的所有事。 把"开新项目"变成一条命令 + 一次交互:自动判模式、交互配置、生成完整骨架(AGENTS.md + 真向量知识库 + MoE 专家路由 + 梦境系统 + Obsidian)。
为 ZCode(也兼容 Claude Code / Codex 等 AGENTS.md 驱动的 agent)设计。
- 5 专业模式 + 主副叠加:日常办公 / 代码开发 / 设计创意 / 专业领域 / 特级助理。一个主模式 + 最多 2 个副模式,覆盖跨域项目。
- 40 内置专家 + 1000 外部:每模式 8 个 MIT 许可的精选专家(开箱即用),另指向 agency-agents(237) + claude-skills(763) 共 1000 个按需克隆。
- 交互式向导:不堆料——模式判定 → 专家勾选 → 向量库选型 → 子系统开关,只问相关问题。
- 真向量知识库:transformers.js + bge-small-zh(本地零成本),无依赖时退化 FTS5。
- 梦境系统:离线记忆整理——扫记忆 → 聚类模式 → 生成 insight → 喂回 MoE 路由。不耗工作 token。
- Obsidian 集成:跨项目检索 + 双链笔记,vault-agnostic。
- 99% 缓存命中:AGENTS.md 稳定前缀 + 模式细节外移 + top-k ≤3 专家激活。
- clean-room 合规:内置专家均来自 MIT 开源库,溯源见
references/experts/PROVENANCE.md。
# 1. 安装(克隆到 ZCode skills 目录)
git clone https://github.com/zhangsugang/king-skill ~/.zcode/skills/king
# 2. 在空目录里跑
cd ~/Documents/我的新项目
/king "做一个温柔风格的情绪陪伴 bot"king 会交互式问你:模式确认 → 副模式 → 专家来源 → 向量库 → 梦境/Obsidian 开关,然后生成完整骨架。
# 真向量检索(默认 FTS5 零依赖,装了这个用真向量)
npm i @xenova/transformers| 模式 | 代号 | 主轴 | git | 梦境 | Obsidian |
|---|---|---|---|---|---|
| 日常办公 | OFFICE | 文档/邮件/会议/汇报 | ❌ | ✅ | ✅ |
| 代码开发 | DEV | 软件工程全栈 | ✅必选 | ❌默认 | 可选 |
| 设计创意 | DESIGN | UI/UX/文案/品牌 | 可选 | ✅ | ✅ |
| 专业领域 | PROFESSIONAL | 金融/投资/医学/法律 | 可选 | ✅ | ✅必选 |
| 特级助理 | ASSISTANT | 雇主职业+拓展+生活 | ❌ | ✅ | ✅ |
每个模式有独立的配置手册(references/MODE_*.md)和 AGENTS 模板(TEMPLATES/AGENTS-*.md.template)。
我的新项目/
├── AGENTS.md # 稳定前缀(模式身份 + 专家路由 + 硬底线)
├── docs/
│ ├── PROJECT_OVERVIEW.md # ⭐ 项目全貌
│ ├── EXPERT_ROUTING.md # MoE 路由表
│ ├── SKILL_CATALOG.md
│ └── CACHE_OPTIMIZATION_PLAYBOOK.md
├── memory/ # 双层记忆 · 第一层(markdown)
│ ├── mistakes.md # 踩坑(追加式)
│ ├── decisions.md # 决策(ADR)
│ ├── glossary.md # 术语
│ ├── procedures.md # 程序性记忆(梦境产出)
│ └── insights/ # 梦境 insight 笔记
├── knowledge/ # 双层记忆 · 第二层(向量库)
│ ├── embed.config.json # embedding 配置
│ ├── query.mjs # FTS5 检索
│ ├── embed-query.mjs # 真向量检索
│ ├── seed/ # 领域种子
│ └── lancedb/ # 索引数据
├── obsidian-vault/ # (可选)Obsidian 知识库
│ ├── daily/ # 每日笔记
│ └── templates/
├── scripts/
│ └── dream.mjs # 梦境系统
└── .zcode/skills/<slug>/ # 项目专属工作流
| 脚本 | 作用 |
|---|---|
scripts/init-knowledge.mjs |
知识库初始化(FTS5 + embed.config + insights 目录) |
scripts/embed-query.mjs |
语义检索(transformers 优先 / FTS5 退化) |
scripts/dream.mjs |
梦境系统(离线记忆整理 → insight + procedures) |
scripts/setup-obsidian.mjs |
Obsidian vault 初始化 + 软链总库 |
scripts/select-experts.mjs |
专家选择辅助(--mode=DEV --role=核心 --json) |
king 的 PROFESSIONAL 模式(金融/法律/医学)输出均为知识辅助与文档审查,不构成专业执业意见:
- 金融/投资:非投资建议,风险自负
- 法律:不替代持牌律师,输出带「待律师复核」
- 医学:不提供诊断/治疗建议,健康问题咨询执业医师
本仓库代码(脚本、模板、配置)为原创,可自由使用。
内置的 40 个专家均来自 MIT 许可的开源社区仓库,溯源见 references/experts/PROVENANCE.md:
本 skill 的设计吸收了以下最佳实践:
- Anthropic Agent Skills(渐进式披露)
- Letta / MemGPT(分层记忆)
- Auto-Dreamer(离线巩固 / 梦境)
- obsidian-second-brain(vault-agnostic 集成)
- AGENTS.md 开放标准
🔧 移植一个,验证一个,沉淀一个 —— 让 agent 长出专家的肌肉,但不丢自己的骨头。