Acahti v0.16.2
EN中文GitHub自托管

Acahti产品理念

追踪是主线

每个工单、待办、迭代和失败的测试都是一条流程。追踪根据它留下的记录,把它从提出跟到上线;工作进展是读出来的。

交付一个改动会碰到很多记录:一个工单、迭代里的一个待办、一个分支和一个 PR、几条流水线、一次测试运行、一次交付和它的标签。通常它们分散在四五个工具里,还要有人手动让工单系统跟上代码的进展。Acahti 把它们都放在同一个实例里,于是能把每项工作串成一条线:追踪(Track)。

流程与阶段#

流程是被一路跟踪的一项工作。工单、待办、迭代、交付和失败的 Argos 用例各有一条流程。每条流程都沿着同样的八个阶段、按以下顺序前进:

  1. 提交工单
  2. 规划待办、迭代、文档
  3. 进行中待办状态
  4. 评审PR
  5. 构建流水线
  6. ArgosArgos 运行
  7. 交付交付、标签流水线
  8. 发布发布、验证通过的工单

一条流程显示它的类型所需的阶段(缺陷、需求、待办、运维工作、Argos 用例、迭代),以及其他有依据的阶段。工作管理员可以调整某个类型的模板,也可以在实际情况不同时调整单条流程。阶段和模板详见追踪。

证据推动流程#

某个阶段的记录出现时,流程就到达这个阶段。每个阶段处于已完成、当前、未开始、失败或已跳过状态,未完成的流程会报告它已经卡了多久。没有人需要让某个状态字段跟上代码:

  • 写上工作编号,就会自动关联。 PR 的标题、正文或分支里写了 todo#123、ticket#45、todo/123 或 T-123,或者流水线的提交、分支或 PR 写了这些编号,它们就会在「评审」和「构建」下加入对应流程。交付的标签流水线显示在「交付」下。
  • Agent 边做边关联。 skill 要求 Agent 在分支和提交里写上待办编号;planning_todo_links 可以手动关联 PR、流水线或 Argos 运行。
  • 测试结果回传。 流水线中运行 argos run … --dash 的步骤会把运行结果回传到实例;失败的用例会形成自己的流程,从首次失败一直到重新通过。

一切都挂在这条线上#

追踪读取的正是应用其他部分写入的记录,所以每个标签页都是这条线的某一段:

标签页 在主线上的位置
工单 流程在这里被提交,最后在这里被验证
项目与迭代 工作在这里被规划、交付和发布
仓库 分支和 PR:评审
流水线 构建、部署和标签运行
Argos 测试运行,以及作为独立流程的失败用例
知识库 关联到流程的文档,显示在「规划」下
看板 所有这些里此刻需要你处理的事

三种读法#

  • 单项。 每个待办和工单页面都有追踪卡片:阶段线,以及每个阶段何时到达、由谁推动、背后有哪些记录的时间线。
  • 所有进行中的流程。 页头的追踪按项目列出进行中的工作,显示每条流程的阶段、当前阶段和卡住的时长。
  • 一个人。 「人员」视图显示一个人(或一个 Agent)在最近 7、14 或 30 天推动了什么:工作、提交、PR、评审和流水线。

合成示例工作区中的追踪
追踪按项目列出所有进行中的流程,以及它们的阶段、当前阶段和卡住的时长。

Agent 读取的是同一份数据:track_get 返回一条流程,track_list 返回进行中的流程,track_activity 返回一个人的活动。全部视图、筛选和操作见追踪。

供 Agent 读取: mainline.md编辑此页