assist - LLM 开发工作流的确定性 CLI 工具

技能简介

@staff0rd/assist 是一款专为 Claude Code / LLM 编程工作流设计的"确定性增强" CLI，作者 Stafford Williams 把它定位为"AI 开发流程的纪律执行者"。它在 assist.yml 里集中声明 Claude Code 的 run command、规则、hook、backlog、Jira/GitHub 集成、Slack 通知等；通过 assist sync 一步把所有声明物（.claude/commands/、.claude/settings.json、CLAUDE.md、git hooks、Slack 配置）从单一源同步到本地仓库，确保团队每位成员、每台机器、每个工作树都在同一套规则下工作。GitHub 8 星、README 6.2 万字（极丰富）、CLI 同时提供 assist 与 ast 两个调用名，适合 5-50 人工程团队把"AI 编程纪律"工具化、版本化。

核心能力

• 集中化规则声明：assist.yml 是 single source of truth，定义 run command、rules、hooks、backlog、Slack channel、Jira board 等；assist sync 一键同步到 .claude/commands/、CLAUDE.md、git hooks 等目标路径，避免散落在多处的设置漂移。
• 丰富的 Claude 命令集：内置 /branch、/bug、/comment、/commit、/devlog、/fix-conflict、/forward-comments、/pr、/prs-slack、/prs-status、/refactor、/prompts、/run-logs、/releases-configure、/refine、/rename、/restructure、/review-config、/review-ci、/review-high-level、/review-pr-comments、/next 等 30+ 个 slash command，覆盖分支、提交、PR、评审、Slack 通知、Jira 同步、release 配置等典型 LLM 开发动作。
• Run 命令注册：/add-command 把团队临时工作流固化为 assist.yml 中的 run command，下次直接 / 调用，沉淀团队最佳实践。
• 规则学习与校对：/add-rule 从 review comment 提取新规则写入 CLAUDE.md；/fix-rules 把历史散落规则归一化为 assist 读取的标准 ## Rules 格式。
• PR 评审编排：/review-ci 安装 GitHub workflow，让 Claude + Codex 通过 LiteLLM 或 Azure AI Foundry 自动评审新 PR，即使不用 assist 也能用；/review-high-level 打开分支 PR 的高层 checklist。
• 多后端集成：原生支持 Slack（prs.slack、prs-status、prs-slack）、Jira（view/associate/update/started/done）、GitHub issue（view/edit/associate/update/started/done）、浏览器扩展（/extension 给安装链接）、本地 devlog（/devlog 生成日记）。
• session 管理：/rename 给 dashboard card 起名；/run-logs 按 session id / group 汇总运行日志；/close 标记 session 结束；/next 串接到 backlog 下个 item。

安装配置

• 环境要求：Node.js 18+（推荐 LTS 20）、Git 仓库、可选 Slack Webhook、Jira API token、GitHub PAT、Claude Code 已登录、LiteLLM 或 Azure AI Foundry（用于 /review-ci）。
• 全局安装：npm install -g @staff0rd/assist，命令名 assist 与别名 ast 同时可用。
• 本地开发：git clone git@github.com:staff0rd/assist.git && cd assist && npm install && npm run build && npm install -g .。

使用步骤

1. 安装与初始化：npm install -g @staff0rd/assist，在 Git 仓库根目录执行 assist sync，把 assist.yml 声明的 commands/rules/hooks 落到本地。
2. 新增 run command：/add-command 让 Claude 通过对话生成新的 run command 条目并写入 assist.yml；下次 assist sync 即生效。
3. 创建分支与 backlog 联动：/branch "feat oauth login" --jira AUTH-123 自动从远程默认分支派生新分支，并在 backlog 中关联 JIRA key。
4. PR 评审自动化：/review-ci 安装 GitHub workflow，让 Claude + Codex 经 LiteLLM/Azure AI Foundry 对每个新 PR 跑自动评审；/review-pr-comments 让 Claude 逐条处理 reviewer 留下的评论。
5. 跨仓 PR 汇总：/prs-status slack #prs-feed myorg/repo1 myorg/repo2，按 repo 维度抓取开放 PR、汇总到指定 Slack 频道。
6. release 配置生成：/releases-configure 根据 .github/workflows/ 推导 release promotion topology，写入 releases.streams。
7. 会话管理：/rename "OAuth Refactor" 给 dashboard card 命名；/close 标记完成；/next 串联到 backlog 下一个 item。

适用场景

• 5-50 人工程团队纪律统一：把团队约定的 LLM 工作流（分支、PR、评审、Slack 通知）固化为 assist.yml，每位成员 assist sync 后行为一致。
• 多 repo 并行管理：用 /prs-status 一次性汇总多个仓库的开放 PR 到 Slack，避免漏看。
• AI 编程快速上手：新人入职后 npm i -g @staff0rd/assist && assist sync 立刻获得 30+ slash command，无需逐个手写 .claude/commands/。
• review 自动化：用 /review-ci 把 Claude + Codex 装进 GitHub Actions，对每个 PR 自动出评审 comment。
• Jira / GitHub Issues 双向同步：在 Claude session 里 /jira view AUTH-123 或 /github edit 42，AI 直接读 ticket 上下文后写代码。
• Slack 集成：完成 PR 时 /prs-slack 自动把 PR 标题+链接发到 prs.slack 频道，团队即时可见。
• devlog 自动化：/devlog 让 Claude 生成当天未版本化的工作日志，供后续写周报/月报。

适用人群

• 中小规模工程团队的 Tech Lead（统一团队 AI 工作流）
• DevOps / 平台工程（自动化 GitHub Actions 评审、Slack 通知、release 配置）
• 多 repo 维护者（跨仓库 PR 状态汇总）
• Jira / GitHub Projects 重度用户（让 AI 直接读写 ticket）
• 写 devlog / 周报的技术 Leader（自动汇总每日工作）
• Claude Code 重度使用者（希望沉淀团队最佳实践为可复用 command）

工作原理

assist 的核心思想是"single source of truth for LLM dev workflow"：所有 Claude Code 行为定义都集中在 assist.yml（run command 列表、rules 文本、hook 脚本、Slack channel、Jira board、GitHub repo 等），assist sync 命令把它编译/复制到 .claude/commands/*.md、.claude/settings.json、CLAUDE.md、.git/hooks/* 等目标位置，确保任何 clone 仓库 + sync 后的开发者都拥有相同的 AI 工具栈。Claude Code 在每个 session 开始时读取 .claude/commands/ 下的 slash command 文件，把它们注册为可用动作；当用户在 session 中执行 /branch ... 等命令时，Claude 读取对应 command markdown 的 prompt 描述并执行。Assist 同时提供 SQLite-like 本地数据库（assist db）、backlog 管理、Slack Webhook、Jira/GitHub API 客户端，让 AI 在对话中直接调用外部系统。整套设计目标是"让 AI 编程行为可声明、可版本、可协作"，避免每个开发者各自调 Claude Code 设置导致团队规范失控。

官方链接

• npm 包：https://www.npmjs.com/package/@staff0rd/assist
• GitHub 仓库：https://github.com/staff0rd/assist
• 作者 devlog：https://staffordwilliams.com/devlog/assist/