Long Run Agent

LRA - AI Agent Task Manager v5.3.0

**规范驱动 + 任务管理 + 质量保障系统 + 迭代阶段引导**

核心特性

• 通用任务模型：支持软件开发、小说写作、数据处理等多种场景
• Jinja2 模板：强大的模板引擎，支持条件/循环语法
• 任务依赖：DAG 依赖关系，自动解锁完成的任务
• 优先级调度：P0-P3 优先级，Agent 自评
• 多 Agent 协作：层级锁机制，支持大模型拆分任务、小模型并行开发
• 输出限制感知：根据模型输出能力推荐/拆分任务
• 🆕 Agent 自治初始化 (v3.3.0): 自动预检 + 增量处理 + 文档闭环
• ✨ 质量保障系统 (v5.0.0): 验证机制 + 回归测试 + 代码质量检查
• 🎯 迭代阶段引导 (v4.1.0): 7阶段渐进式优化 + 智能引导 + 安全检查
• 🚀 Constitution机制 (v5.0.0): 规范驱动开发 + 质量门禁 + 不可协商原则
• 🌍 跨平台支持 (v5.0.0): Windows / Linux / macOS 全平台兼容
• 🔄 Relay 全自动接力 (v5.1.0): 任务全自动执行 + 断点续跑 + 多任务串行
• ♻️ 任务跳过/取消/召回 (v5.3.0): 横向生命周期退出——skip 暂缓、cancel 作废（解锁下游）、recall 召回

安装

# 安装（自动包含 Jinja2）
pip install long-run-agent

# 开发环境
pip install long-run-agent[dev]

# 完整安装（包含浏览器测试支持）
pip install long-run-agent[full]

**注意**：安装包名为 `long-run-agent`，命令行工具为 `lra`。

快速开始

# 初始化项目（自动创建Constitution）
cd /your/project
lra init --name "My Project"

# 快速创建+认领任务（推荐）
lra new "实现登录功能"

# 复杂任务：自动拆分+认领第一个子任务
lra new "实现用户认证模块" --auto-split

# 查看Constitution配置
lra constitution show

# Agent 获取上下文
lra context --output-limit 8k

# Agent 上下文重建（推荐）
lra orientation

# 查看项目进度
lra status

♻️ 任务跳过 / 取消 / 召回 (v5.3.0)

并非所有任务都要走到 `completed`。LRA 支持两种**横向生命周期退出**，与正向状态机（pending→in_progress→completed→…）正交：

lra skip  --reason "暂不做：等外部接口"      # 跳过：移出 ready，可召回（下游继续等）
lra cancel  --reason "创建错误/与目标无关"    # 取消：作废，解锁依赖它的任务，可召回
lra recall                                   # 召回 skipped/cancelled 任务回到正常流程

• skip：暂时不做，lra ready 不再显示；依赖它的任务继续等（不解锁）。
• cancel：作废，lra ready 不再显示；依赖它的任务被解锁（视为依赖已了结）。
• 两者都能用 lra recall 恢复；lra list 仍可见（带原因，供审计）。

---

🆕 Constitution功能 (v5.0)

核心概念

Constitution定义项目的**不可协商原则**和**质量标准**，在任务完成前自动验证，确保质量底线。

快速上手

# 1. 查看Constitution使用指南
lra constitution help

# 2. 查看当前配置
lra constitution show

# 3. 验证配置有效性
lra constitution validate

# 4. 创建任务
lra create "实现登录功能"

# 5. 完成任务（自动验证Con