合乎周礼 (zhouli)

☯ 合乎周礼

惟王建国，辨方正位，体国经野，设官分职，以为民极。

——《周礼》

以《周礼》六官之道，审视每一次代码操作。

一个 Claude Code 插件，将中国古代《周礼》的治理智慧映射到现代软件工程实践。每次代码变更后，自动给出文言风格的判词——合礼、失礼、或大逆不道。

效果预览

☯  合乎周礼 ──────────────────────────
判定： 合礼 ✅
所据： 冬官考工记（营造之道）——「天有时，地有气，材有美，工有巧。合此四者，然后可以为良。」
判词： 循法度而造器，百工之事各有所归。代码结构清晰，工具使用得当，如良工合天时地利材巧于一器。
──────────────────────────────────────

☯  合乎周礼 ──────────────────────────
判定： 失礼 ⚠️
所据： 地官司徒（教化之道）——「以乡三物教万民而宾兴之。」
判词： 名不正则言不顺，言不顺则事不成。变量命名含混，建议用更准确的名字让代码"自解释"。
──────────────────────────────────────

☯  合乎周礼 ──────────────────────────
判定： 大逆不道 ❌
所据： 秋官司寇（刑法之道）——「乃立秋官司寇，使帅其属而掌邦禁，以佐王刑邦国。」
判词： 密钥明文硬编于源码，门户洞开、引贼入室。必须立刻移到环境变量或密钥管理服务中。
──────────────────────────────────────

六官之道

《周礼》以六官分掌天下之事，本插件将其映射为软件工程的六个审视维度：

周礼六官	原典	工程之道	审视范围
天官冢宰	掌邦治，以佐王均邦国	治理之道	架构设计、职责分离、模块划分
地官司徒	掌邦教，以佐王安扰邦国	教化之道	可读性、命名规范、代码自解释
春官宗伯	掌邦礼，以佐王和邦国	礼仪之道	编码规范、格式约定、API 契约
夏官司马	掌邦政，以佐王平邦国	征伐之道	性能优化、资源效率、算法复杂度
秋官司寇	掌邦禁，以佐王刑邦国	刑法之道	安全防护、错误处理、边界校验
冬官考工记	天有时，地有气，材有美，工有巧	营造之道	工程实践、工具链、构建流程

安装

一行命令，即装即用：

claude plugins marketplace add yuezengwu/zhouli && claude plugins install zhouli@zhouli

重启 Claude Code 会话即可生效。

卸载

claude plugins uninstall zhouli@zhouli
claude plugins marketplace remove zhouli

判定标准

判定	含义
合礼 ✅	操作遵循最佳实践，代码清晰规范，架构合理
失礼 ⚠️	有不当之处但不严重——命名欠佳、轻微冗余、缺少注释
大逆不道 ❌	严重违反工程实践——安全漏洞、架构破坏、数据丢失风险

特色

• 古籍为据 ：判定引用《周礼》原典，每条判词皆有出处
• 文白兼备 ：文言判词 + 白话解释，雅俗共赏，人人可懂
• 自动判定 ：无需手动调用，每次实质性操作后自动给出判词
• 六维审视 ：从架构到安全，覆盖软件工程核心关注点
• 先行谏言 ：对不合理的请求，在执行前直言进谏
• 极简实现 ：单个 SessionStart hook，零依赖，即装即用

项目结构

zhouli/
├── .claude-plugin/
│   └── marketplace.json          # Marketplace 清单
├── plugins/
│   └── zhouli/
│       ├── .claude-plugin/
│       │   └── plugin.json       # 插件清单
│       ├── hooks/
│       │   └── hooks.json        # Hook 配置
│       └── hooks-handlers/
│           └── session-start.sh  # 六官审视指令注入
├── LICENSE
└── README.md

许可证

MIT