dev-playbooks-cn 1.0.0

package/templates/dev-playbooks/specs/_meta/glossary.md

@@ -0,0 +1,47 @@
+# 术语表 (Glossary)
+
+> 本文档定义项目中使用的领域术语和技术术语。
+> AI 助手在生成代码和文档时应遵循这些术语约束。
+
+---
+
+## 领域术语
+
+| 术语 | 定义 | 英文 | 禁用词 |
+|------|------|------|--------|
+| <!-- 如：用户 --> | <!-- 系统的使用者 --> | User | <!-- 客户、会员 --> |
+
+---
+
+## 技术术语
+
+| 术语 | 定义 | 所属上下文 |
+|------|------|-----------|
+| Truth Root | 真理源根目录，存放规格和设计的最终版本 | DevBooks |
+| Change Root | 变更包根目录，存放每次变更的所有产物 | DevBooks |
+| Spec Delta | 规格增量，描述变更对规格的修改 | DevBooks |
+| AC-ID | 验收标准标识符，格式 `AC-XXX` | DevBooks |
+| GIP | 全局不可违背原则（Global Inviolable Principle） | DevBooks |
+
+---
+
+## 缩写表
+
+| 缩写 | 全称 | 说明 |
+|------|------|------|
+| AC | Acceptance Criteria | 验收标准 |
+| GIP | Global Inviolable Principle | 全局不可违背原则 |
+| DoD | Definition of Done | 完成定义 |
+
+---
+
+## 术语使用规则
+
+1. **一致性**：同一概念在代码、文档、注释中使用相同术语
+2. **无歧义**：避免使用有多重含义的词
+3. **可追溯**：新术语必须在此文档中定义后才能使用
+
+---
+
+**术语表版本**：v1.0.0
+**最后更新**：{{DATE}}

package/templates/dev-playbooks/specs/_meta/project-profile.md

@@ -0,0 +1,79 @@
+# 项目画像 (Project Profile)
+
+> 本文档描述项目的技术画像，用于 AI 助手快速理解项目上下文。
+
+---
+
+## 技术栈
+
+| 类别 | 技术 | 版本 |
+|------|------|------|
+| 语言 | <!-- TypeScript/Python/Go --> | <!-- 版本 --> |
+| 框架 | <!-- React/Django/Gin --> | <!-- 版本 --> |
+| 数据库 | <!-- PostgreSQL/MongoDB --> | <!-- 版本 --> |
+| 测试框架 | <!-- Jest/pytest/go test --> | <!-- 版本 --> |
+| 构建工具 | <!-- webpack/vite/make --> | <!-- 版本 --> |
+
+---
+
+## 常用命令
+
+| 命令 | 用途 |
+|------|------|
+| `npm run dev` | 启动开发服务器 |
+| `npm run build` | 构建生产版本 |
+| `npm run test` | 运行测试 |
+| `npm run lint` | 运行代码检查 |
+
+---
+
+## 项目约定
+
+### 命名约定
+
+- **文件名**：kebab-case（如 `user-service.ts`）
+- **组件名**：PascalCase（如 `UserProfile`）
+- **函数名**：camelCase（如 `getUserById`）
+- **常量名**：UPPER_SNAKE_CASE（如 `MAX_RETRY_COUNT`）
+
+### 目录结构约定
+
+```
+src/
+├── components/     # UI 组件
+├── services/       # 业务逻辑
+├── models/         # 数据模型
+├── utils/          # 工具函数
+└── tests/          # 测试文件
+```
+
+---
+
+## 质量闸门
+
+| 闸门 | 阈值 | 命令 |
+|------|------|------|
+| 单元测试覆盖率 | >= 80% | `npm run test:coverage` |
+| 类型检查 | 0 错误 | `npm run typecheck` |
+| Lint 检查 | 0 错误 | `npm run lint` |
+| 构建 | 成功 | `npm run build` |
+
+---
+
+## 外部服务
+
+| 服务 | 用途 | 环境变量 |
+|------|------|----------|
+| <!-- 如 PostgreSQL --> | <!-- 数据存储 --> | `DATABASE_URL` |
+| <!-- 如 Redis --> | <!-- 缓存 --> | `REDIS_URL` |
+
+---
+
+## 特殊约束
+
+<!-- 项目特有的约束或规则 -->
+
+---
+
+**画像版本**：v1.0.0
+**最后更新**：{{DATE}}

package/templates/dev-playbooks/specs/architecture/fitness-rules.md

@@ -0,0 +1,95 @@
+# 适应度规则 (Fitness Rules)
+
+> 本文档定义项目的架构适应度函数（Fitness Functions）。
+> 这些规则用于自动验证架构约束的遵守情况。
+
+---
+
+## 什么是适应度函数？
+
+适应度函数是可执行的架构约束检查。它们帮助团队：
+- 自动化架构决策的验证
+- 在 CI/CD 中持续检查架构健康
+- 防止架构腐化
+
+---
+
+## 规则定义格式
+
+```markdown
+### FT-XXX: 规则名称
+
+> 来源：<规则来源，如设计文档或架构决策>
+
+**规则**：<规则描述>
+
+**检查命令**：
+\`\`\`bash
+<检查命令>
+\`\`\`
+
+**严重程度**：Critical | High | Medium | Low
+```
+
+---
+
+## 规则列表
+
+### FT-001: 分层依赖方向
+
+> 来源：架构设计
+
+**规则**：上层可依赖下层，下层禁止依赖上层。
+
+**检查命令**：
+```bash
+# 示例：检查 domain 层是否依赖 ui 层
+grep -r "import.*from.*ui" src/domain/ && echo "FAIL" || echo "OK"
+```
+
+**严重程度**：Critical
+
+---
+
+### FT-002: 循环依赖禁止
+
+> 来源：架构设计
+
+**规则**：模块之间禁止循环依赖。
+
+**检查命令**：
+```bash
+# 使用 madge 或类似工具检查
+npx madge --circular src/
+```
+
+**严重程度**：High
+
+---
+
+### FT-003: 测试覆盖率
+
+> 来源：质量要求
+
+**规则**：单元测试覆盖率不低于 80%。
+
+**检查命令**：
+```bash
+npm run test:coverage -- --coverage-threshold='{"global":{"lines":80}}'
+```
+
+**严重程度**：High
+
+---
+
+## 添加新规则的流程
+
+1. 在变更包的 `design.md` 中提出新规则
+2. 经过 Challenger 质疑和 Judge 裁决
+3. 归档时将规则添加到本文档
+4. 在 CI 中添加对应的检查脚本
+
+---
+
+**规则集版本**：v1.0.0
+**最后更新**：{{DATE}}