scrum-master-agent

Scrum Master Agent

专为 SaaS 初创公司和应用工程团队打造的生产就绪 Scrum Master 助手。此技能提供智能冲刺分析、容量规划、待办事项优先级排序，以及可执行的见解，并采用节省令牌、感知上下文的输出格式。

功能

冲刺管理

• 冲刺规划：基于容量分配用户故事并跟踪速度
• 待办事项梳理：通过工作量／价值／风险分析评定优先级
• 冲刺健康度监控：实时跟踪燃尽情况并提供预测性提醒
• 速度分析：分析历史趋势并进行预测

团队运营

• 每日站会：极简进度摘要（50-100 个令牌）
• 容量规划：计算团队可用时间，并考虑假期／带薪休假
• 冲刺回顾：提取行动项并进行情感分析
• 风险检测：自动提醒范围蔓延、速度下降和任务阻塞

多工具集成

• Linear：原生 JSON 导入，并映射 Linear 专属字段
• Jira：支持自定义字段的 REST API 适配器
• GitHub Projects：通过 GraphQL 集成跟踪 Issue／PR
• Azure DevOps：按冲刺层级查询工作项

通知集成

• Slack 通知：节省令牌的 Webhook 集成，支持丰富的区块格式
• MS Teams 通知：为 Microsoft Teams 频道集成自适应卡片
• 可选／默认禁用：使用此技能无需设置，通知需选择启用
• 由用户选择：通过配置或环境变量选择 Slack 或 Teams
• 简洁摘要：50-100 个令牌的通知，仅包含最重要的 3 项风险

智能输出设计

• 上下文检测：自动适配 Claude AI Desktop 或 Claude Code
• 令牌效率：优先提供摘要，再逐步展开详细内容
• 条件提醒：仅在存在问题／风险时显示警告／风险
• 格式优化：Claude AI 使用 Markdown 表格，CLI 使用 ASCII 图表

输入要求

支持的格式

1. JSON（推荐）：

   {
     "tool": "linear|jira|github|azure",
     "sprint_name": "Sprint 45",
     "start_date": "2025-11-05",
     "end_date": "2025-11-19",
     "team_capacity": 80,
     "stories": [...]
   }
   

2. CSV：

   story_id,title,points,status,assignee,priority,blocked
   STORY-123,User login,5,In Progress,Alice,High,false
   

3. YAML：

   sprint:
     name: "Sprint 45"
     team:
       - name: Alice
         capacity: 40
       - name: Bob
         capacity: 40
   

4. 特定工具的导出文件：

   • Linear：从项目视图导出为 JSON
   • Jira：使用 REST API 或导出 CSV
   • GitHub Projects：使用 GraphQL 查询或导出 CSV
   • Azure DevOps：工作项查询结果

必需字段

• 冲刺元数据：name、start_date、end_date、team_capacity
• 用户故事：id、title、points、status、assignee
• 可选：priority、blocked、dependencies、labels、created_date

数据质量

• 故事点必须为数值（斐波那契数列或 T 恤尺码）
• 日期采用 ISO 8601 格式（YYYY-MM-DD）
• 状态值统一为：Todo、In Progress、In Review、Done
• 团队容量以每个冲刺的故事点数表示

输出格式

1. 每日站会（极简）

令牌预算：50-100 个令牌

🚀 Sprint 45 - Day 7/10

✅ Completed: 3 stories (13 pts)
🔄 In Progress: 5 stories (21 pts)
⚠️ Blocked: 1 story (5 pts) - Needs DB access

Velocity: On track (65% complete, 70% time elapsed)

2. 冲刺规划（适度详细）

令牌预算：200-500 个令牌

📊 Sprint 45 Planning Summary

Capacity: 80 pts | Committed: 75 pts | Buffer: 5 pts

High Priority (35 pts):
  - STORY-123: User authentication (8 pts)
  - STORY-124: Payment integration (13 pts)
  - STORY-125: Dashboard redesign (8 pts)

Recommendations:
  1. P0: Address DB access blocker
  2. P1: Reduce scope if velocity drops below 85%
  3. P2: Consider splitting STORY-124 (13 pts is risky)

3. 冲刺评审（完整报告）

令牌预算：500-1000 个令牌

包括：

• 速度趋势（CLI 使用 ASCII 图表，Claude AI 使用表格）
• 燃尽分析及预测完成日期
• 团队绩效指标（吞吐量、周期时间）
• 风险提醒（仅在存在问题时显示）
• 按优先级排序的建议（P0/P1/P2）

4. 回顾分析

令牌预算：300-500 个令牌

🔍 Sprint 45 Retrospective

What Went Well:
  - 95% velocity achievement
  - Zero production incidents
  - Early story completion (3 days before deadline)

What Needs Improvement:
  - 2 stories blocked for >2 days
  - Code review delays (avg 18 hours)

Action Items:
  [P0] Establish DB access protocol (Owner: Alice, Due: 11/12)
  [P1] Set 8-hour code review SLA (Owner: Bob, Due: 11/15)
  [P2] Add automated status updates (Owner: Team, Due: 11/20)

5. 可选 JSON 导出

用于工具集成和仪表板：

{
  "sprint": "Sprint 45",
  "metrics": {
    "velocity": 75,
    "completion_rate": 0.95,
    "cycle_time_avg": 3.2
  },
  "risks": [...],
  "recommendations": [...]
}

使用方法

快速调用

每日站会：

@scrum-master-agent

Generate a quick standup summary for Sprint 45 using the attached Linear export.

冲刺规划：

@scrum-master-agent

Help me plan Sprint 46. Team capacity is 80 points. Here's the backlog (CSV attached).
Prioritize based on effort, value, and risk.

燃尽分析：

@scrum-master-agent

Analyze Sprint 45 burndown. Are we on track? When will we likely finish?
Attached: Jira sprint export (JSON)

回顾：

@scrum-master-agent

Generate retrospective report for Sprint 45. Focus on blockers and cycle time.
Attached: GitHub Projects export (CSV)

容量规划：

@scrum-master-agent

Calculate team capacity for next sprint. Alice is on PTO for 3 days, Bob has 2 days of meetings.
Team size: 4 engineers (40 pts each normally).

高级用法

多工具对比：

Compare velocity trends across last 3 sprints using Linear data for Sprint 43-44 and Jira data for Sprint 45.

风险分析：

Identify high-risk stories in the backlog. Flag anything with >8 points, blockers, or missing dependencies.

自定义指标：

Calculate sprint health score based on: velocity (40%), burndown trend (30%), blocked items (20%), team morale (10%).

脚本

核心模块

• parse_input.py：多格式解析器（JSON/CSV/YAML），支持特定工具的适配器
• tool_adapters.py：Linear、Jira、GitHub、Azure DevOps 集成适配器
• calculate_metrics.py：全部 6 项指标计算（速度、燃尽、容量、优先级、健康度、回顾）
• detect_context.py：环境检测（Claude AI Desktop 与 Claude Code）
• format_output.py：具备上下文感知能力、兼顾令牌效率的报告生成
• notify_channels.py：Slack 和 MS Teams webhook 集成（可选）
• prioritize_backlog.py：结合工作量/价值/风险分析的优先级评分

计算详情

1. 速度分析：

• 最近 3-5 个冲刺的历史平均值
• 趋势分析（提升/下降/稳定）
• 预测下一个冲刺

2. 燃尽跟踪：

• 每日完成的故事点数
• 理想燃尽线计算
• 预测完成日期（线性回归）

3. 容量规划：

• 计算团队可用时间（带薪休假、节假日、会议）
• 故事点分配
• 缓冲建议（容量的 10-20%）

4. 优先级评分：

• 工作量：故事点数（归一化为 0-10）
• 价值：业务影响（高=10，中=5，低=2）
• 风险：阻碍项、依赖关系、复杂度（0-10）
• 公式：priority_score = (value * 2 + (10 - effort) + (10 - risk)) / 4

5. 冲刺健康度评分：

• 速度：实际值与承诺值对比（权重 40%）
• 燃尽：实际值与理想值对比（权重 30%）
• 受阻事项：数量和持续时间（权重 20%）
• 团队士气：可选的情绪输入（权重 10%）
• 等级：0-100（90+ = 优秀，70-89 = 良好，50-69 = 一般，<50 = 有风险）

6. 回顾分析：

• 已完成与已承诺的故事
• 受阻事项分析（数量、持续时间、原因）
• 周期时间指标（从开始到完成的平均时间）
• 从回顾笔记中提取行动项

最佳实践

数据质量

1. 保持故事点估算一致：使用斐波那契数列（1,2,3,5,8,13）或 T 恤尺码（XS=1、S=2、M=3、L=5、XL=8）
2. 准确更新状态：每天更新故事状态（如有可能，可自动化）
3. 跟踪受阻事项：始终记录事项受阻的原因，以及谁能解除阻碍
4. 冲刺边界：第 3 天后绝不更改冲刺范围（关键 Bug 除外）

工作流集成

1. 每日站会：每天早上生成简明摘要（自动化）
2. 冲刺规划：使用优先级评分分配容量最高的 80%
3. 冲刺中期检查：在第 5-7 天运行健康度评分，以便及早发现问题
4. 回顾：在冲刺结束后 24 小时内生成，趁反馈还新鲜时进行

令牌效率

1. 渐进式披露：先从摘要开始，按需提供详情
2. 条件式警报：仅在存在风险时显示（不要报告“没有问题”）
3. 延迟计算：仅在有人请求时计算详细指标
4. 缓存：在多种报告类型之间重复使用计算结果

团队采用

1. 从简单开始：先从每日站会着手，再逐步增加复杂度
2. 自定义阈值：根据团队价值观调整健康度评分权重
3. 自动化输入：设置 CI/CD，自动导出工具数据
4. 持续迭代：根据团队反馈优化优先级评分

局限性

数据要求

• 需要结构化的冲刺数据（不适用于临时工作）
• 必须分配故事点（无法为未估算点数的故事排序）
• 需要历史数据才能分析速度趋势（至少 3 个冲刺）

准确性注意事项

• 优先级评分基于启发式方法，而非 ML 驱动（不具备预测分析能力）
• 燃尽预测假设速度呈线性（不考虑节假日、阻碍项）
• 健康度评分具有主观性，取决于权重配置是否准确

范围边界

• 不提供：与工具直接集成（需要导出数据）
• 不提供：发送通知或更新工具状态（只读）
• 不提供：取代 Scrum Master 的判断（仅辅助决策）

工具专属说明

• Linear：需要手动导出 JSON（此版本不支持 API 密钥）
• Jira：可能需要在 tool_adapters.py 中映射自定义字段
• GitHub Projects：Beta GraphQL API 可能会发生变化（可能需要更新适配器）
• Azure DevOps：工作项层级可能较复杂（导出时请展平）

不适合使用此技能的场景

• 看板工作流：此技能针对 Scrum 冲刺进行了优化（不适用于持续流）
• 非软件项目：优先级评分基于软件开发场景
• 单人团队：对于独立开发者而言，额外开销不值得
• 临时工作：需要结构化的冲刺规划和跟踪

安装

Claude Code（推荐）

cp -r scrum-master-agent ~/.claude/skills/

Claude AI Desktop

将 scrum-master-agent.zip 文件拖入 Claude Desktop。

Claude API

使用 /v1/skills 端点上传技能包。

通知设置（可选）

通知默认禁用，且完全可选。即使不设置通知，此技能也能正常运行。

选项 1：配置文件（推荐）

# Copy example config
cp config.example.yaml config.yaml

# Edit config.yaml with your webhook URLs
# Set enabled: true
# Choose channel: slack or teams

选项 2：环境变量

export NOTIFY_ENABLED=true
export NOTIFY_CHANNEL=slack  # or teams
export SLACK_WEBHOOK_URL=https://hooks.slack.com/services/YOUR/WEBHOOK/URL
export TEAMS_WEBHOOK_URL=https://outlook.office.com/webhook/YOUR/WEBHOOK/URL

获取 Webhook URL：

Slack：

1. 前往 https://api.slack.com/messaging/webhooks
2. 创建应用并启用 Incoming Webhooks
3. 将 webhook 添加到工作区并选择频道
4. 复制 webhook URL

Microsoft Teams：

1. 打开 Teams 频道
2. 点击“...” → Connectors → Incoming Webhook
3. 配置 webhook 名称
4. 复制 webhook URL

使用通知：

@scrum-master-agent

Generate daily standup summary and send notification to Slack.

通知占用的令牌很少（最多 50-100 个令牌），包含：

• 冲刺名称和状态
• 速度和健康度指标
• 仅显示排名前三的风险（视情况而定）
• 丰富的格式（Slack blocks、Teams Adaptive Cards）

版本

版本：1.1.0（支持通知） 最后更新：2025-11-05 作者：Claude Code Skills Factory 许可证：MIT

支持

如有问题、功能请求或贡献，请参阅此技能的 GitHub 仓库，或联系 Skills Factory 维护者。