mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-02 15:23:19 +08:00
8ceae6d6fd
- Created a new document for custom skills development (`custom.md`) detailing the structure, creation, implementation, and best practices for developing custom CCW skills. - Added an index document (`index.md`) summarizing all built-in skills, their categories, and usage examples. - Introduced a reference guide (`reference.md`) providing a quick reference for all 33 built-in CCW skills, including triggers and purposes.
4.8 KiB
4.8 KiB
Quality Gates
本文档定义 CCW Skills 各阶段的质量门禁标准和评分规则。
概述
质量门禁确保每个阶段完成前达到最低质量标准。门禁标准涵盖内容完整性、格式规范性、可执行性等方面。
质量门禁矩阵
Phase 1: Discovery
| 检查项 | 标准 | 权重 | 通过条件 |
|---|---|---|---|
| 输出文件存在 | discovery-context.json |
20% | 文件存在且格式正确 |
| 代码库覆盖 | 至少扫描 3 个目录 | 20% | 扫描目录 ≥ 3 |
| 关键发现 | 识别关键模式/问题 | 30% | 发现项 ≥ 5 |
| 技术栈识别 | 正确识别语言/框架 | 15% | 识别准确 |
| 可执行性 | 下一步可基于发现执行 | 15% | 可行动建议 ≥ 3 |
最低通过分数: 70/100
Phase 2: Product Brief
| 检查项 | 标准 | 权重 | 通过条件 |
|---|---|---|---|
| 输出文件存在 | product-brief.md |
15% | 文件存在 |
| 问题陈述清晰度 | Pain Point 明确 | 20% | 至少 3 个 Pain Point |
| 目标用户定义 | Target Audience 具体 | 15% | 用户画像清晰 |
| MoSCoW 分析 | 优先级分类完整 | 20% | Must/Should/Could 完整 |
| 可行性评估 | 技术可行性讨论 | 15% | 评估合理 |
| 格式规范 | 符合模板格式 | 15% | 符合模板 |
最低通过分数: 75/100
Phase 3: Requirements (PRD)
| 检查项 | 标准 | 权重 | 通过条件 |
|---|---|---|---|
| 输出文件存在 | requirements/ 目录 |
10% | 目录结构完整 |
| 索引文件 | _index.md 完整 |
15% | 包含摘要、MoSCoW、追溯 |
| 功能需求 | REQ-*.md 数量 |
20% | 需求 ≥ 3 个 |
| 需求完整性 | Who/What/Why/How | 20% | 所有字段完整 |
| 非功能需求 | NFR-*.md 数量 |
15% | 至少 1 个 |
| 追溯性 | 从 Brief 到需求的链接 | 10% | 链接有效 |
| 格式规范 | 符合模板格式 | 10% | 符合模板 |
最低通过分数: 75/100
Phase 4: Architecture
| 检查项 | 标准 | 权重 | 通过条件 |
|---|---|---|---|
| 输出文件存在 | architecture/ 目录 |
10% | 目录结构完整 |
| 索引文件 | _index.md 完整 |
15% | 包含组件、技术栈 |
| ADR 数量 | ADR-*.md 数量 |
20% | 决策记录 ≥ 2 |
| 决策质量 | Context/Decision/Consequence | 20% | 结构完整 |
| 技术栈选择 | 有理由支持 | 15% | 评估合理 |
| 追溯性 | 从 PRD 到架构的链接 | 10% | 链接有效 |
| 格式规范 | 符合模板格式 | 10% | 符合模板 |
最低通过分数: 75/100
Phase 5: Epics
| 检查项 | 标准 | 权重 | 通过条件 |
|---|---|---|---|
| 输出文件存在 | epics/ 目录 |
10% | 目录结构完整 |
| 索引文件 | _index.md 完整 |
15% | 包含 Epic 表、依赖图 |
| Epic 数量 | EPIC-*.md 数量 |
20% | Epic ≥ 2 |
| Story 质量 | User Story 格式 | 20% | 作为...我想要...以便... |
| 依赖关系 | Epic 间依赖清晰 | 15% | 依赖图或说明 |
| MVP 范围 | MVP 定义明确 | 10% | MVP Epic 标记 |
| 追溯性 | 从架构到 Epic 的链接 | 10% | 链接有效 |
最低通过分数: 75/100
Phase 6: Readiness Check
| 检查项 | 标准 | 权重 | 通过条件 |
|---|---|---|---|
| 就绪报告 | readiness-report.md |
30% | 文件存在且完整 |
| 摘要文档 | spec-summary.md |
20% | 一页摘要 |
| 质量评分 | 所有阶段通过 | 30% | 所有阶段 ≥ 最低分 |
| 移交选项 | Handoff 选项清晰 | 10% | 选项明确 |
| 格式规范 | 符合模板格式 | 10% | 符合模板 |
最低通过分数: 80/100
质量评分计算
自动检查项
# 文件存在性
if [ -f "$expected_file" ]; then score=$((score + weight)); fi
# 格式验证
if markdownlint "$file"; then score=$((score + weight)); fi
# 链接有效性
if check-links "$file"; then score=$((score + weight)); fi
手动评审项
- 内容质量
- 逻辑连贯性
- 可执行性
- 实用性
综合评分
最终得分 = 自动检查得分 × 60% + 手动评审得分 × 40%
质量等级
| 等级 | 分数范围 | 描述 |
|---|---|---|
| A - 优秀 | 90-100 | 超出标准，可直接移交 |
| B - 良好 | 80-89 | 满足标准，可移交 |
| C - 及格 | 70-79 | 基本达标，需要改进 |
| D - 不及格 | < 70 | 未达标，需要返工 |
不合格处理
返工流程
- 识别问题: 在就绪报告中列出不合格项
- 修复: 返回对应阶段进行修复
- 重新评估: 重新执行质量检查
- 记录: 记录修复过程和结果
豁免条件
- 探索性项目（POC）
- 时间受限的快速原型
- 明确标注为"草稿"的输出