name: scrum-master-agent description: 综合Scrum Master助手，用于冲刺计划、待办事项梳理、回顾会议、能力规划和每日站会，具有智能上下文感知报告功能

Scrum Master Agent

为SaaS初创公司和应用工程团队设计的即用型Scrum Master助手。此技能提供智能冲刺分析、能力规划、待办事项优先级排序和可操作的洞察，具有高效令牌、上下文感知输出格式化。

功能

冲刺管理

冲刺计划：基于容量的故事分配与速度跟踪
待办事项梳理：优先级评分与努力/价值/风险分析
冲刺健康监控：实时燃尽跟踪与预测性提醒
速度分析：历史趋势分析与预测

团队运营

每日站会：超轻型进度总结（50-100令牌）
能力规划：团队可用性计算，包括假期/PTO处理
冲刺回顾：行动项提取与情感分析
风险检测：自动提醒范围蔓延、速度下降、阻塞任务

多工具集成

Linear：原生JSON导入与Linear特定字段映射
Jira：REST API适配器与自定义字段支持
GitHub Projects：GraphQL集成与问题/PR跟踪
Azure DevOps：工作项查询与冲刺层级

通知集成

Slack通知：高效Webhook集成与丰富的区块格式化
MS Teams通知：Microsoft Teams频道的自适应卡片集成
可选/默认禁用：使用技能无需设置，通知可选加入
用户选择：通过配置或环境变量选择Slack或Teams
简洁摘要：50-100令牌通知，仅包含前3个风险

智能输出设计

上下文检测：自动适应Claude AI桌面与Claude代码
令牌效率：摘要优先方法，逐步披露
条件提醒：仅在存在时显示警告/风险
格式优化：Claude AI的Markdown表格，CLI的ASCII图表

输入要求

支持格式

JSON （推荐）：

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

CSV：

story_id,title,points,status,assignee,priority,blocked
STORY-123,用户登录,5,进行中,Alice,高,false

YAML：

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

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

必填字段

冲刺元数据：名称、开始日期、结束日期、团队容量
故事：id、标题、点数、状态、指派人
可选：优先级、阻塞、依赖项、标签、创建日期

数据质量

故事点数必须是数字（斐波那契或T恤尺寸）
日期为ISO 8601格式（YYYY-MM-DD）
状态值标准化为：待办、进行中、审核中、完成
团队容量为每个冲刺的故事点数

输出格式

1. 每日站会（超轻型）

令牌预算：50-100令牌

🚀 Sprint 45 - 第7天/共10天

✅ 完成：3个故事（13分）
🔄 进行中：5个故事（21分）
⚠️ 阻塞：1个故事（5分） - 需要数据库访问

速度：按计划进行（65%完成，70%时间已过）

2. 冲刺计划（中等细节）

令牌预算：200-500令牌

📊 Sprint 45计划摘要

容量：80分 | 承诺：75分 | 缓冲：5分

高优先级（35分）：
  - STORY-123：用户认证（8分）
  - STORY-124：支付集成（13分）
  - STORY-125：仪表板重新设计（8分）

建议：
  1. P0：解决数据库访问阻塞
  2. P1：如果速度低于85%，则减少范围
  3. P2：考虑拆分STORY-124（13分有风险）

3. 冲刺回顾（完整报告）

令牌预算：500-1000令牌

包括：

速度趋势（CLI的ASCII图表，Claude AI的表格）
燃尽分析与预测完成日期
团队绩效指标（吞吐量，周期时间）
风险提醒（条件 - 仅当存在问题时）
优先级建议（P0/P1/P2）

4. 回顾分析

令牌预算：300-500令牌

🔍 Sprint 45回顾

进展顺利：
  - 95%的速度达成
  - 零生产事故
  - 提前完成故事（比截止日期早3天）

需要改进：
  - 2个故事阻塞超过2天
  - 代码审核延迟（平均18小时）

行动项：
  [P0] 建立数据库访问协议（负责人：Alice，截止日期：11/12）
  [P1] 设定8小时代码审核SLA（负责人：Bob，截止日期：11/15）
  [P2] 添加自动状态更新（负责人：团队，截止日期：11/20）

5. 可选JSON导出

用于工具集成和仪表板：

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

如何使用

快速调用

每日站会：

@scrum-master-agent

为Sprint 45生成快速站会摘要，使用附加的Linear导出。

冲刺计划：

@scrum-master-agent

帮助我计划Sprint 46。团队容量为80分。这是待办事项（附加CSV）。
基于努力、价值和风险进行优先级排序。

燃尽分析：

@scrum-master-agent

分析Sprint 45燃尽。我们是否按计划进行？我们可能什么时候完成？
附加：Jira冲刺导出（JSON）

回顾：

@scrum-master-agent

为Sprint 45生成回顾报告。重点关注阻塞和周期时间。
附加：GitHub Projects导出（CSV）

能力规划：

@scrum-master-agent

计算下个冲刺的团队容量。Alice将休假3天，Bob有2天会议。
团队规模：4名工程师（通常每人40分）。

高级使用

多工具比较：

使用Linear数据比较过去3个冲刺的速度趋势，Sprint 43-44和Jira数据的Sprint 45。

风险分析：

在待办事项中识别高风险故事。标记任何超过8分的、有阻塞的或缺少依赖项的。

自定义指标：

基于以下计算冲刺健康得分：速度（40%）、燃尽趋势（30%）、阻塞项（20%）、团队士气（10%）。

脚本

核心模块

parse_input.py：多格式解析器（JSON/CSV/YAML），具有工具特定适配器
tool_adapters.py：Linear、Jira、GitHub、Azure DevOps的集成适配器
calculate_metrics.py：所有6个指标计算（速度、燃尽、容量、优先级、健康、回顾）
detect_context.py：环境检测（Claude AI桌面与Claude代码）
format_output.py：上下文感知报告生成，具有令牌效率
notify_channels.py：Slack和MS Teams webhook集成（可选）
prioritize_backlog.py：基于努力/价值/风险分析的优先级评分

计算细节

1. 速度分析：

过去3-5个冲刺的历史平均值
趋势分析（提高/下降/稳定）
下个冲刺的预测

2. 燃尽跟踪：

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

3. 能力规划：

团队可用性计算（PTO、假期、会议）
故事点分配
缓冲推荐（容量的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,2,3,5,8,13）或T恤尺寸（XS=1, S=2, M=3, L=5, XL=8）
准确的状态更新：每天更新故事状态（如果可能，自动化）
阻塞项跟踪：始终记录为什么项目被阻塞以及谁能解除阻塞
冲刺边界：冲刺开始后第三天不要改变冲刺范围（紧急错误除外）

工作流集成

每日站会：每天早上生成轻型摘要（自动化）
冲刺计划：使用优先级评分分配前80%的容量
冲刺中期检查：在第5-7天运行健康得分以早期发现问题
回顾：在冲刺结束24小时内生成，反馈新鲜

令牌效率

逐步披露：从摘要开始，按需提供细节
条件提醒：仅在存在时显示风险（不要报告"无问题"）
延迟计算：仅在被询问时计算详细指标
缓存：在多种报告类型之间重用计算

团队采纳

从简单开始：从每日站会开始，逐渐增加复杂性
自定义阈值：根据团队价值观调整健康得分权重
自动化输入：设置CI/CD自动导出工具数据
迭代：根据团队反馈完善优先级评分

限制

数据要求

需要结构化的冲刺数据（不适合临时工作）
必须分配故事点（不能优先考虑未分配点的故事）
需要历史数据进行速度趋势（至少3个冲刺）

准确性考虑

优先级评分基于启发式，不是ML驱动（没有预测分析）
燃尽预测假设线性速度（不考虑假期、阻塞）
健康得分主观，取决于准确的权重配置

范围边界

不：直接与工具集成（需要导出）
不：发送通知或更新工具状态（只读）
不：取代Scrum Master判断（增强决策）

工具特定说明

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

何时不使用此技能

Kanban工作流：此技能针对Scrum冲刺优化（不是连续流）
非软件项目：优先级评分假设软件开发背景
单人团队：对于单独开发人员来说，开销不合理
临时工作：需要结构化的冲刺计划和跟踪

安装

Claude代码（推荐）

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

Claude AI桌面

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

Claude API

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

通知设置（可选）

通知默认禁用，完全可选。没有通知设置，技能也可以完美工作。

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

# 复制示例配置
cp config.example.yaml config.yaml

# 编辑config.yaml，输入您的webhook URLs
# 设置enabled: true
# 选择频道：slack或teams

选项2：环境变量

export NOTIFY_ENABLED=true
export NOTIFY_CHANNEL=slack  # 或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 URLs：

Slack：

访问https://api.slack.com/messaging/webhooks
创建应用并激活Incoming Webhooks
添加webhook到工作区并选择频道
复制webhook URL

Microsoft Teams：

打开Teams频道
点击“…” → 连接器 → 传入Webhook
配置webhook名称
复制webhook URL

使用通知：

@scrum-master-agent

生成每日站会摘要并发送通知到Slack。

通知是高效的（最多50-100令牌），包括：

冲刺名称和状态
速度和健康指标
前3个风险（条件）
丰富的格式化（Slack区块，Teams自适应卡片）

版本

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

支持

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