GitHub - shelltdf/ai_rules_template

AI Rules Template

这是一个基于 Cursor Rules 驱动的项目模板,用于沉淀并执行一套“自动化 AI 软件工程规则”。

项目目标

  • 用规则约束 AI 在项目中的行为(文档、代码、同步流程)。
  • 建立从概念到实现再到运维的可追溯工程链路。
  • 支持同一需求的多实现并存(多语言/多框架)。
  • 强制文档与实现持续对齐,降低“文档失真”。

核心思路

  • ai-software-engineering/ 作为四阶段工程文档主线:
    • 00-concept:概念设计
    • 01-logic:逻辑设计
    • 02-physical:物理规格(实现单一事实来源)
    • 03-ops:运维与发布
  • 以仓库根下或用户指定的文档目录外子目录承载多实现代码子项目(例如本仓库的 cpp/;具体路径以各实现 README.md 为准)。
  • 通过 .cursor/rules/ 下的规则文件,统一规范初始化、同步、边界与多实现生成流程。

适用场景

  • 想把 AI 作为“规则化工程协作者”而不是一次性代码生成器。
  • 需要在一个仓库中维护多语言实现并保持行为一致。
  • 需要可审计、可演进的软件工程知识沉淀。

使用说明(简版)

  1. .cursor/rules/ 中定义/调整工程规则。
  2. ai-software-engineering/ 维护四阶段文档。
  3. 02-physical 规格新增或更新实现子项目。
  4. 每次改动后执行文档与实现同步,处理冲突并回写关键细节。

Rules 迁入后对齐(推荐:在 Cursor 里对 AI 说)

从其他项目复制/更新了 .cursor/rules/*.mdc 后,在 AI 聊天窗口对助手说例如「同步 rules」「rules 对齐」等(见 .cursor/rules/sync-cursor-rules.mdc),由助手在对话中完成清点、差异、项目对齐与必要验证,并更新 ai-software-engineering/ 与实现代码。


本仓库的定位是:面向自动化 AI 软件工程规则的开发与验证基线