scrum-assistant

单人使用的本地 Scrum Portal：把 Jira、Confluence、GitLab、飞书会议转录、本地 Obsidian 知识库聚合到一面看板，并用本地 AI agent 把重复的 Scrum 仪式产出（会议纪要、sprint planning/review 材料、bug 分析、架构评审、code review、发布检查）自动化。

它不是任务系统，不是 Jira 的替代品——它是一面镜子（数据可疑面板）加一个产出器 （Ceremony 人工确认暂存区，AI 产出必须过人工确认才落知识库）。

要求

• Node.js >= 24（原生运行编译后 JS + 内置 node:sqlite，无需 Docker、无需数据库）
• 可选：git（仪式发布到 vault、MR diff 抓取）、本机 AI agent CLI（跑仪式用）

安装

npm install -g scrum-assistant

快速开始

mkdir ~/scrum-assistant && cd ~/scrum-assistant
# 建一个 .env，至少填 JIRA_TOKEN（模板见下）
scrum-assistant            # http://127.0.0.1:8787

配置与数据跟着「启动目录」走：.env 从启动目录读，SQLite 数据默认建在启动目录的 data/。全局包目录是只读的，升级（npm update -g scrum-assistant）不影响配置与数据。

.env 模板（完整版见包内 INSTALL.md，或安装后包根目录的 .env.example）：

# 必填：Jira 只读访问（工具只发 GET，绝不回写）
JIRA_TOKEN=你的 token
JIRA_BOARD_ID=3041
JIRA_BASE_URL=https://your-jira.example.com

# 角色：primary 跑定时任务、发飞书推送（全网只能有一个）；其余一律 workstation
ROLE=workstation

# 可选：Confluence / GitLab / 飞书 webhook / vault / 定时任务表达式
# CONFLUENCE_BASE_URL=  CONFLUENCE_TOKEN=
# GITLAB_BASE_URL=      GITLAB_TOKEN=   GITLAB_REPOS_DIR=
# FEISHU_WEBHOOK_URL=   FEISHU_WEBHOOK_SECRET=
# VAULT_PATH=           CODE_REPO_PATH=
# CRON_SYNC=*/15 * * * *   CRON_DIGEST=30 17 * * 1-5
# APP_PASSWORD=         （监听非本机地址时必设）

关键设计

• 只读铁律：绝不回写 Jira / Confluence；要回写就生成可粘贴文案交给人
• 人工确认门：LLM 产出必须经人工确认才落 vault、才进行动项
• 三态诚实：拿不到的数据显式说「数据缺口」，绝不用 0 或空表蒙混
• 降级一等公民：未配置飞书 webhook 时，每日简报生成可粘贴文案，照样可用

文档

包内 INSTALL.md 有完整的安装与配置说明（含 Windows）。