Async Issue Manager — AI skill for Claude Code

🎯 Async Issue Manager

**上班前丢任务，下班后看结果。** 纯本地异步任务管理系统，让 AI Agent 在你不在线时自动工作。

为什么需要这个？

大多数人用 AI Agent 的方式是"坐在电脑前，一问一答"。但如果你是上班族呢？

❌ 传统方式：人盯着 Agent 干活，效率 = 你在线的时间
✅ 异步方式：丢任务就走，Agent 自己调度、执行、归档

这个系统让你的 Agent 像一个**自动运转的小团队**——你自己配置有哪些 Agent、各自擅长什么，系统按标签自动派活。

工作流

    你随口说一句 → 自动建 Issue（排优先级、打标签）
         ↓
    每小时闹钟响 → 主 Agent 扫待办篮子、按标签派活
         ↓
    子 Agent 各自执行 → 完成后 Issue 自动关单
         ↓
    你下班看 closed/ → 全是今天的成果
                    ┌──────────▼────────────┐
                    │   🌙 晚上下班         │
                    │   看结果 → 发推        │
                    └───────────────────────┘

旁路还有：

• 🔍 巡查系统：自动发现代码问题，能修的直接修
• 📦 Git 管理：纯本地，不依赖外部服务

特性

• 纯本地 — .issues/ 目录 + Git，不依赖 GitHub Issues / Jira / Notion
• 自动巡查 — 每天自动扫描代码问题、文档过期、未使用资源
• 智能调度 — 不是死板规则，指挥官 Agent 根据上下文判断派活
• 自动去重 — 相同问题不会重复建 Issue
• 文档同步检查 — 代码改了文档没更新？自动检测并建 Issue
• Git 可追溯 — 每个 Issue 的生命周期完整记录

快速开始

1. 安装

# 在 OpenClaw 工作区创建目录结构
mkdir -p .issues/{open,in-progress,closed}

# 方式 A: 作为 Skill 安装（推荐）
cp -r async-issue-manager/ /skills/

# 方式 B: 直接复制脚本到工作区
cp -r async-issue-manager/scripts/* /scripts/issues/

2. 创建第一个 Issue

python3 scripts/manager.py create \
  --title "测试异步任务系统" \
  --body "验证 Issue 创建 → 分配 → 关闭的完整流程" \
  --priority P2 \
  --labels test

3. 配置 Cron 自动调度

在 OpenClaw 中配置 cron：

{
  "schedule": { "kind": "cron", "expr": "0 * * * *" },
  "payload": { "kind": "systemEvent", "text": "issue-hourly-dispatch" },
  "sessionTarget": "main"
}

或使用系统 crontab：

0 * * * * cd /workspace && bash scripts/auto-dispatch.sh

4. 查看结果

# 看有哪些任务
python3 scripts/manager.py list --status open
python3 scripts/manager.py list --status closed

# 看某个任务详情
python3 scripts/manager.py show 1

目录结构

.issues/                          # Issue 存储
├── open/                         # 待处理
├── in-progress/                  # 进行中
├── closed/