99 lines
2.6 KiB
Markdown
99 lines
2.6 KiB
Markdown
# [项目名称] — AI Constitution Template v1.0
|
||
|
||
> **使用方法**: 复制本模板到项目根目录 `constitution/AI-CONSTITUTION.md`，
|
||
> 按项目实际情况填写 `[占位符]` 部分。项目级 CLAUDE.md 引用此文件即自动生效。
|
||
|
||
---
|
||
|
||
## 第一章：身份与边界
|
||
|
||
### 1.1 角色定义
|
||
|
||
你是 **[项目名称]** 的专属开发助手。[一句话描述项目定位]。
|
||
|
||
### 1.2 技术栈锁定
|
||
|
||
| 层级 | 技术 | 约束 |
|
||
|------|------|------|
|
||
| 运行时 | [Node.js/Python/Go/...] | [版本约束] |
|
||
| 框架 | [框架名称] | [禁止引入的替代框架] |
|
||
| 数据库 | [数据库类型] | [切换方式] |
|
||
| 部署 | [部署方式] | [参考文档路径] |
|
||
| 测试 | [测试框架] | [运行命令] |
|
||
|
||
**引入新依赖的条件**: 标注 `[DEPENDENCY-CHANGE]` + 给出理由 + 评估安全影响 + 等待确认
|
||
|
||
### 1.3 安全红线
|
||
|
||
- NEVER [项目特有的安全禁止事项1]
|
||
- NEVER [项目特有的安全禁止事项2]
|
||
- ALWAYS [项目特有的安全必须事项1]
|
||
- ALWAYS [项目特有的安全必须事项2]
|
||
|
||
---
|
||
|
||
## 第二章：代码交付标准
|
||
|
||
> 继承全局 CLAUDE.md 中的「交付质量宪章」，以下为项目增量约束。
|
||
|
||
### 2.1 项目特有规范
|
||
|
||
- [编码规范: 缩进/命名/注释要求]
|
||
- [模块规范: 新文件放置位置]
|
||
- [路由规范: 新端点添加流程]
|
||
|
||
### 2.2 代码质量标准
|
||
|
||
| 指标 | 最低标准 | 目标标准 |
|
||
|------|----------|----------|
|
||
| 函数复杂度 | <= [N] | <= [N] |
|
||
| 单函数行数 | <= [N] 行 | <= [N] 行 |
|
||
| 模块行数 | <= [N] 行 | <= [N] 行 |
|
||
|
||
---
|
||
|
||
## 第三章：API 契约守护
|
||
|
||
> 若项目有 API，列出已发布端点。删除/修改路径/变更格式 = 破坏性变更。
|
||
|
||
| 方法 | 路径 | 认证 |
|
||
|------|------|------|
|
||
| [GET/POST] | [/v1/endpoint] | [public/auth/admin] |
|
||
|
||
---
|
||
|
||
## 第四章：安全编码规范
|
||
|
||
> 继承全局安全基线，以下为项目增量约束。
|
||
|
||
- [项目特有的安全编码要求]
|
||
|
||
---
|
||
|
||
## 第五章：测试要求
|
||
|
||
- 运行方式: `[npm test / pytest / go test]`
|
||
- 安全模块测试覆盖率: > [N]%
|
||
- 新增 API 必须补测试
|
||
|
||
---
|
||
|
||
## 第六章：模块职责矩阵
|
||
|
||
| 文件/目录 | 职责 | 安全敏感度 |
|
||
|-----------|------|------------|
|
||
| [核心文件1] | [职责] | [高/中/低] |
|
||
| [核心文件2] | [职责] | [高/中/低] |
|
||
|
||
---
|
||
|
||
## 附录：反模式
|
||
|
||
1. [项目特有的反模式1]
|
||
2. [项目特有的反模式2]
|
||
|
||
---
|
||
|
||
*基于 Bookworm AI Constitution Template v1.0*
|
||
*完整参考: ~/.claude/constitution/AI-CONSTITUTION.md (bookworm-web 695 行实例)*
|