ArcKit /arckit:backlog 实战:如何把需求一键转成 GDS 用户故事,节省 75% 冲刺规划时间
【免费下载链接】arc-kitThe Enterprise Architecture Governance Harness — strategy, architecture, delivery, and assurance using AI coding assistants项目地址: https://gitcode.com/GitHub_Trending/ar/arc-kit
ArcKit 是一个面向企业架构治理的 AI 工作流工具包(Enterprise Architecture Governance Harness)。它内置的/arckit:backlog命令可以扫描项目里已有的需求文档,把 BR/FR/NFR 等需求项自动转换成 GDS(英国政府数字服务)格式的用户故事,再按团队速度(velocity)自动排入冲刺(Sprint),最终导出 Markdown、CSV、JSON 三种格式,让你把冲刺规划从 4-6 周压缩到 3-5 天。
/arckit:backlog 是什么?
一句话概括:它是你的"AI 产品负责人",负责把散落在架构文档里的需求,变成开发团队可以直接开工的冲刺待办列表(Sprint-ready Backlog)。
它会自动完成五件事:
| 步骤 | 自动动作 | 对新手意味着什么 |
|---|---|---|
| 1️⃣ 需求转故事 | BR → Epic,FR → 用户故事,NFR → 技术任务 | 不用再手工"翻译"每条需求 |
| 2️⃣ GDS 格式故事 | 生成"作为…我想要…以便…" + 验收标准 | 故事直接符合 GDS 规范 |
| 3️⃣ 多维排序 | MoSCoW + 风险 + 价值 + 依赖四因子打分 | 优先级有依据,不靠拍脑袋 |
| 4️⃣ 冲刺切分 | 按速度规划 8 个冲刺,平衡工作类型 | 排期自动完成 |
| 5️⃣ 全程可追溯 | 需求 → 故事 → 冲刺 → 代码 | 审计时随时能对上号 |
命令定义见 backlog.md,快速入门指南见 docs/guides/backlog.md。
运行前准备:3 份必备输入
/arckit:backlog不是凭空生成故事的,它依赖项目里已有的工件(artefacts)。运行前请确认:
必备(缺失会警告):
- 📄需求文档
ARC-<id>-REQ-v1.0.md—— 包含 BR/FR/NFR/INT/DR 编号的需求,是故事的"原料"(可用 /arckit:requirements 生成) - 📐已批准的 HLD/DLD—— 确保故事引用的是真实组件
- 👥干系人分析—— 提供写故事用的"persona(角色)"
强烈建议:风险登记册(用于优先级)、商业论证(用于价值评估)、可追溯性矩阵(用于查缺)。
需求如何变成用户故事?
这是/arckit:backlog最核心的能力。不同类型的编号需求会被映射成不同形态的待办项:
| 需求类型 | 转换成 | 说明 |
|---|---|---|
| BR(业务需求) | Epic | 一个业务目标对应一个史诗 |
| FR(功能需求) | 用户故事(GDS 格式) | 开发团队的主力工作项 |
| NFR(非功能需求) | 技术任务 | 性能、安全、无障碍等 |
| INT(集成需求) | 集成故事 | 系统间对接 |
| DR(数据需求) | 数据任务 | 数据模型相关 |
生成的故事遵循 GDS 标准句式,并且验收标准是可度量的:
As a[persona]I want[capability]So that[goal]
验收标准:
- 当 [可度量结果 1] 时视为完成
- 当 [可度量结果 2] 时视为完成
比如一条"系统需支持用户重置密码"的 FR,会被自动改写成"作为一位注册用户,我想要通过邮箱链接重置密码,以便在忘记密码时仍能登录",并附上两条"It's done when…"验收标准。角色名会自动从干系人分析中取 persona,无需你手动填写。故事模板参考 story-template.md。
冲刺规划:5 个可调参数
默认配置是8 个冲刺、每冲刺 20 故事点,你可以按团队实际容量微调:
/arckit:backlog # 默认:8 个冲刺,每个 20 点 /arckit:backlog VELOCITY=25 SPRINTS=12 FORMAT=all /arckit:backlog PRIORITY=risk # 其他选项:value、moscow、multi| 参数 | 默认值 | 作用 |
|---|---|---|
SPRINT_LENGTH | 2 周 | 单冲刺时长(1w/2w/3w/4w) |
SPRINTS | 8 | 规划多少个冲刺 |
VELOCITY | 20 点/冲刺 | 团队速度,决定装得下多少故事 |
FORMAT | markdown | 可选 csv、json、all |
PRIORITY | multi(多维) | 也可单选 moscow、risk、value、dependency |
规划时它还遵守两条"老法师"规则:
- ⚖️工作类型配比:约 60% 功能、20% 技术任务、15% 测试、5% 缓冲,避免冲刺全塞满功能
- 🔗依赖顺序:认证(auth)类基础能力一定排在功能之前
输出物:一份文档 + 三种格式,直通 Jira / Trello
运行完成后,产物落在projects/<id>/ARC-<id>-BKLG-v1.0.*。主文档结构参考 backlog-template.md,包含:
- 📊执行摘要:故事总数、Epic 数、总故事点、预计周数
- 🏷️优先级分布:Must / Should / Could 各占多少点
- 🗂️Epic 分组:每个 Epic 关联 BR 编号、风险等级、业务价值
- 📅冲刺切片:每个冲刺的故事列表,高风险项自动前置到 Sprint 1-2
- 👀分角色使用说明:产品负责人、开发团队、Scrum Master 各看什么
如果你用协作工具,CSV/JSON 可以直接导入Jira、Azure DevOps 或 Trello。项目里甚至内置了 /arckit:trello 命令,作为 backlog 的官方交接(handoff),一键把待办列表变成 Trello 看板;做完冲刺后再用 /arckit:traceability 反向核对"每条需求是否都有故事覆盖"。
完整工作流:从需求到看板只需 5 步
| 阶段 | 操作 | 耗时 |
|---|---|---|
| 1. 备料 | 确认需求、HLD/DLD、干系人分析是最新的 | 依赖既有工件 |
| 2. 运行命令 | 选择匹配团队容量的 VELOCITY / SPRINTS | 分钟级 |
| 3. 审查导出 | 检查 Epic 分组、依赖关系、MoSCoW 标签 | 半天 |
| 4. 冲刺微调 | 根据变更冻结 / 合规窗口调整冲刺边界 | 半天 |
| 5. 导入工具 | CSV/JSON 进 Jira / Azure DevOps / Trello | 分钟级 |
对比传统做法——产品负责人逐条手写故事、反复开会排优先级、手工估点——官方给出的数据是节省 75% 以上的时间(4-6 周 → 3-5 天)。剩下的时间可以用来做更有价值的事:和用户验证故事、打磨验收标准。
写在最后
/arckit:backlog的价值不在"自动生成文字",而在于它把需求 → 故事 → 冲刺 → 代码这条追溯链自动维护好了:每条故事都挂回需求编号,每个 Epic 都对应业务目标,验收标准还会自动带上 WCAG、GDPR 等合规约束。
对新手来说,最实用的上手路径是:先用/arckit:requirements生成需求文档,再跑一次/arckit:backlog,最后用/arckit:trello看看"AI 产品负责人"排出来的冲刺长什么样——整个过程不用写一行代码。
📌 相关入口:命令定义 backlog.md | 快速指南 docs/guides/backlog.md | Backlog 模板 backlog-template.md | Trello 交接 trello.md
【免费下载链接】arc-kitThe Enterprise Architecture Governance Harness — strategy, architecture, delivery, and assurance using AI coding assistants项目地址: https://gitcode.com/GitHub_Trending/ar/arc-kit
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考