开发者效率套装 (Developer Productivity Bundle)

程序员的AI副驾驶，让开发效率翻倍

💼 套装定位

专为软件开发者、技术团队和技术负责人打造，整合代码审查、Bug追踪、文档生成和部署监控四大核心能力，打造AI驱动的开发工作流。

🎯 包含技能

1. 代码审查 (ai-refactoring-assistant / coding-agent)

• 功能：代码质量分析、重构建议、最佳实践检查
• 适用场景：PR审查、代码优化、技术债务清理
• 价值：自动化Code Review，提升代码质量

2. Bug追踪 (gh-issues / api-dev)

• 功能：Issue管理、Bug自动分类、修复建议
• 适用场景：Bug管理、任务分配、进度追踪
• 价值：智能化Bug管理

3. 文档生成 (academic-writing-refiner / feishu-doc / notion)

• 功能：代码注释生成、API文档、技术文档
• 适用场景：项目文档、API文档、README生成
• 价值：自动化文档维护

4. 部署监控 (healthcheck / cron / browser-automation)

• 功能：服务监控、健康检查、异常告警
• 适用场景：生产环境监控、CI/CD集成
• 价值：7x24小时运维保障

📦 套装内容

dev-productivity-bundle/
├── SKILL.md                      # 本文件 - 套装总览
├── config/
│   ├── code-review.yaml          # 代码审查配置
│   ├── bug-tracker.yaml          # Bug追踪配置
│   ├── doc-generator.yaml        # 文档生成配置
│   └── deploy-monitor.yaml       # 部署监控配置
├── examples/
│   ├── code-review-flow.md       # 代码审查流程
│   ├── bug-fix-workflow.md       # Bug修复工作流
│   └── ci-cd-integration.md      # CI/CD集成示例
└── README.md                     # 快速上手指南

🚀 快速开始

第一步：安装技能

# 代码审查
py -m clawhub install ai-refactoring-assistant
py -m clawhub install coding-agent

# Bug追踪
py -m clawhub install gh-issues
py -m clawhub install api-dev

# 文档生成
py -m clawhub install academic-writing-refiner
py -m clawhub install feishu-doc

# 部署监控
py -m clawhub install healthcheck
py -m clawhub install cron

第二步：配置GitHub集成

编辑 config/code-review.yaml：

github:
  token: "${GITHUB_TOKEN}"
  webhook_secret: "${GITHUB_WEBHOOK_SECRET}"
  
repositories:
  - owner: "your-org"
    repo: "your-project"
    code_review:
      enabled: true
      on_pull_request: true
      on_push: false
      rules:
        - "code-quality"
        - "security-check"
        - "performance"
    
    bug_tracker:
      enabled: true
      auto_label: true
      auto_assign: true
    
    doc_generator:
      enabled: true
      generate_on_release: true
      output_format: "markdown"

💡 典型使用场景

场景1：自动化代码审查

用户：审查这个PR

开发助手：
🔍 PR审查报告 #123

━━━━━━━━━━━━━━━━━━━━━
📊 概览
━━━━━━━━━━━━━━━━━━━━━

PR：修复用户登录问题
作者：@developer
变更：+156/-42 行
文件：5个

━━━━━━━━━━━━━━━━━━━━━
✅ 通过检查（4/5）
━━━━━━━━━━━━━━━━━━━━━

✓ 代码风格检查
✓ 安全漏洞扫描
✓ 单元测试覆盖
✓ 依赖检查

━━━━━━━━━━━━━━━━━━━━━
⚠️ 建议改进（3项）
━━━━━━━━━━━━━━━━━━━━━

