AXIOM：面向编码智能体的本地优先工作流层

AXIOM是围绕任务文件构建的确定性CLI工具，为编码智能体提供本地优先的工作流层。它解决AI编码助手发展中面临的工作流管理、任务可追溯、输出质量保证等挑战，核心设计理念为本地优先与确定性执行，支持git工作树隔离、阶段产物持久化、强制验证与审查门控，以及基于GitHub Releases的透明发布模型，旨在增强人类开发者能力而非替代其判断。

随着AI编码助手和智能体快速发展，开发团队面临工作流管理、任务可追溯、输出质量保证等新挑战。AXIOM提出"本地优先"解决方案，不依赖云端连接或特定模型提供商，通过本地文件和确定性CLI构建可靠工作流层。其核心理念是将工作流状态保存在本地文件系统，带来可移植性（跨智能体主机迁移）、可审计性（文件记录所有状态决策）、离线可用性（无需网络执行）。AXIOM区别于传统提示词包或巨型自主IDE，它不是预设提示词集合或包办一切的IDE，而是围绕任务文件的确定性工作流引擎，职责是强制执行工作流纪律。

AXIOM为每个任务创建Markdown格式任务文件，存储于.axiom/tasks/目录，作为工作的源头（source of truth），记录任务完整生命周期（创建、设计、规划、执行、验证、审查）。任务生命周期通过CLI命令管理：make创建任务、run执行特定阶段（design/plan/execute/verify/review）、finish完成任务、list查看任务列表、show显示详情、diff查看变更对比。显式阶段划分确保工作按既定流程推进，每个阶段有明确进入和退出条件。

对于支持git的代码仓库，AXIOM自动为每个任务配置独立git工作树，确保不同任务代码变更互不干扰，每个任务在独立环境执行。任务创建时记录不可变的base_commit，后续变更相对于该基准点追踪。任务范围的差异对比和变更文件追踪帮助审查者了解实际修改文件，确保变更在计划范围内，即使未跟踪新文件也纳入差异证据。

AXIOM在任务完成前设置强制性验证与审查门控。验证阶段支持运行自动化测试命令，通过工具代理执行，具备策略检查、超时控制、输出捕获限制等功能；审查阶段对比计划写入范围与实际变更范围，记录匹配情况。这些门控是真正阻塞点：若验证失败、文档未解决、无任务差异或变更超出计划范围，AXIOM会返回"changes_requested"或"blocked"状态，确保工作质量，防止未经充分验证的代码进入完成状态。

AXIOM提供命令适配器协议，允许集成本地模型包装器或主机智能体。适配器通过标准输入接收结构化JSON请求，标准输出返回JSON响应，当前支持在run plan、run execute和可选run review阶段调用适配器。项目提供多个参考适配器实现：静态计划适配器、文件写入执行适配器、OpenAI兼容的计划/审查包装器等，使其可与各种本地模型或智能体框架集成，不绑定特定提供商。注意：命令适配器视为受信任本地命令，非沙箱环境，锁定环境建议用适配器白名单或哈希锁定确保安全。

AXIOM采用基于GitHub Releases和GitHub Actions的"源头优先"发布透明度模型，每个标记版本发布wheel、源代码分发包、SHA256SUMS、SBOM.spdx.json及GitHub工件证明，让用户验证二进制文件来源及审查依赖关系，提升供应链安全。适用场景包括需结构化工作流管理的编码项目（多并行任务、严格变更审查、一致工作规范）；部署模式支持：PATH中央安装、内部镜像或伴生仓库、项目本地vendoring。对希望引入AI辅助编码又担心失控的企业团队，AXIOM平衡智能体能力与人工监督。

目前AXIOM已实现核心功能：本地工作流与发布透明度（任务文件生命周期、git工作树配置、阶段产物持久化、命令适配器协议、验证和审查门控等）。项目仍在积极开发，计划功能包括更完善的本地模型服务器集成、可重现构建、原生macOS签名支持。AXIOM代表对AI辅助开发工具的审慎态度：技术应增强人类开发者能力，而非取代判断与责任，通过本地状态保存、强制门控、发布透明度，为协作模式提供坚实基础。