# Project Status

> 项目状态汇总。在以下场景触发： 1. 用户说 "生成周报"、"写周报" 2. 用户说 "项目进展"、"当前状态" 3. 用户说 "汇总任务"、"进度报告" 4. 用户说 "团队周报"、"本周工作" 支持周报生成、项目状态汇总、团队工作量统计。

- Skill: `fstln-dev/project-status` (Agent Skill)
- Install (CLI): `npx skillmds@latest add fstln-dev/project-status`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fstln-dev/project-status/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: fstln-dev (https://skillmd.com/u/fstln-dev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/fstln-dev/project-status

---


# 项目状态汇总

生成项目进度报告、周报、团队工作量统计。

## 核心功能

### 1. 周报生成

当用户说"生成周报"时：

1. **收集数据源**
   - Git 提交记录
   - 任务完成情况（飞书 Bitable）
   - 文档状态变更
   - 代码评审记录

2. **生成周报**
   ```
   📊 周报 (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. 补充单元测试

   ## 风险与阻塞

   ⚠️ 支付网关接口文档缺失，需要协调
   ```

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` 获取：
- 提交数量和作者
- 代码行数变更
- 文件变更统计

```bash
# 本周提交
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` 中配置：

```yaml
report:
  # 周报时间范围
  week_start: monday  # monday | sunday

  # 包含的数据源
  sources:
    git: true
    tasks: true
    documents: true

  # 排除的路径
  exclude_paths:
    - "docs/drafts/"
    - "**/*.test.js"

  # 自定义模板
  template: default  # default | minimal | detailed
```

## 定时报告（可选）

支持自动生成并发送报告：

```yaml
schedule:
  # 每周五 18:00 生成周报
  weekly_report:
    enabled: true
    time: "Friday 18:00"
    channels:
      - feishu_group: "OC-XXXX"
```

## 错误处理

| 错误 | 处理 |
|------|------|
| Git 仓库不存在 | 跳过 Git 数据，使用其他数据源 |
| 飞书连接失败 | 仅生成本地报告 |
| 无任务数据 | 显示 "暂无任务数据" |
| 时间范围无效 | 使用默认范围（本周） |