hetu-altas

hetu-hammurabi

Name: hetu-hammurabi
Author: hetu-altas

hetu 系列「宪章编程」harness 模块。通过 dsh和opencode 的 Commands / Agents / Skills / Plugins 将研发流程固化为可自动执行的节点流水线：输入任务书路径或一句话需求，自动完成任务书生成(按需) → 分析 → 编码 → 单元测试（硬门禁）→ 代码评审 → 研发日志 → 资产沉淀 → 钉钉通知。

Stars: 1
Language: Python
Created: Aug 2, 2026
Updated: Aug 16, 2026

Workspace Skills

GitHub repo

Introduction

hetu-hammurabi

河出图，洛出书，圣人则之。

上古伏羲氏时，龙马负图出于黄河，是为河图——宇宙秩序的原始图谱，万物规律的终极抽象。它不是律法本身，却是律法得以成文的元秩序。

而在幼发拉底河畔，汉谟拉比（Hammurabi）将散落的习俗与裁决铭刻于玄武岩石柱，颁布了人类历史上第一部成文法典——《汉谟拉比法典》。法律自此不再寄居于君王的记忆，而是立于石上，人人可见，人人可循。他立法，亦执法：法度之内，万物有序；法度之外，寸步难行。

当东方的秩序图谱遇见西方的立法者，便有了 河图·汉谟拉比——宪章编程的驭具模块。

它将散落的宪章铸成法典，为模型的每一次行为划定边界；把研发流程镌刻为一道工序流水，令每个节点有据可依；以硬门禁执法，不容侥幸，不随心意。它不写业务代码，却让每一行业务代码都行于法度之内；它不产出数据，却让每一次研发沉淀为可循的成卷之律。

不作预测，不言涨跌，只做模型最忠实的立法者。

hetu 系列「宪章编程」harness 模块。将研发流程固化为可自动执行的节点流水线：输入任务书路径或一句话需求，自动完成任务书生成(按需) → 分析 → 编码 → 单元测试（硬门禁）→ 代码评审 → 研发日志 → 资产沉淀 → 钉钉通知。

两种执行载体：

DSH（主推）：一体化插件包 @hetu-altas/ConstitutionCoding-Plugin——GUI 内 /cc 命令、tools/pre-execute 硬门禁、看板原生面板、右侧流程状态栏、看板服务随 DSH 自启；npx @deepseek-ai/dsh plugin --profile web add ./plugins/constitution-coding 一条命令安装
opencode（兼容）：命令已同步更名 /cc，流程保留可用

宪章编程 · 核心理念

人是立法者，AI是执行者。 我们的角色不是"告诉AI做什么"，而是"定义AI不能做什么"。立法者定义边界，执行者在边界内行动。

宪法高于对话。 一次对话的效力，随着上下文窗口的关闭而消散；一部宪法的效力，随着项目的存续而持续生效。聊出来的叫"感觉"，写进宪法的叫"规矩"。

约束是资产，不是负担。 一次宪章的修正，触发所有 AI 产出物的自动合规。约束不是限制创造力的枷锁，而是让创造力规模化复制的模具。

先立法，后编码。 用宪章约束，而非用提示语修补——不要治一个 Bug，要治一类 Bug；不要纠正一个违规，要杜绝一类违规。

—— 摘引自《宪章编程宣言》

氛围程序员问："AI，你能做什么？" 宪章程序员说："AI，在我的规矩里，你只能这么做。"

生态定位

开源 harness + 国产模型：行政机构与执行官员均可替换，唯宪法不灭。

执行载体：基于开源 agent harness 构建——主推 DeepSeek Harness（DSH）（一体化插件包 plugins/constitution-coding/），兼容 opencode（≥ 1.16，旧流程保留）
模型：兼容国产模型（DeepSeek、Qwen、GLM、Kimi 等），通过 harness 的 provider 配置接入，无需改宪章
架构解耦：宪章（constitution/）与模型、harness 完全解耦——换 harness 只迁移编排层，换模型只改 provider 配置，宪章零改动
呼应《宪章编程宣言》信条四："工具可以换，模型可以换，宪法不灭，系统永生。"

开源适配（部署前必读）

仓库内所有路径均为相对路径约定，部署时按你的实际目录布局调整：

需自行调整的项	当前约定	说明
共享 venv	`../venv-hetu/bin/python`	约定共享 venv 与各项目同父目录；不同布局请替换 `.opencode/` 与 `constitution/` 中的引用
日志根目录	`../logs/hetu-altas/`	约定日志根与各项目同父目录（见 `constitution/log/log.md`）
公共工具项目	`../hetu-aether/`（示例名）	编码/测试/通知节点引用公共工具项目，改名请同步替换 `.opencode/` 中的引用
业务项目名	`hetu-mercury` / `hetu-thoth`（示例名）	资源地图（`docs/资源地图.md`）与宪章中的示例项目名，按实际替换

提示：hetu-aether/mercury/thoth 为河图体系的示例命名，可整体保留或替换为你自己的项目命名。

目录结构

.
├── .opencode/
│   ├── commands/
│   │   └── cc.md                     # /cc 入口命令（cc = constitution coding，任务书路径 或 一句话需求）
│   ├── agents/
│   │   ├── charter-orchestrator.md    # 主编排代理（primary，节点 -1~7 调度）
│   │   ├── charter-taskwriter.md      # 节点-1 任务书生成（一句话需求）
│   │   ├── charter-analyst.md         # 节点1 分析 → 实施计划
│   │   ├── charter-coder.md           # 节点2 编码
│   │   ├── charter-tester.md          # 节点3 单元测试（硬门禁）
│   │   ├── charter-reviewer.md        # 节点4 代码评审（APPROVE/REVISE）
│   │   ├── charter-logger.md          # 节点5 研发日志
│   │   ├── charter-assetter.md        # 节点6 资产沉淀（docs 新增/更新）
│   │   └── charter-notifier.md        # 节点7 钉钉通知
│   ├── skills/
│   │   ├── charter-taskbook/SKILL.md  # 需求→任务书生成
│   │   ├── charter-analysis/SKILL.md  # 资源匹配（接口/DDL/参考代码）
│   │   ├── charter-coding/SKILL.md    # 编码宪章（引用 coding.md）
│   │   ├── charter-testing/SKILL.md   # 单测宪章（引用 unit_test.md）
│   │   ├── charter-logging/SKILL.md   # 研发日志规范
│   │   └── charter-assets/SKILL.md    # 资产沉淀（新增/更新判定）
│   └── plugin/
│       └── charter-gate.ts            # 硬约束插件（测试门禁/数据安全/密钥脱敏/资产登记）
├── constitution/                      # 通用宪章规范（唯一权威，各项目不再各自维护）
│   ├── constitution.md                # 顶层宪法（13 章）
│   └── coding/ unit_test/ log/ project/ tdengine/ milvus/ task_split/   # 子规范
├── docs/hetu-aether|mercury|thoth/    # 归集自各项目的文档
├── scripts/
│   └── install_harness.sh             # 软链 harness 到同级 hetu-* 项目
├── templates/
│   └── task_book.md                   # 任务书模板
├── plugins/
│   └── constitution-coding/           # DSH 一体化插件包 @hetu-altas/ConstitutionCoding-Plugin
│       ├── src/command.js             #   /cc 命令（GUI 钩子）
│       ├── src/gate.js                #   tools/pre-execute 硬门禁
│       ├── src/status-api.js          #   数据通道（/dashboard + /api/hetu-dashboard）
│       ├── src/dashboard-launcher.js  #   看板服务随 DSH 自启
│       └── client.js                  #   看板原生面板 + 右侧流程状态栏
└── docs/dsh-docs/                     # DSH 官方开发文档离线镜像（82 页）

快速开始

体系完整说明文档见 docs/harness/；新手上路先看《快速上手指南》。

方式一：DSH（推荐）

安装一体化插件包（含 /cc 命令、硬门禁、看板面板、状态栏、看板自启）：

cd hetu-hammurabi
npx @deepseek-ai/dsh plugin --profile web add ./plugins/constitution-coding

启动 DSH（看板数据服务 8790 自动拉起）：

npx @deepseek-ai/dsh web --port 3090

在 GUI 输入框执行：

/cc <任务书路径 或 一句话需求>

方式二：opencode（兼容路径）

bash scripts/install_harness.sh      # 安装旧 harness 到业务项目
# 业务项目内启动 opencode，执行 /cc <任务书路径 或 一句话需求>（命令已更名，constitution coding）

