Claude Bluebook

AI Development Context and Quality Management System

Claude Bluebook 是一个用于 AI 开发的上下文管理和质量保证系统。它提供任务管理、上下文加载、质量验证和评审流程的完整解决方案，现在包含了全面的集成管理和自动化功能。

🚀 快速开始

安装

# 克隆仓库
git clone <repository-url>
cd claude-bluebook

# 安装基础依赖
pip install -e .

# 安装完整版本（包含集成功能）
pip install -e ".[integration]"

# 或者安装特定功能
pip install -e ".[dev,quality,dashboard]"

初始化系统

# 初始化 Claude Bluebook
claude-bluebook init

# 生成基础上下文
claude-bluebook context

# 查看项目状态
claude-bluebook status

📋 核心功能

1. 上下文管理

# 生成特定里程碑的上下文
claude-bluebook context --milestone M2.3

# 生成通用上下文
claude-bluebook context

# 保存上下文到文件
claude-bluebook context --output context.md

2. 里程碑管理

# 列出所有里程碑
claude-bluebook milestones

# 列出特定状态的里程碑
claude-bluebook milestones --status completed

# 详细信息显示
claude-bluebook milestones --verbose

3. 质量验证

# 验证里程碑输出
claude-bluebook verify M2.3

# 指定输出目录
claude-bluebook verify M2.3 --output-dir outputs/M2.3

# 详细验证信息
claude-bluebook verify M2.3 --verbose

4. 人工评审

# 批准里程碑
claude-bluebook review M2.3 --action approve --reviewer user@company.com

# 拒绝里程碑
claude-bluebook review M2.3 --action reject --reviewer user@company.com --comments "需要改进"

# 请求修改
claude-bluebook review M2.3 --action changes --reviewer user@company.com --comments "请修复以下问题"

5. 集成工作流 🔥 新功能

# 执行完整的里程碑工作流
claude-bluebook workflow M2.3 --threshold 0.95 --verbose

# 自动化工作流（模拟运行）
claude-bluebook automate M2.3 --dry-run

# 使用配置文件执行自动化
claude-bluebook automate M2.3 --config automation_config.json --execute

6. 监控仪表板 🔥 新功能

# 启动监控仪表板
claude-bluebook dashboard

# 指定端口和主机
claude-bluebook dashboard --port 8080 --host 0.0.0.0

7. 审计跟踪

# 查看最近7天的审计统计
claude-bluebook audit --days 7

# 导出审计轨迹
claude-bluebook audit --export audit.json --days 30

🏗️ 系统架构

claude-bluebook/
├── bluebook.py              # 核心管理器
├── context.py               # 上下文加载器
├── milestones.py             # 里程碑管理
├── verification/             # 验证模块
│   ├── verifier.py          # 质量验证器
│   ├── reports.py           # 验证报告
│   └── quality_gates.py     # 质量门管理
├── review/                   # 评审模块
│   └── manager.py           # 评审管理器
├── audit/                    # 审计模块
│   ├── events.py             # 审计事件
│   └── trail_manager.py     # 审计轨迹管理
├── integration/              # 🔥 集成模块
│   ├── manager.py           # 集成管理器
│   ├── workflow.py          # 工作流管理
│   └── automator.py         # 自动化管理器
├── dashboard.py              # 🔥 监控仪表板
├── cli/                      # 命令行工具
│   └── main.py              # CLI 主入口
├── config/                   # 🔥 配置文件
│   └── integration_config.json
└── utils.py                  # 工具函数

📊 质量标准

代码质量

• 类型覆盖率: ≥90%
• 测试覆盖率: ≥80%
• 代码质量: ≥B级
• 无安全漏洞

性能标准

• API 响应 P95: ≤3s
• 并发用户: ≥1000
• CPU 使用率: ≤70%

验证标准

• 文件存在性: 100%
• 代码质量检查: 80%+
• 测试覆盖率: 70%+
• 安全扫描: 90%+

🎯 集成使用

与项目集成

1. 在项目根目录初始化:

   cd your-project
   python -m claude_bluebook init
   

2. 配置里程碑任务:

   • 在 docs/tasks/ 目录创建里程碑文件
   • 使用 M{数字}.{数字}.md 格式命名

3. 自动化验证:

   # CI/CD 中添加验证步骤
   claude-bluebook verify M2.3
   

集成工作流使用

1. 完整工作流执行:

   # 自动执行验证、质量门检查和评审决策
   claude-bluebook workflow M2.3 --threshold 0.95
   

