fstln-dev 项目状态汇总
生成项目进度报告、周报、团队工作量统计。
核心功能
1. 周报生成
当用户说"生成周报"时：
收集数据源
- Git 提交记录
- 任务完成情况（飞书 Bitable）
- 文档状态变更
- 代码评审记录
生成周报
📊 周报 (2026-03-03 ~ 2026-03-09) ## 本周完成 ### 功能开发 - ✅ 订单模块 PRD 编写 (docs/product/prd-order.md) - ✅ 订单模块技术方案 (docs/tech/tech-order.md) - ✅ 订单创建接口开发 ### Bug 修复 - 🐛 修复支付超时问题 (#123) - 🐛 修复库存扣减并发问题 (#124) ### 代码评审 - 📝 评审 5 个 PR，提出 12 条建议 ## 代码统计 | 指标 | 数值 | |------|------| | 提交数 | 23 | | 新增行数 | +1,234 | | 删除行数 | -456 | | 文件变更 | 34 | ## 任务进度 | 任务 | 状态 | 进度 | |------|------|------| | 订单模块开发 | 进行中 | 60% | | 支付模块开发 | 待开始 | 0% | | 测试用例编写 | 进行中 | 30% | ## 下周计划 1. 完成订单模块开发 2. 开始支付模块技术方案 3. 补充单元测试 ## 风险与阻塞 ⚠️ 支付网关接口文档缺失，需要协调导出选项
周报已生成！ 导出选项: [1] 复制为 Markdown [2] 同步到飞书 [3] 发送到飞书群 [4] 保存为文件 (docs/meetings/weekly-20260309.md)
2. 项目状态汇总
当用户说"项目进展"或"当前状态"时：
📊 项目状态汇总
## 基本信息
- 项目: {项目名称}
- 类型: product-dev
- 当前阶段: 开发实现
- 整体进度: 45%
## 阶段完成情况
| 阶段 | 状态 | 完成度 | 交付物 |
|------|------|--------|--------|
| 需求分析 | ✅ 完成 | 100% | PRD x 2 |
| 技术设计 | ✅ 完成 | 100% | 技术方案 x 2 |
| 开发实现 | ⏳ 进行中 | 45% | 功能模块 x 3 |
| 测试验证 | ⬜ 待开始 | 0% | - |
| 发布上线 | ⬜ 待开始 | 0% | - |
## 文档统计
| 类型 | 总数 | Draft | Review | Approved | Released |
|------|------|-------|--------|----------|----------|
| PRD | 2 | 0 | 0 | 2 | 0 |
| 技术方案 | 2 | 1 | 0 | 1 | 0 |
| 测试方案 | 0 | 0 | 0 | 0 | 0 |
## 任务统计
| 状态 | 数量 | 占比 |
|------|------|------|
| 待处理 | 8 | 40% |
| 进行中 | 6 | 30% |
| 已完成 | 5 | 25% |
| 已取消 | 1 | 5% |
## 关键指标
- 代码覆盖率: 72%
- 未解决 Bug: 3 (P0: 0, P1: 1, P2: 2)
- 平均任务周期: 2.5 天
- 按期完成率: 85%
## 风险提示
⚠️ 以下任务即将到期:
- TASK-001 订单开发 (2天后)
- TASK-004 技术方案 (1天后)
⚠️ 以下文档待评审:
- docs/tech/tech-payment.md
3. 团队工作量统计
当用户说"团队周报"或"汇总团队工作"时：
👥 团队工作量统计 (2026-03-03 ~ 2026-03-09)
## 成员贡献
| 成员 | 提交数 | 代码行数 | 任务完成 | 评审数 |
|------|--------|----------|----------|--------|
| 张三 | 12 | +890/-234 | 5 | 3 |
| 李四 | 8 | +456/-123 | 3 | 2 |
| 王五 | 6 | +234/-89 | 2 | 4 |
## 任务分配
| 成员 | 待处理 | 进行中 | 已完成 |
|------|--------|--------|--------|
| 张三 | 2 | 3 | 5 |
| 李四 | 3 | 2 | 3 |
| 王五 | 1 | 2 | 2 |
## 工作分布
### 张三
主要工作:
- 订单模块开发 (60%)
- 代码评审 (25%)
- 文档编写 (15%)
### 李四
主要工作:
- 支付模块开发 (50%)
- Bug 修复 (30%)
- 测试用例 (20%)
### 王五
主要工作:
- 测试执行 (40%)
- 缺陷记录 (35%)
- 文档评审 (25%)
## 团队效率指标
- 平均任务周期: 2.3 天
- 评审响应时间: 4 小时
- Bug 修复周期: 1.5 天
数据源
Git 数据
使用 git log 获取：
- 提交数量和作者
- 代码行数变更
- 文件变更统计
# 本周提交
git log --since="1 week ago" --oneline
# 代码统计
git log --since="1 week ago" --shortstat
任务数据
从飞书 Bitable 获取：
- 任务状态分布
- 任务完成数量
- 成员任务分配
文档数据
从 .claude/context/doc-index.md 获取：
- 文档状态分布
- 文档数量统计
报告格式
Markdown 格式
标准 Markdown，支持：
- 标题层级
- 表格
- 列表
- 代码块
- 链接
飞书格式
同步到飞书时自动转换：
- 表格 → 飞书表格
- 代码块 → 代码块
- 链接 → 超链接
自定义配置
在 .claude/context/report-config.md 中配置：
report:
# 周报时间范围
week_start: monday # monday | sunday
# 包含的数据源
sources:
git: true
tasks: true
documents: true
# 排除的路径
exclude_paths:
- "docs/drafts/"
- "**/*.test.js"
# 自定义模板
template: default # default | minimal | detailed
定时报告（可选）
支持自动生成并发送报告：
schedule:
# 每周五 18:00 生成周报
weekly_report:
enabled: true
time: "Friday 18:00"
channels:
- feishu_group: "OC-XXXX"
错误处理
| 错误 | 处理 |
|---|---|
| Git 仓库不存在 | 跳过 Git 数据，使用其他数据源 |
| 飞书连接失败 | 仅生成本地报告 |
| 无任务数据 | 显示 "暂无任务数据" |
| 时间范围无效 | 使用默认范围（本周） |