AUTA — Autonomous Task Automation

AUTA 是平台无关的 AI Agent 任务治理框架。它把需求、版本、Sprint、验证、复审和收尾组织成可追踪的 Plan → Execute → Accept → Review → Finalize 闭环，并通过适配器支持 Codex、Claude Code、OpenCode、Gemini 等宿主。

核心实现由 Bash、Python 3 与 TypeScript/Node.js 组成。源码构建要求 Node.js 20.11 或更高版本；项目工作流还需要 Git、Bash 和 Python 3。

安装与初始化

从 npm 安装稳定包：

npm install -g @infoos/auta
auta --version
auta init /path/to/project

包名中的组织 scope 是必需的；auta 是 npm 公共 registry 上另一个项目， 不要使用 npm install -g auta。

从源码使用：

npm install
npm run build
./bin/auta init -g

npm 包已经同时安装 CLI 和运行时资产，不需要、也不支持再运行 auta init -g。init -g 只属于上面的源码发布入口 ./bin/auta；npm 用户直接初始化目标仓库：

cd /path/to/project
auta init .

默认安装是 global runtime；--link 仅用于明确需要源码联动的开发场景。安装或修复会改变本机运行时，自动化执行前应先取得相应授权。

第一次检查

在已初始化的项目中运行：

auta status
auta ci --mode json
auta doctor --mode json

• auta status 显示当前版本、Sprint 与任务进度。
• auta ci 是统一的快速门禁入口，并以结构化结果区分失败和安装漂移信号。
• auta doctor 深入检查环境及安装态；只有明确需要时才使用 --repair。

版本工作流

auta new --version vX.Y       # 建立受治理的版本计划
auta execute vX.Y             # 按 Sprint、验证和复审门禁推进
auta accept vX.Y              # 独立验收候选实现
auta finalize vX.Y --resume   # 由事务化 finalizer 收尾

执行前先用 auta query status 定位当前真相。版本实现通常在项目内 .worktrees/<version> 隔离；执行租约、lock scope 与 fence 共同保护并发所有权。

生命周期真相

任务完成不等于已经交付（done ≠ shipped），归档也不是发布凭据。只有 finalizer 的交付回执能证明 shipped；禁用推送或尚未完成外部交付时，结果应如实记录为 closed-not-shipped，不得用本地测试通过替代发布事实。

项目文档

源码仓内文档（宪章 / 架构 / 接口）仅在私有仓库中维护，不随 npm 包分发。 消费项目请在目标仓库自建 docs/codebase/（若需要宪章能力）。

贡献与扩展请同时阅读仓内 AGENTS.md 和 CLAUDE.md。skills/、agents/ 是 canonical 单源，平台发现路径中的 symlink 副本不应直接修改。

许可证

本软件采用 PolyForm Noncommercial 1.0.0：个人与非商用可按协议使用；任何商用（含 SaaS / 对外有偿服务 / 商业分发）须另行取得书面授权。商用授权请联系版权方 Foundj / InfoOS。