2. 自动化配置:

   {
     "auto_verify": true,
     "auto_review": true,
     "auto_approve_threshold": 0.95,
     "security_requires_manual": true
   }
   

3. 监控仪表板:

   • 访问 http://localhost:8501 查看项目状态
   • 实时监控质量指标和审计轨迹
   • 配置自动化参数并执行工作流

与现有工作流集成

1. 开发前: 使用 claude-bluebook context 获取上下文
2. 开发后: 使用 claude-bluebook workflow 执行完整验证流程
3. 代码审查: 使用 claude-bluebook review 进行评审
4. 部署前: 检查仪表板中的所有质量门是否通过

🔧 配置

质量门配置

编辑 `config/integration_config.json 来自定义质量门标准：

{
  "quality_gates": {
    "code_quality_threshold": 0.8,
    "test_coverage_threshold": 0.7,
    "security_threshold": 0.9,
    "documentation_threshold": 0.6,
    "overall_threshold": 0.8
  },
  "automation": {
    "auto_approve_threshold": 0.95,
    "security_requires_manual": true
  }
}

项目配置

在项目根目录创建 .claude-bluebook.json：

{
  "project_name": "Your Project",
  "quality_standards": {
    "test_coverage_min": 80,
    "code_quality_min": 70
  },
  "integrations": {
    "git_hooks": true,
    "ci_cd": true
  }
}

📈 监控和报告 🔥 新功能

监控仪表板

系统提供全面的 Web 监控界面：

• 项目概览: 里程碑进度和健康度
• 质量指标: 代码质量、测试覆盖率、安全评分
• 审计轨迹: 事件历史和用户活动统计
• 自动化面板: 配置和执行自动化工作流

审计轨迹

系统自动记录所有重要操作：

• 里程碑创建和更新
• AI 生成过程
• 质量验证结果
• 人工评审活动
• 自动化工作流执行
• 配置变更

报告生成

# 生成详细报告
claude-bluebook audit --export full_report.json --days 30

# 启动仪表板查看可视化报告
claude-bluebook dashboard

状态监控

# 实时状态查看
claude-bluebook status

# 工作流执行状态
claude-bluebook workflow M2.3 --verbose

🤖 自动化功能 🔥 新功能

智能工作流

1. 自动验证: 质量检查、测试覆盖率、安全扫描
2. 质量门评估: 可配置的阈值和权重
3. 智能评审: 基于质量分数的自动决策
4. 审计记录: 完整的操作轨迹

自动化配置

• 可配置的质量阈值
• 安全策略控制
• 干运行模式支持
• 多并发工作流管理

集成管理器

使用 IntegratedManager 类进行程序化集成：

from claude_bluebook.integration import IntegratedManager

manager = IntegratedManager()

# 执行完整工作流
result = manager.execute_milestone_workflow(
    "M2.3", "user@example.com", auto_approve_threshold=0.95
)

# 自动化执行
automation_result = manager.automation_manager.execute_automation_workflow(
    "M2.3", "user@example.com", automation_config
)

🔍 高级功能

上下文生成增强

from claude_bluebook.utils import generate_context_files

# 批量生成上下文文件
context_files = generate_context_files(
    project_root=Path("."),
    output_dir=Path(".claude-bluebook/contexts")
)

质量报告导出

from claude_bluebook.utils import create_quality_report, export_audit_data

# 创建质量报告
quality_report = create_quality_report(Path("."), "M2.3")

# 导出审计数据
audit_file = export_audit_data(Path("."), days=30, format="csv")

🤝 贡献指南

1. Fork 项目
2. 创建功能分支: git checkout -b feature/new-feature
3. 提交更改: git commit -am 'Add new feature'
4. 推送分支: git push origin feature/new-feature
5. 创建 Pull Request

📞 支持

• 📖 查看文档: docs/ 目录
• 🐛 报告问题: GitHub Issues
• 💬 讨论交流: GitHub Discussions
• 📧 邮件支持: dev@ljwx.ai

📄 许可证

MIT License

---

🎉 让 AI 开发更智能、更可靠、更可追溯！

🔥 v1.0 新功能亮点

• ✨ 集成工作流: 一键执行验证、质量门检查和评审决策
• 📊 监控仪表板: 实时项目状态和可视化质量指标
• 🤖 智能自动化: 基于质量分数的自动评审决策
• 🔍 全面审计: 完整的操作轨迹和统计分析
• ⚙️ 灵活配置: 可配置的阈值和自动化参数
• 🚀 CLI 扩展: 新增工作流、自动化和仪表板命令