自主技能 - 长时间运行任务执行

使用双代理模式（初始化器+执行器）配合自动会话延续，跨多个会话执行复杂、长时间运行的任务。

目录结构

所有任务数据存储在项目根目录下的 .autonomous/<任务名称>/ 中：

项目根目录/
└── .autonomous/
├── build-rest-api/
│ ├── task_list.md
│ └── progress.md
├── refactor-auth/
│ ├── task_list.md
│ └── progress.md
└── ...

这允许多个自主任务并行运行而不会产生冲突。

工作流程概览

用户请求 → 生成任务名称 → 创建 .autonomous/<任务名称>/ → 执行会话

步骤 1：初始化任务目录

根据用户描述生成任务名称并创建目录：

bash

生成任务名称（小写、连字符、最多30个字符）

示例：Build a REST API for todo app → build-rest-api-todo

TASKNAME=$(echo $USERTASK | tr [:upper:] [:lower:] | sed s/[^a-z0-9]/-/g | sed s/--*/-/g | cut -c1-30 | sed s/-$//)

创建任务目录

TASKDIR=.autonomous/$TASKNAME mkdir -p $TASK_DIR

echo 任务目录：$TASK_DIR

步骤 2：分析当前状态

检查这是新任务还是继续执行：

bash
TASKDIR=.autonomous/$TASKNAME

查找现有任务列表

if [ -f $TASKDIR/tasklist.md ]; then echo === 继续模式 === echo 找到现有任务：$TASK_DIR

# 显示进度摘要
TOTAL=$(grep -c ^\- \[ $TASKDIR/tasklist.md 2>/dev/null || echo 0)
DONE=$(grep -c ^\- \[x\] $TASKDIR/tasklist.md 2>/dev/null || echo 0)
echo 进度：$DONE/$TOTAL 个任务已完成

# 显示最近的进度记录
echo
echo === 最近进度 ===
head -50 $TASKDIR/tasklist.md
else
echo === 新任务模式 ===
echo 正在创建新任务：$TASK_DIR
mkdir -p $TASK_DIR
fi

步骤 3：选择代理模式

对于新任务（初始化器模式）

如果任务目录中不存在 task_list.md：

bash
SKILLDIR=${CLAUDEPLUGIN_ROOT}/skills/autonomous-skill
TASKDIR=.autonomous/$TASKNAME

读取初始化器提示模板

INITIALIZERPROMPT=$(cat $SKILLDIR/templates/initializer-prompt.md)

执行初始化器会话

claude -p 任务：$USERTASKDESCRIPTION 任务目录：$TASK_DIR

$INITIALIZER_PROMPT \
--output-format stream-json \
--max-turns 50 \
--append-system-prompt 你是初始化器代理。请在 $TASKDIR 目录中创建 tasklist.md 和 progress.md 文件。

对于继续执行（执行器模式）

如果任务目录中存在 task_list.md：

bash
SKILLDIR=${CLAUDEPLUGIN_ROOT}/skills/autonomous-skill
TASKDIR=.autonomous/$TASKNAME

读取执行器提示模板

EXECUTORPROMPT=$(cat $SKILLDIR/templates/executor-prompt.md)

读取当前状态

TASKLIST=$(cat $TASKDIR/task_list.md) PROGRESS=$(cat $TASK_DIR/progress.md 2>/dev/null || echo 无之前的进度记录)

执行执行器会话

claude -p 继续处理任务。 任务目录：$TASK_DIR

当前 task_list.md：
$TASK_LIST

之前的进度记录：
$PROGRESS

$EXECUTOR_PROMPT \
--output-format stream-json \
--max-turns 100 \
--append-system-prompt 你是执行器代理。请完成 $TASK_DIR 目录中的任务并更新文件。

步骤 4：自动继续循环

每个会话完成后，检查剩余任务并自动继续：

bash
#!/bin/bash
TASKDIR=.autonomous/$TASKNAME
AUTOCONTINUEDELAY=3
SESSION_NUM=1

while true; do
echo
echo ==========================================
echo 会话 $SESSIONNUM - 任务：$TASKNAME
echo ==========================================

# 运行相应的代理
# ... 执行会话 ...

# 检查完成情况
if [ -f $TASKDIR/tasklist.md ]; then
TOTAL=$(grep -c ^\- \[ $TASKDIR/tasklist.md 2>/dev/null || echo 0)
DONE=$(grep -c ^\- \[x\] $TASKDIR/tasklist.md 2>/dev/null || echo 0)

echo
echo === 进度：$DONE/$TOTAL 个任务已完成 ===

if [ $DONE -eq $TOTAL ] && [ $TOTAL -gt 0 ]; then
echo
echo 所有任务已完成！退出。
break
fi
fi

# 自动继续并延迟
echo
echo 将在 $AUTOCONTINUEDELAY 秒后继续...（按 Ctrl+C 暂停）
sleep $AUTOCONTINUEDELAY

SESSIONNUM=$((SESSIONNUM + 1))
done

步骤 5：报告进度

执行完成后，显示清晰的进度报告：

==========================================
会话完成 - 任务：build-rest-api
==========================================

任务目录：.autonomous/build-rest-api/

本次会话完成的任务：

• - [x] 任务 5：实现用户认证
• [x] 任务 6：添加登录表单验证

总体进度：18/50 个任务（36%）

下一个任务：

• - [ ] 任务 7：创建密码重置流程
• [ ] 任务 8：添加会话管理

将在 3 秒后继续...（按 Ctrl+C 暂停）

使用示例

示例 1：开始新任务

用户：请使用自主技能为待办事项应用构建一个 REST API

响应：

1. 1. 生成任务名称：build-rest-api-todo
2. 创建目录：.autonomous/build-rest-api-todo/
3. 正在运行初始化器代理...
4. 创建了包含 25 个任务的 task_list.md
5. 进度：3/25 已完成
6. 将在 3 秒后自动继续...

示例 2：继续现有任务

用户：继续自主任务 build-rest-api-todo

响应：

1. 1. 找到任务：.autonomous/build-rest-api-todo/
2. 当前进度：15/25 个任务
3. 正在运行执行器代理...
4. 完成任务 16-17
5. 进度：17/25 已完成
6. 将在 3 秒后自动继续...

示例 3：列出所有任务

bash

列出所有自主任务

ls -la .autonomous/

显示特定任务的进度

cat .autonomous/build-rest-api-todo/task_list.md

关键文件

对于 .autonomous/<任务名称>/ 中的每个任务：

文件	用途
task_list.md	主任务列表，带复选框进度
progress.md

逐会话的进度记录 |

重要说明

1. 1. 任务隔离：每个任务有独立目录，无冲突
2. 任务命名：根据描述自动生成（小写、连字符）
3. 任务列表神圣不可侵犯：切勿删除或修改描述，仅标记 [x]
4. 每次会话一个任务：专注于彻底完成任务
5. 自动继续：会话以 3 秒延迟自动继续；按 Ctrl+C 暂停

故障排除

问题	解决方案
找不到任务	检查 .autonomous/ 中的现有任务
多个任务

明确指定任务名称 | | 会话卡住 | 检查任务目录中的 progress.md | | 需要重新开始 | 删除任务目录并重新开始 |