DEMIURGOS:AI 编码代理统一规则系统
代码生成 AI 代理常常输出不一致的结果,忽略项目特定要求。解决方案是 DEMIURGOS,一个自动创建并维护团队所有编码代理统一规则集的系统。
DEMIURGOS 架构:三层控制机制
DEMIURGOS 基于三层架构构建,确保灵活性同时避免冗余。
- 核心层 (.rules/):项目规则的集中源头。定义技术栈、编码规范、架构模式和约束条件。
- 原生适配器:针对特定 AI 代理的轻量级核心规则投影。例如,Cursor 用 .cursor/rules/*.mdc,Claude Code 用 CLAUDE.md,GitHub Copilot 用 .github/copilot-instructions.md。规则不重复——适配器直接引用核心。
- 扩展层:针对复杂场景的可选层,如多代理系统或 MCP(模型上下文协议)集成。只在真正需要时创建。
实际应用:多技术栈示例
该系统在各种技术环境中表现出色,通过调试模式发现规则缺失。
Godot 4.3 + GDScript 游戏开发
构建生命值组件时,代理遵循规则生成类型化代码,使用节点组合和信号。调试模式(/debug full)揭示缺失:
- 输入动作命名约定缺失(如 player_dash)。
- 缺少将技能与 UI 通过 cooldown_started 信号关联的规则。
- 建议用 Timer 节点替换 SceneTreeTimer 以支持暂停功能。
Python 后端 + 异步 SQLAlchemy
为订单 API,代理应用三层架构规则、自定义异常和批量查询。调试发现:
- 路由器中缺少异常到 HTTP 状态码的映射。
- 缺少使用 SELECT FOR UPDATE 处理竞态条件的规则。
- 服务层 flush() 与路由层 commit() 的职责分离不清晰。
Astro + SolidJS 前端
构建主题切换时,代理严格遵守 Islands 架构和 UnoCSS 规则。缺失包括:
- 缺少通过内联 <head> 脚本防止 FOUC 的策略。
- 浏览器 API 缺少通用 try/catch。
- 状态管理中 createSignal 与 createStore 的选择不明确。
实施 DEMIURGOS 的核心优势
采用此规则系统为开发团队带来显著收益。
- 代码一致性:所有 AI 代理遵循相同标准,减少审查和重构时间。
- 快速上手:新开发者通过 git 获取规则,其代理立即生成符合团队规范的代码。
- 持续优化:调试模式(/debug)在 10–20 次提示后发现规则缺失,优先修复。常见领域:
- 游戏项目中的设计约定。
- 后端业务逻辑和事务。
- 前端浏览器 API 边缘 case 和无障碍访问。
- 支持 22+ 工具:一套核心规则通过适配器投影到 Cursor、Windsurf、Claude Code、GitHub Copilot、Kiro、JetBrains AI Assistant 等。
- 低开销:规则作为仓库文件存在,无需额外基础设施或复杂配置。
核心要点
- DEMIURGOS 用集中规则解决 AI 代理缺少项目上下文的问题。
- 三层架构实现灵活性,避免代码重复。
- 调试模式发现规则缺失,支持持续优化。
- 支持 22+ 开发工具,实现团队一致性。
- 实施后减少代理管理时间,提升代码质量。
— Editorial Team
暂无评论。