dvcrn 研发经理助手 Skill
这是一套专为研发经理设计的实用工具集合，帮助提升团队管理效率。
核心理念
配置 + 模板优先，轻量化，可扩展，立即可用
本技能采用类似 Reviewpad 的架构：
- YAML 配置：灵活定义项目和团队信息
- Markdown 模板：易于定制和扩展
- 命令行工具：快速执行常用任务
- Python 报告生成器：自动化报告制作
快速开始
初始化
首次使用需要运行初始化脚本：
cd /root/.openclaw/workspace/skills/研发经理助手
./scripts/setup.sh
这将：
- 设置工具脚本执行权限
- 检查系统依赖（Git、Python3）
- 创建必要的目录结构
- 准备配置文件模板
配置
编辑配置文件 config/skill-config.yaml：
- 项目名称和时区
- Git 仓库路径
- 团队成员信息
- 报告配置
功能模块
1. Git 统计工具 📊
文件: tools/git-stats.sh
自动统计指定时间范围内的代码提交数据，包括：
- 总提交数和活跃天数
- 按作者统计贡献
- 代码行数变化
- 最近提交记录
- 文件类型统计
使用方式：
./tools/git-stats.sh /path/to/repo 7
AI 集成：
用户: 生成晨会报告
AI: [运行 git-stats.sh] 统计数据已生成，准备晨会报告...
2. 报告生成器 📝
文件: tools/report-generator.py
基于 Markdown 模板生成各类报告：
- 晨会报告
- 项目周报
- 自定义报告
使用方式：
python3 tools/report-generator.py \
--template templates/晨会报告模板.md \
--config config/skill-config.yaml \
--output reports/晨会报告-$(date +%Y%m%d).md
模板语法：
- 使用
{{变量名}}作为占位符 - 变量可来自配置文件或命令行参数
AI 集成：
用户: 生成项目周报
AI: [调用 report-generator.py] 周报已生成到 reports/目录
3. 代码审查清单 ✅
文件: tools/review-checklist.sh
基于标准检查清单生成可编辑的审查报告，包含：
- 安全性检查
- 性能优化点
- 代码质量检查
- 测试覆盖度
- 文档完整性
- 兼容性检查
使用方式：
./tools/review-checklist.sh docs/代码审查检查清单.md my-review.md
AI 集成：
用户: 帮我审查这个 PR
AI: [生成审查报告] 已根据检查清单生成审查模板，请填写审查结果
4. 项目进度监控 📈
基于配置的里程碑和风险阈值，提供：
- 任务完成率跟踪
- 资源使用情况
- 风险预警
- 预估延期风险
使用方式：
配置 config/project-config.yaml 中的：
- 里程碑列表
- 任务分类
- 风险阈值
- 团队负载规则
AI 集成：
用户: 项目进度如何
AI: [分析配置和数据] 当前进度：70%，预计按时完成
5. 团队任务分配助手 🎯
基于成员负载和能力，提供分配建议：
- 技能匹配度分析
- 工作负载平衡
- 资源优化建议
使用方式： 配置团队成员的技能信息和当前任务负载。
AI 集成：
用户: 分配这个任务
AI: [分析团队成员负载] 建议分配给张三，当前负载较轻且技能匹配
配置系统
skill-config.yaml
主配置文件，定义技能的全局行为：
# 基本信息
project_name: "我的项目"
timezone: "Asia/Shanghai"
# Git 仓库配置
git:
repo_path: "/path/to/your/repo"
main_branch: "main"
stats_days: 7
# 团队成员
team:
- name: "张三"
role: "前端开发"
email: "zhangsan@example.com"
# 晨会报告配置
morning_meeting:
enabled: true
time: "09:00"
include_code_stats: true
# 报告输出配置
reports:
output_dir: "./reports"
format: "markdown"
archive_enabled: true
project-config.yaml（可选）
项目级配置，定义具体的项目信息：
# 里程碑
milestones:
- name: "MVP 发布"
date: "2024-03-01"
status: "completed"
# 风险阈值
risk_thresholds:
overdue_days: 3
code_growth_per_day: 1000
open_prs_limit: 10
# 团队负载平衡
workload:
max_tasks_per_person: 5
max_hours_per_day: 8
AI 对话集成示例
晨会准备
用户: 做晨会准备
AI:
[运行 git-stats.sh] 已获取最近7天的代码统计...
[运行 report-generator.py] 晨会报告已生成！
以下是摘要：
- 总提交数: 45
- 主要贡献: 张三(20), 李四(18)
- 阻塞问题: 2个
- 今日重点: 完成用户认证模块测试
代码审查
用户: 审查PR #123
AI:
[运行 review-checklist.sh] 审查清单已生成！
关键检查项：
- 安全性: SQL注入防护 ✓
- 性能: N+1查询问题 ⚠️
- 测试: 单元测试覆盖率 85%
建议: 优化数据库查询，提高测试覆盖率至90%
项目汇报
用户: 本周项目进度怎么样？
AI:
[分析配置和数据] 分析完成！
📊 进度概览:
- 总体进度: 70%
- 已完成: 14/20 任务
- 进行中: 4 任务
- 延期风险: 低
⚠️ 需要关注:
- 接口文档未更新
- 建议增加测试人员
项目结构
研发经理助手/
├── SKILL.md # 本文件
├── README.md # 详细使用指南
├── package.json # NPM 包信息
├── config/ # 配置文件
│ ├── skill-config.yaml # 主配置
│ └── project-config.example.yaml # 项目配置示例
├── templates/ # 报告模板
│ ├── 晨会报告模板.md
│ └── 项目周报模板.md
├── docs/ # 文档
│ └── 代码审查检查清单.md
├── tools/ # 工具脚本
│ ├── git-stats.sh # Git 统计
│ ├── report-generator.py # 报告生成
│ └── review-checklist.sh # 审查清单
├── scripts/ # 辅助脚本
│ └── setup.sh # 初始化脚本
└── reports/ # 生成报告目录
系统要求
必需
- Git: 用于代码统计
- Python 3.6+: 用于报告生成器
- Bash: 用于运行 shell 脚本
可选
- yamllint: YAML 格式检查
- jq: JSON 处理（如需 JSON 输出）
使用场景
场景1：日常晨会
用户: 生成晨会报告
AI: [自动调用工具] 生成完整的晨会报告
场景2：代码审查
用户: 审查这个PR
AI: [生成审查清单] 应用标准检查清单逐项检查
场景3：项目汇报
用户: 本周工作总结
AI: [生成周报] 包含进度、风险、下周计划
场景4：任务分配
用户: 分配新任务
AI: [分析负载] 推荐最合适的团队成员
最佳实践
- 每日运行 git-stats.sh 跟踪代码活动
- 定期更新 配置文件保持信息准确
- 自定义模板 根据团队需求调整报告格式
- 归档报告 用于长期趋势分析
- 迭代改进 持续优化检查清单和配置
版本历史
v1.0.0 (2024-02-20)
- ✅ Git 统计工具
- ✅ 报告生成器
- ✅ 代码审查清单
- ✅ 配置系统
- ✅ 晨会/周报模板
- ✅ 初始化脚本
未来计划
- 集成项目管理工具 API（Jira、Trello）
- 自动生成图表和可视化
- 风险自动预警
- 更多模板和检查清单
- 支持更多版本控制系统
让研发管理更轻松！