AX 提取工作流

ax-extract-workflow
分类通用
作者Agentic Awesome Skills 社区
许可AGPL-3.0-only
评分4.30/5
使用12.1K

ax Extract Workflow

概述

使用此技能来重建过去 coding-agent 产物背后的工作流：例如已交付的功能、PR、Demo、重构、报告或其他具体结果。它利用本地 ax 图谱将提交（commits）、会话（sessions）、轮次（turns）、技能（skills）和工具追踪（tool traces）连接起来，形成一段简短的“这是如何完成的”叙述。

ax 必须已安装且位于 PATH 中，并能访问其本地数据库。如果 ax 无法连接到数据库，请报告连接失败并停止，不要凭记忆猜测。

何时使用此技能

  • 当用户询问“我们是如何构建 X 的？”、“是什么让 X 正常工作的？”或“提取该产物背后的工作流”时使用。
  • 当锚点（anchor）为提交 SHA、日期、功能名称、PR、会话或仓库本地产物时使用。
  • 当用户希望了解导致结果的一系列 agent 技能、提示词、命令、决策和检查步骤时使用。
  • 不要用于通用的活动总结；请使用常规的会话列表（session listing）。

工作原理

第一步：解析锚点

从用户请求中识别最佳锚点：

  • 提交 SHA：直接使用。
  • 日期或日期范围：检查该日期前后的会话。
  • 主题、功能或产物名称：搜索（recall）相关的轮次、提交和技能。
  • “此仓库最近”：列出当前仓库的近期会话。
bash
ax recall "live ingest dashboard" --sources=turn,commit,skill --scope=here
ax sessions near abc1234 --json
ax sessions around 2026-06-15 --days=3 --json
ax sessions here --days=14

这些命令均为只读检查命令。

第二步：筛选相关会话

选择最有可能解释该产物的少数几个会话。优先选择提及该产物、触及相关文件、包含相关提交，或其技能和工具调用与工作内容匹配的会话。

如果存在多个可能的候选会话，请向用户展示候选列表并询问检查哪一个。

第三步：检查会话轨迹

打开每个选定的会话并寻找：

  • 使用的技能及其顺序
  • 用户的引导点和明确的约束条件
  • 改变工作方向的文件、测试和命令
  • 产生关键证据的子 agent 或工具追踪
  • 结果被视为完成前的验证步骤
bash
ax sessions show <session-id> --json
ax sessions show <session-id> --by-role
ax recall "specific keyword from the artifact" --sources=turn,commit --scope=here

第四步：编写重建报告

除非用户要求生成文件，否则请直接在行内返回结果。保持简短且基于证据：

1. 锚点：你解析的日期、提交、功能或产物。
2. 有序工作流：4-8 个步骤，展示所用技能或操作及其产出。
3. 关键决策：改变路径的用户或 agent 选择。
4. 验证：测试、评审、检查或手动证据。
5. 复现简述：再次执行类似工作的精简方案。

在可用时，请使用会话 ID、提交 SHA 和文件路径作为引用。

示例

###
从提交记录还原功能

bash
ax sessions near 8f31c2a --json
ax sessions show <session-id> --by-role
ax sessions show <session-id> --json

输出格式：

text
锚点：8f31c2a, live ingest dashboard

工作流：
1. 问题定义 -> 将故障范围缩小至仪表盘轮询失效。
2. 会话回溯 -> 找到了早期的 ingest-stream 设计及其约束。
3. 功能实现 -> 连接了服务器事件总线与浏览器订阅。
4. 验证 -> 运行类型检查并在本地刷新仪表盘。


复现简述：
从故障产物开始，寻找附近的会话，检查按角色分组的技能，然后总结从定义到验证的最短有序路径。

围绕日期还原工作

bash
ax sessions around 2026-06-15 --days=2 --json
ax recall "otel receiver" --sources=turn,commit,skill --scope=here

适用于用户记得工作时间但忘记提交记录的情况。

最佳实践

  • 从最具体的锚点开始：SHA 优于日期，日期优于模糊的主题。
  • 将 ax 视为唯一事实来源；不要虚构缺失的技能、成本、命令或决策。
  • 谨慎引用，仅在用户决策或命令对还原至关重要时才使用。
  • 保护私有会话详情；采用总结形式而非直接导出日志。
  • 将“发生了什么”与“下次如何重复”分开。

局限性

  • 需要本地安装并可访问 ax 数据库。
  • 仅能看到 ax 已摄取的会话、提交、技能和工具追踪记录。
  • 当代理提供商省略工具输出、成本或推理数据时，会话数据可能不完整。
  • 还原的是工作流而非正确性；在做出工程决策时，仍需检查代码并运行项目检查。

安全与防护注意事项

  • 不要上传私有会话记录、日志、提示词、工具输出或本地数据库导出文件。
  • 在总结中脱敏密钥、Token、客户数据、文件内容和私有对话文本。
  • 除非用户明确要求执行维护操作，否则仅使用只读的 ax 检查命令。
  • 在还原过程中，不要运行会修改 .ax/、重新生成索引、发布报告或更改仓库的命令。

相关技能

  • @agenttrace-session-audit - 用于本地代理会话的健康状况、成本、延迟和工具故障审计。
  • @domain-modeling - 当还原过程揭示了需要记录的术语或架构决策时使用。
  • @planning-with-files - 当用户希望将还原的方案转化为带有追踪笔记的新计划时使用。