这个项目能做什么
Eric 的工程宪法是一个可复用框架,作为人类与 AI agent 在软件项目中协作方式的唯一事实来源。它被设计为以只读 `constitution/` 子模块的形式拉入任意 Git 仓库,与少量本地项目文件分层叠加,并由 AI 编码 agent 和 CI 流水线共同强制执行。
该仓库包含权威治理文档(CONSTITUTION.md、AI_WORKFLOW.md、INTEGRATION.md、TESTING.md、DOCUMENTATION.md、SECURITY.md、OPERATIONS.md、ARCHITECTURE.md、RELEASES.md、TODO_GUIDELINES.md、KNOWLEDGE_SOURCES.md)、25 个内置 agent 技能(自主执行宪法规则),以及一整套在 CI 中验证合规性的参考检查脚本。这些检查器覆盖:跨供应商文件(AGENTS.md、CLAUDE.md、.cursorrules 等)的指令模板一致性、技能元数据有效性、需求到测试的可追溯性、OTS 软件清单交叉核对、架构依赖规则(确保源代码依赖按依赖规则向内指向)、版本与发布标签对齐、文档与 wiki 新鲜度、wiki 链接完整性、密钥扫描,以及指令权重测量。
引导脚本(`scripts/bootstrap.sh`)通过添加子模块、创建缺失的治理文件并生成采用报告来初始化现有仓库。它通过 `--agents` 标志(claude、cursor、copilot、goose、openhands、antigravity、continue、aider、generic、all)支持可选的 agent 指令文件,默认使用 AGENTS.md。该脚本默认从不覆盖现有文件,而是将模板副本放入 `.constitution-bootstrap/templates/` 供手动合并。它还会在 README 中添加标准化的采用徽章,并通过标记进行管理以避免重复。
该框架包含以下模板:拉取请求完成清单、CODEOWNERS、CI 工作流门禁(SHA 固定)、用于 Visual Studio 中 GitHub Copilot 的 Solon 自定义 agent,以及产品需求、里程碑待办列表、会话计划、OTS 软件清单、wiki 首页和事件事后复盘的文档模板。它还提供一个 MCP 服务器,将宪法文档和来源作为资源暴露,并提供知识来源工作流,用于将书籍和文章提炼为 `sources/` 下可供 agent 使用的摘要。
IDE 集成是自动的:在 Visual Studio、VS Code 或 JetBrains IDE 中打开已引导的仓库,AI 助手(GitHub Copilot、Continue.dev、Cursor)即可读取已提交的指令文件,这些文件指向 constitution 子模块。Claude Code 中的 SessionStart 钩子会立即标记过期的子模块。该框架自身的 CI 在每次拉取请求和推送到 main 时运行完整测试套件以及自我治理检查器,并且有一个发布标签对齐工作流守护版本标签。
该项目包含关于集成、版本管理(当前为 1.48.0)的详尽文档,以及一个完整示例项目布局。它被定位为治理层而非代码库,强调有纪律、可度量的 AI 辅助开发实践。
评论
0 评分人数达到10人后显示
登录后参与讨论。