Skip to content

lzpp2598/sansheng-cursor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

⚔️ 三省六部制 for Cursor

用 1300 年前的帝国制度,在 Cursor IDE 中实现 Multi-Agent 分权协作。

将唐代三省六部的分权制衡思想,移植到 Cursor 的 Custom Agents 体系中——11 个专职 Agent 各司其职,通过严格的状态机流转和看板追踪,完成复杂任务的规划、审议、派发与执行。

致谢

本项目灵感来源于 cft0808/edict(⭐ 11k+)——一个基于 OpenClaw 平台的三省六部 Multi-Agent 编排系统,配备完整的军机处看板、奏折归档、模型热切换等功能。

edict 项目定义了三省六部的核心理念:太子分拣 → 中书省规划 → 门下省审议 → 尚书省派发 → 六部执行。本项目将这套架构适配到 Cursor IDE 中,利用 Cursor 的 Custom Agents 和 Skills 机制,让你在编辑器内就能体验分权协作的 AI 工作流。

架构

                    ┌──────────────────────────────┐
                    │       👑 你(皇上)            │
                    │       在 Cursor 中下旨         │
                    └──────────────┬───────────────┘
                                  │
                    ┌─────────────▼───────────────┐
                    │      👑 太子 (taizi)          │
                    │  分拣:闲聊直接回 / 旨意建任务  │
                    └─────────────┬───────────────┘
                                  │
                    ┌─────────────▼───────────────┐
                    │    📜 中书省 (zhongshu)       │
                    │   接旨 → 规划 → 拆解子任务     │
                    └─────────────┬───────────────┘
                                  │
                    ┌─────────────▼───────────────┐
                    │    🔍 门下省 (menxia)         │
                    │   审议方案 → 准奏 / 封驳      │
                    └─────────────┬───────────────┘
                                  │ 准奏 ✅
                    ┌─────────────▼───────────────┐
                    │    📮 尚书省 (shangshu)       │
                    │   派发任务 → 协调六部          │
                    └─┬────┬────┬────┬────┬────┬─┘
                      │    │    │    │    │    │
                 ┌────▼─┐┌─▼──┐┌─▼──┐┌─▼──┐┌─▼──┐┌─▼──┐
                 │💰户部 ││📝礼部││⚔️兵部││⚖️刑部││🔧工部││📋吏部│
                 │ 数据  ││ 文档 ││ 运维 ││ 质量 ││ 开发 ││ 人事 │
                 └──────┘└────┘└────┘└────┘└────┘└────┘

各省部职责

部门 Agent ID 职责
👑 太子 taizi 消息分拣——闲聊直接回复,复杂任务创建 JJC 工单转交中书省
📜 中书省 zhongshu 接旨规划——需求分析、方案设计、子任务拆解,提交门下省审议
🔍 门下省 menxia 审议把关——从可行性/完整性/风险/资源四维度审核,准奏或封驳
📮 尚书省 shangshu 执行调度——接收准奏方案,确定涉及部门,派发并汇总结果
🔧 工部 gongbu 功能开发、架构设计、代码实现、重构优化
⚔️ 兵部 bingbu 基础设施、部署运维、CI/CD、性能监控、安全防御
💰 户部 hubu 数据分析、统计报表、资源管理、成本核算
📝 礼部 libu 文档撰写、规范制定、UI/UX 文案、对外沟通
⚖️ 刑部 xingbu 代码审查、测试验收、Bug 定位、合规审计
📋 吏部 libu-hr Agent 管理、技能培训、考核评估、协作规范
🌅 早朝官 zaochao 全球新闻采集、每日简报生成

任务状态流转

Pending → Taizi → Zhongshu → Menxia → Assigned → Doing → Review → Done
                     ↑           │
                     └── 封驳 ───┘

所有状态转换受状态机校验保护,非法跳转会被拒绝。门下省封驳最多 3 轮,第 3 轮强制准奏。

项目结构

