Skip to content

zhangsugang/king-skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

👑 king — 5 模式交互式项目脚手架

一个 /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

📂 5 模式速查

模式 代号 主轴 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

⚖️ 免责声明(PROFESSIONAL 模式)

king 的 PROFESSIONAL 模式(金融/法律/医学)输出均为知识辅助与文档审查,不构成专业执业意见

  • 金融/投资:非投资建议,风险自负
  • 法律:不替代持牌律师,输出带「待律师复核」
  • 医学:不提供诊断/治疗建议,健康问题咨询执业医师

📜 许可证

本仓库代码(脚本、模板、配置)为原创,可自由使用。 内置的 40 个专家均来自 MIT 许可的开源社区仓库,溯源见 references/experts/PROVENANCE.md


🙏 致谢

本 skill 的设计吸收了以下最佳实践:


🔧 移植一个,验证一个,沉淀一个 —— 让 agent 长出专家的肌肉,但不丢自己的骨头。

About

king skill — ZCode 项目脚手架:MoE 路由 + 99% 缓存命中率 + 双层记忆库

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors