Dev Canon
人机协作开发治理知识库。通过规则、Skills 和项目文档,让 AI 推进实现,让项目负责人理解行为、参与关键决定并验证结果。
项目初始化
选择项目场景,将初始化指令交给目标项目中的 AI。每个场景都包含通用流程和所需资源的链接。
| 场景入口 | 场景 Skill | 操作 |
|---|---|---|
| 纯前端 | 尚未收录,按需使用通用 Skill | |
| TS 后端 v1 | Hono + Drizzle;采用相应分层时使用后端职责与边界 Skill | |
| Go 后端 | 尚未收录,按需使用通用 Skill | |
| 通用初始化 | 其他类型,或只安装治理机制 |
前后端共用仓库时,可组合对应场景,通用流程只执行一次。使用 TypeScript 的前端选择“纯前端”。
指令使用当前服务地址,请确认 AI 能够访问。云端 AI 无法通过本机的 localhost 地址连接此服务。
治理规则
- 人机协作开发治理:L1 / L2 / L3 决策边界、交付与验证,以及架构说明、ADR 和 Mermaid 图的维护要求。v0.2 已确认试行,实际效果持续验证。
Skills
通用
后端
- TypeScript 后端职责与边界:划分业务、数据库访问、接口定义等职责,明确模块之间的依赖约定。
目前尚无前端、Go 专属 Skill 或经过实践验证的通用语言规则,内容随实际项目逐步积累。Skill 的选用见通用流程或对应场景。
模板
- 项目 AGENTS.md 模板:填写项目现状、验证命令与治理规则入口。
- 架构决策记录模板:记录重要决定的背景、理由与代价。
使用说明
- AI 可直接从场景 Markdown 开始初始化,无需先读取本页。
- 仅浏览在线文件不会完成安装;AI 需将治理规则和完整 Skills 写入目标项目并验证。
- 规则保存在项目本地,日常工作不依赖持续联网。在线更新后,需比较差异再采用。
- 各项目的架构现状和重要决策记录保留在各自仓库。