.cursor/
├── agents/                          # 11 个 Agent 角色定义
│   ├── taizi.md                     # 太子 · 消息分拣
│   ├── zhongshu.md                  # 中书省 · 规划决策
│   ├── menxia.md                    # 门下省 · 审议把关
│   ├── shangshu.md                  # 尚书省 · 执行调度
│   ├── gongbu.md                    # 工部 · 工程实现
│   ├── bingbu.md                    # 兵部 · 基础设施
│   ├── hubu.md                      # 户部 · 数据资源
│   ├── libu.md                      # 礼部 · 文档规范
│   ├── xingbu.md                    # 刑部 · 质量合规
│   ├── libu-hr.md                   # 吏部 · 人事管理
│   └── zaochao.md                   # 早朝官 · 新闻简报
└── skills/
    ├── kanban/
    │   └── SKILL.md                 # 看板操作指南
    └── sansheng-dispatch/
        ├── SKILL.md                 # 任务调度系统(触发条件 + 完整流程)
        ├── workflow.md              # 详细流转规则(状态机 + 权限矩阵)
        └── scripts/
            └── kanban.py            # 看板 CLI 工具(纯 Python,零依赖)

运行时数据自动存储在 .sansheng/tasks.json(已 gitignore)。

使用方法

前置条件

  • Cursor IDE
  • Python 3.9+(用于看板脚本)

安装

最简单的方式——直接在 Cursor 中对 AI 说:

帮我安装三省六部制:https://github.com/lzpp2598/sansheng-cursor

或者下载 zip 压缩包后丢给 Cursor,让它帮你完成安装。

安装位置

三省六部制支持两种安装方式:

方式 路径 作用范围 适用场景
项目级 <项目>/.cursor/ 仅当前项目 想在特定项目中使用
全局级 ~/.cursor/ 所有项目 想在所有项目中都能用

手动安装:

git clone https://github.com/lzpp2598/sansheng-cursor.git

# 项目级:只在当前项目生效
cp -r sansheng-cursor/.cursor /path/to/your-project/.cursor

# 全局级:所有项目都能用
cp -r sansheng-cursor/.cursor/agents/* ~/.cursor/agents/
cp -r sansheng-cursor/.cursor/skills/* ~/.cursor/skills/

使用

最简单的方式——直接在 Cursor 中说"传旨":

传旨:帮我设计一个用户注册系统,要求 FastAPI + PostgreSQL + JWT + 完整测试

系统会自动识别"传旨"指令并启动三省六部流程。你也可以通过 @taizi 等方式直接与特定 Agent 交互。

完整流程:

  1. 太子判定为旨意,创建 JJC 任务
  2. 中书省起草执行方案,拆解子任务
  3. 门下省审议方案(可能封驳要求修改)
  4. 尚书省确定涉及部门,派发任务
  5. 六部并行执行(工部写代码、刑部写测试、礼部写文档……)
  6. 汇总结果回奏

查看任务

python3 .cursor/skills/sansheng-dispatch/scripts/kanban.py list

与 edict 的区别

edict 本项目
平台 OpenClaw Cursor IDE
看板 军机处 Web 看板(React 前端 + Python 后端) CLI 看板(kanban.py
Agent 定义 SOUL.md + OpenClaw 配置 Cursor Custom Agents(.cursor/agents/*.md
技能系统 OpenClaw Skills + 远程 Skills Hub Cursor Skills(.cursor/skills/
适用场景 独立部署的 Multi-Agent 平台 在 Cursor 中编码时的 AI 协作
依赖 OpenClaw + Docker + Node.js Cursor + Python 3.9+

简而言之:edict 是完整的 Multi-Agent 平台方案,本项目是轻量级的 Cursor 编辑器插件方案——把三省六部的核心理念带进你的日常编码工作流。

自定义

修改 Agent

编辑 .cursor/agents/<agent-id>.md 即可调整任何 Agent 的职责、专业领域和语气风格。

添加新 Agent

.cursor/agents/ 下创建新的 .md 文件,参照现有 Agent 的 frontmatter 格式:

---
name: your-agent
description: >-
  Agent 的简短描述。
---

数据存储

任务数据默认存储在项目根目录的 .sansheng/tasks.json。可通过环境变量 SANSHENG_DATA_DIR 自定义路径。

License

MIT


以古制御新技,以智慧驾驭 AI。

About

⚔️ 三省六部制 for Cursor — 用唐代分权制衡架构实现 Multi-Agent 协作,11 个专职 AI Agent 在 Cursor IDE 中各司其职

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages