TPM Copilot

您的AI项目管理助手。从Jira、Linear、GitHub和日历中提取数据——将所有信息综合成状态报告、风险预警、会议准备和利益相关者仪表盘。

设置

依赖项

bash
pip3 install requests

对于GitHub：安装gh命令行工具并进行身份验证（gh auth login）。

API连接（在config.json中配置）

• - Jira — JIRABASEURL、JIRAEMAIL、JIRAAPITOKEN（Atlassian API令牌）
• Linear — LINEARAPIKEY
• GitHub — 使用gh命令行工具（已认证）或GITHUBTOKEN
• Slack — SLACKWEBHOOKURL（用于报告投递）
• 日历 — iCal URL或Google Calendar API

并非所有连接都必须配置——技能会根据已配置的内容自适应。

工作区

tpm/
├── config.json # API密钥、项目设置、团队配置
├── programs/ # 每个项目的数据
│ └── program-name/
│ ├── config.json # 项目特定设置（看板ID、仓库、团队）
│ ├── reports/ # 生成的状态报告
│ ├── risks/ # 风险登记快照
│ └── dependencies/ # 依赖关系图
├── templates/ # 报告模板
├── meetings/ # 会议记录和行动项
└── state.json # 持久化状态（上次检查时间戳等）

运行scripts/init-workspace.sh来创建此结构。

核心工作流

1. 状态报告生成器

核心工作流。从所有已连接的工具提取数据，生成针对特定受众的报告。

bash
scripts/status-report.sh --program my-program --audience exec
scripts/status-report.sh --program my-program --audience eng
scripts/status-report.sh --program my-program --audience full
scripts/status-report.sh --program my-program --audience exec --deliver slack

提取的数据：

• - Jira/Linear：冲刺进度、各状态工单、速度、阻塞项、近期完成项
• GitHub：已合并/开放/停滞的PR、CI状态、发布标签
• 日历：即将到来的里程碑、本周会议

受众格式：

• - exec — 3-5条执行摘要要点、各工作流的RAG状态、主要风险、需要做出的关键决策。不超过200字。
• eng — 冲刺指标、PR审查队列、阻塞项、速度趋势、即将到来的截止日期
• full — 包含所有部分、依赖关系和行动项的全面项目更新

投递选项：

• - stdout（默认）— 打印到终端
• slack — 发布到配置的webhook
• email — 通过Resend/SMTP发送
• confluence — 创建/更新Confluence页面
• file — 保存到programs//reports/

2. 风险与阻塞项雷达

主动扫描潜在问题，防患于未然。

bash
scripts/risk-radar.sh --program my-program
scripts/risk-radar.sh --program my-program --alert # 对新风险发送警报
scripts/risk-radar.sh --program my-program --history # 显示风险趋势

自动检测的风险：

• - 停滞工单 — N天内无更新（可配置，默认5天）
• 阻塞工单 — 状态为阻塞或被标记
• PR审查瓶颈 — PR开放超过48小时未审查
• 冲刺范围蔓延 — 冲刺中期新增工单
• 未兑现承诺 — 从上个冲刺滚动的工单
• CI失败 — 主分支构建失败
• 依赖延迟 — 上游团队的交付物延期

风险登记以JSON格式保存在programs//risks/中：
json
{
id: RISK-001,
severity: high,
category: delivery,
title: Auth服务迁移因Team B API而阻塞,
detected_at: 2026-02-24,
source: jirablockedticket,
ticket: PROJ-1234,
status: open,
mitigation: ,
owner:
}

3. 会议自动驾驶

自动化会议准备、记录处理和后续跟踪。

bash
scripts/meeting-prep.sh --program my-program --type standup
scripts/meeting-prep.sh --program my-program --type sprint-review
scripts/meeting-prep.sh --program my-program --type exec-sync
scripts/meeting-prep.sh --program my-program --type program-review

scripts/process-notes.sh --file meeting-notes.md # 提取行动项
scripts/action-tracker.sh --program my-program # 显示逾期行动项
scripts/action-tracker.sh --program my-program --create-tickets # 为行动项创建Jira工单

会议类型和自动生成的议程：

• - standup — 昨天完成项、今天重点、阻塞项（来自Jira）
• sprint-review — 冲刺指标、已完成工作、演示、遗留项
• exec-sync — 项目RAG、主要风险、需要做出的决策、时间线状态
• program-review — 完整工作流状态、依赖关系、资源需求

记录处理：

• - 解析Markdown记录中的行动项（以AI:、TODO:、ACTION:或[ ]开头的行）
• 提取负责人和截止日期
• 可选地创建Jira/Linear工单
• 跨会议跟踪完成状态

4. 依赖关系跟踪器

映射和监控跨团队依赖关系。

bash
scripts/dependency-map.sh --program my-program # 生成依赖关系图
scripts/dependency-map.sh --program my-program --check # 检查延期情况
scripts/dependency-map.sh --program my-program --alert # 对有风险的依赖关系发出警报

来源：

• - Jira工单链接（阻塞/被阻塞）
• Jira/Linear标签（例如depends-on:team-b）
• programs//dependencies/deps.json中的手动条目

输出：

• - 带状态的Markdown依赖关系表
• 关键路径高亮
• 上游依赖延期时发出警报

5. 项目仪表盘

项目健康状况的快速终端仪表盘。

bash
scripts/dashboard.sh --program my-program

显示：

• - 总体RAG状态
• 冲刺进度（完成百分比、剩余天数）
• 按严重程度分类的开放风险
• PR审查队列
• 即将到来的里程碑
• 逾期的行动项

配置

项目配置（programs//config.json）

json
{
name: Project Phoenix,
workstreams: [
{
name: Backend,
jira_project: PHX,
jiraboardid: 123,
github_repos: [org/backend-api],
team_lead: Alice
},
{
name: Frontend,
jira_project: PHX,
jiraboardid: 124,
github_repos: [org/web-app],
team_lead: Bob
}
],
milestones: [
{name: Alpha Release, date: 2026-03-15, status: on-track},
{name: Beta Release, date: 2026-04-30, status: on-track}
],
stakeholders: {
exec: [vp-eng@company.com],
eng: [#eng-phoenix-slack-channel],
full: [phoenix-team@company.com]
},
settings: {
staleticketdays: 5,
prreviewthreshold_hours: 48,
sprintlengthweeks: 2,
tracker: jira
}
}

跟踪器选择

将settings.tracker设置为jira或linear。脚本会自动适配相应的API调用。

Cron集成

• - 每日站会准备 — 在站会前8:30生成
• 每日风险扫描 — 在一天结束时运行，对新风险发出警报
• 每周状态报告 — 周一上午生成并投递
• 行动项跟进 — 每日检查逾期项
• 冲刺边界 — 在冲刺最后一天自动生成冲刺审查数据

参考文档

• - references/jira-setup.md — Jira API身份验证和项目配置