用途:为项目建立和维护“项目宪法”(constitution)与 AI 智能体指令文件,统一编码标准、项目规则和智能体行为指引;附带支持 RFC/ADR 文档,用于正式化技术决策。
主要能力:创建宪法(默认写入 oak/constitution.md 或 .constitution.md);创建与同步智能体指令文件;用 RFC 模板创建、列出、校验、查看、采纳或废弃 RFC。
使用方式:创建宪法时先分析项目,再生成 oak/constitution.md,细节见 references/constitution-guide.md。智能体文件用 oak rules detect-existing 发现所有已配置的指令文件,加 --json 可输出机器可读结果;用 oak rules sync-agents 把宪法引用同步到所有智能体文件,加 --dry-run 可预览将检查/更新的文件。关键原则是不要猜测智能体文件名,必须先用 detect-existing 动态发现,只创建输出中标记为未找到的文件,路径照抄输出。新增规则时先写入宪法,再用 sync-agents 同步,绝不能只改智能体文件。RFC 命令:oak rfc create --title "..." --template <type>、oak rfc list、oak rfc validate <path>、oak rfc show <path>、oak rfc adopt <path>、oak rfc abandon <path> --reason "...";模板类型有 feature、architecture、engineering、process。
适用场景:新项目建立宪法;为新项目创建智能体指令文件;发现应标准化的模式后补规则;宪法变更后同步;用 RFC 记录技术决策。
限制与要求:宪法需显式、可执行并有锚点,必含元数据、范围与非目标、含锚点索引的黄金路径、架构不变量、无魔法字面量、CLI 行为、质量门禁等章节;规则用 RFC 2119 的 MUST/SHOULD/MAY 表述。需避免“使用最佳实践”“尽可能”“自行合理假设”等不可执行写法。其他具体限制暂未提供。