任务书编写前按 constitution/task_split/task_split.md 评估任务粒度：超限（> 4000 行）任务先按依赖拆分。编排代理会自动按节点执行并在任务目录 opencode_schedule/<YYYYMMDD>/<任务目录>/研发流程状态.md 固化每个节点的状态。

流程节点

触发方式：DSH 下 /cc <任务书路径或一句话需求>；opencode 下 /cc ...（命令已同步更名）。

节点	代理	产出	门禁
-1 任务书生成	charter-taskwriter	`任务N<名称>.md`	仅一句话需求时执行
0 校验	charter-orchestrator	任务书/宪章/输出目录确认	-
1 分析	charter-analyst	`实施计划.md`	-
2 编码	charter-coder	源码/脚本/依赖	-
3 单元测试	charter-tester	`unit_test/test_*_result.txt` + `.gate.json`	硬门禁：必须全部通过并写入 `.gate.json`，失败回节点2，最多3轮
4 代码评审	charter-reviewer	`评审报告.md`	APPROVE 才放行，REVISE 回节点2，最多2轮
5 研发日志	charter-logger	`任务N研发日志.md`	仅当节点3、4通过（charter-gate 硬拦截）
6 资产沉淀	charter-assetter	`docs/hetu-<项目>/**` 新增/更新	仅当节点3、4通过
7 通知	charter-notifier	钉钉完成通知	仅当节点3、4通过（charter-gate 硬拦截）

每个任务的中间产物按任务书建目录归档，同日多任务互不干扰：

opencode_schedule/<YYYYMMDD>/
└── <YYYYMMDD>任务N<名称>/          # 任务目录（以任务书名去掉 .md 命名）
    ├── <YYYYMMDD>任务N<名称>.md    # 任务书（输入，或节点-1 生成）
    ├── 实施计划.md                  # 节点1
    ├── .gate.json                   # 节点3（硬门禁状态）
    ├── 评审报告.md                  # 节点4
    ├── 任务N研发日志.md             # 节点5
    └── 研发流程状态.md              # 全流程（编排器维护）

硬约束（charter-gate）

DSH 下由插件包 src/gate.js 挂载于 tools/pre-execute（机器拦截）；opencode 下由 .opencode/plugin/charter-gate.ts 提供。4 项硬约束：

测试门禁：.gate.json 缺失或 test_passed=false 时，写入（write/edit/apply_patch 或 bash 重定向）研发日志/流程状态、钉钉通知 bash 调用一律被阻断；读取不受限
数据安全：rm -rf / DROP / DELETE FROM / TRUNCATE / drop_collection 必须显式带 backup/备份
密钥脱敏：用户消息中的明文凭据（sk-、Bearer、token/password 等）自动脱敏并告警
资产登记一致性：docs/hetu-*/ 新增/修改未登记到 docs/资源地图.md 时告警

维护

宪章内容修改后，对应 Skill 直接引用 constitution/ 下的源文件，无需改动。
DSH 插件：功能拆分见 plugins/constitution-coding/（command/gate/status-api/dashboard-launcher/client）；修改后重启 dsh web 生效。
新增流程节点：在 harness/agents/ 新增子代理并更新 harness/workflow.yaml 流程定义。
修改硬约束：DSH 下编辑 plugins/constitution-coding/src/gate.js（tools/pre-execute 返回 deny）；opencode 下编辑 .opencode/plugin/charter-gate.ts。

开源协议

本项目基于 MIT License 开源（LICENSE），商用无任何限制：

✅ 自由使用、复制、修改、合并、发布、再分发、出售
✅ 商用、闭源使用均允许，无需付费或署名以外的附加义务
✅ 唯一的义务：保留版权声明与本许可声明（随分发附上 LICENSE 即可）
❌ 本软件按"原样"提供，作者不对使用后果承担任何责任（免责条款见 LICENSE）

联系邮箱：hetu_altas@163.com

hetu-hammurabi

Introduction

hetu-hammurabi

宪章编程 · 核心理念

生态定位

开源适配（部署前必读）

目录结构

快速开始

方式一：DSH（推荐）

方式二：opencode（兼容路径）

流程节点

产出目录（任务目录）

硬约束（charter-gate）

维护

开源协议