hotjp

Long Run Agent — AI skill for Claude Code

AI community

🔧 LRA - AI Agent长任务超稳定执行框架 ⚡ 轻量 pip一键安装｜突破上下文限制 📌 7种状态管理 Long-Running AI Agent Framework • One-click pip install｜Break context barriers • 7-status management.

How to install Long Run Agent

This entry records only its repository, not the path inside it, so there is no exact command to give. Open hotjp/long-run-agent and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Long Run Agent does

🔧 LRA - AI Agent长任务超稳定执行框架 ⚡ 轻量 | pip一键安装｜突破上下文限制 📌 7种状态管理 | Long-Running AI Agent Framework • One-click pip install｜Break context barriers • 7-status management. 5.0全面支持CLAUDE/OPEN CLAW/OPEN CODE/CUSOR/TREA 等全部Agent编程工具，仅需运行 lra init命令，就会生成Agent.md/CLAUDE.md/lra.md. 你的agent会自动学会如何使用

Alternatives in AI

OpenSpace — "OpenSpace: The Skill Management Layer for AI Agents" -- https://open-space.cloud/ 7.5k ★
EchoBird — One-click install + model switch:Claude Code,Codex CLI (OpenAI), Grok Build (xAI), DeepSeek Harness, Kimi Code 3.1k ★
Paritok 4b V1 — Non-destructive compression gateway for AI coding agents 1.4k ★

README

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