Codewhale 文档

查找准确的使用说明。

从新手指引和安装开始,或直接查看名词、模式、权限、工具、提供商、Fleet、钩子、MCP 与运行时 API。每页都链接到仓库中的源文档。

宪章与 /constitution Constitution

Codewhale 先给 Agent 一个可追责的地址,再给上下文冲突一套法律。/constitution 是管理个人常驻宪章的主入口: 它把结构化的用户全局设置保存在 $CODEWHALE_HOME/constitution.json, 再渲染成模型可读的 prose block。仓库仍可通过 .codewhale/constitution.json 增加本地 law;runtime policy 独立负责模式、审批、沙箱、成本和工具边界。

User-global 用户全局

用 /constitution 管理跨项目个人常驻法。它是结构化数据渲染成 prose,不是裸 prompt 编辑器。

Repo-local 仓库本地

.codewhale/constitution.json 是可选项目 law,用于不变量、分支规则、验证和升级条件。

Runtime 运行时

宪章文本可以表达偏好;审批、沙箱、Shell、网络、信任和 MCP 权限仍由运行时配置强制执行。

普通项目说明仍放在 AGENTS.md;记忆和交接低于宪章与项目说明;完整 base prompt Markdown 覆盖只是专家逃生口,不是普通设置路径。详见 配置文档

来源文档:docs/ARCHITECTURE.md · 更新时请同步修改 docs-map.ts。