1. 性能优化建议
   📄 auth/service.py:45
   问题：数据库查询在循环中执行
   建议：使用批量查询优化
   
   ```python
   # 当前代码
   for user_id in user_ids:
       user = db.query(User).get(user_id)
   
   # 建议优化
   users = db.query(User).filter(User.id.in_(user_ids)).all()

2. 错误处理 📄 auth/service.py:78 问题：异常处理过于宽泛 建议：细化异常类型

   # 建议
   try:
       user = authenticate(credentials)
   except InvalidCredentialsError:
       raise AuthenticationError("Invalid credentials")
   except UserNotFoundError:
       raise AuthenticationError("User not found")
   

3. 文档注释 📄 auth/models.py:12 问题：缺少函数文档 建议：添加docstring

━━━━━━━━━━━━━━━━━━━━━ 🎯 总体评价 ━━━━━━━━━━━━━━━━━━━━━

代码质量：B+（良好） 建议：修复性能问题后合并

需要我生成修复建议的代码吗？

### 场景2：智能Bug管理

用户：分析最近的Bug情况

开发助手： 📊 Bug分析报告（本周）

━━━━━━━━━━━━━━━━━━━━━ 📈 数据概览 ━━━━━━━━━━━━━━━━━━━━━

新建Bug：23个 已解决：19个 待处理：4个 平均解决时间：1.5天 ⬇️（上周2.3天）

━━━━━━━━━━━━━━━━━━━━━ 🎯 Bug分类 ━━━━━━━━━━━━━━━━━━━━━

🔴 严重（3个） • #234 - 支付接口超时 • #235 - 数据库连接池耗尽 • #236 - 用户数据丢失

🟡 中等（12个） • UI显示问题（5个） • 性能问题（4个） • 兼容性问题（3个）

🟢 轻微（8个） • 文案问题（4个） • 样式微调（4个）

━━━━━━━━━━━━━━━━━━━━━ 🔍 趋势分析 ━━━━━━━━━━━━━━━━━━━━━

高频问题： • 支付相关问题 ↑ 40% • 移动端适配 ↑ 25%

建议： • 加强支付模块测试 • 增加移动端自动化测试

━━━━━━━━━━━━━━━━━━━━━ 👥 团队负载 ━━━━━━━━━━━━━━━━━━━━━

@张三：处理中 2个（负载正常） @李四：处理中 5个 ⚠️（负载较高） @王五：处理中 1个（可分配更多）

建议：将2个中等优先级Bug分配给@王五

需要我自动分配Bug吗？

### 场景3：文档自动生成

用户：为这个项目生成API文档

开发助手： ✅ 已生成API文档

━━━━━━━━━━━━━━━━━━━━━ 📄 文档概览 ━━━━━━━━━━━━━━━━━━━━━

项目：User Service API 版本：v2.1.0 端点：15个 生成时间：2026-03-21 14:30

━━━━━━━━━━━━━━━━━━━━━ 🔑 认证 ━━━━━━━━━━━━━━━━━━━━━

所有API请求需要在Header中包含：

Authorization: Bearer {access_token}

━━━━━━━━━━━━━━━━━━━━━ 📚 API端点 ━━━━━━━━━━━━━━━━━━━━━

用户管理

POST /api/v2/users

创建新用户

请求参数：

{
  "username": "string",     // 用户名，必填，3-20字符
  "email": "string",        // 邮箱，必填，需符合邮箱格式
  "password": "string",     // 密码，必填，8-32字符
  "role": "string"          // 角色，可选，默认"user"
}

响应示例：

{
  "id": "usr_123456",
  "username": "john_doe",
  "email": "[email protected]",
  "role": "user",
  "created_at": "2026-03-21T14:30:00Z"
}

错误码：

• 400：请求参数错误
• 409：用户名或邮箱已存在
• 500：服务器内部错误

GET /api/v2/users/{id}

获取用户信息

...（完整文档）

━━━━━━━━━━━━━━━━━━━━━ 📦 交付文件 ━━━━━━━━━━━━━━━━━━━━━

• api-documentation.md（完整文档） • openapi.yaml（OpenAPI规范） • postman-collection.json（Postman集合）

文档已保存至：./docs/api/ 需要我发布到文档站点吗？

### 场景4：部署监控告警

用户：查看服务状态

开发助手： 📊 服务健康状态

━━━━━━━━━━━━━━━━━━━━━ 🟢 整体状态：健康 ━━━━━━━━━━━━━━━━━━━━━

检查时间：2026-03-21 14:35 监控服务：8个 在线服务：8个 可用性：99.95%

━━━━━━━━━━━━━━━━━━━━━ 📈 服务详情 ━━━━━━━━━━━━━━━━━━━━━

🟢 user-service 状态：运行中 响应时间：45ms ⬇️（平均50ms） 错误率：0.01% 最后部署：2小时前

🟢 payment-service 状态：运行中 响应时间：120ms ⬆️（平均100ms） 错误率：0.05% 最后部署：5小时前 ⚠️ 响应时间略高于平均

🟢 notification-service 状态：运行中 响应时间：35ms 错误率：0.00% 队列长度：12（正常）

━━━━━━━━━━━━━━━━━━━━━ 📊 资源使用 ━━━━━━━━━━━━━━━━━━━━━

CPU使用率：42%（正常） 内存使用率：68%（正常） 磁盘使用率：45%（正常） 网络IO：正常

━━━━━━━━━━━━━━━━━━━━━ 🔔 最近告警 ━━━━━━━━━━━━━━━━━━━━━

过去24小时： • 14:20 - payment-service响应时间超过阈值（已恢复） • 08:15 - 数据库连接数接近上限（已处理）

━━━━━━━━━━━━━━━━━━━━━ 💡 建议 ━━━━━━━━━━━━━━━━━━━━━

• payment-service响应时间有上升趋势，建议关注 • 考虑在高峰时段扩容

需要查看详细监控数据吗？

---

## ⚙️ 配置模板

### 代码审查配置

```yaml
# config/code-review.yaml
code_review:
  enabled: true
  
rules:
  code_quality:
    enabled: true
    checks:
      - "complexity"           # 复杂度检查
      - "duplicate"            # 重复代码
      - "naming"               # 命名规范
      - "documentation"        # 文档注释
    
  security:
    enabled: true
    checks:
      - "sql-injection"        # SQL注入
      - "xss"                  # XSS攻击
      - "hardcoded-secrets"    # 硬编码密钥
      - "dependency-vuln"      # 依赖漏洞
    
  performance:
    enabled: true
    checks:
      - "n+1-queries"          # N+1查询
      - "memory-leak"          # 内存泄漏
      - "inefficient-loop"     # 低效循环
      - "unused-imports"       # 未使用导入
  
notification:
  on_failure: true
  on_warning: true
  channels:
    - "github-pr-comment"
    - "slack"

部署监控配置

# config/deploy-monitor.yaml
monitoring:
  interval: 60  # 秒
  
services:
  - name: "user-service"
    url: "https://api.example.com/health"
    check_type: "http"