name: piter-setup description: 为AFK（离开键盘）代理系统设置PITER框架元素。用于配置自主代理工作流的提示输入源、触发器、环境和审查过程。 allowed-tools: Read, Grep, Glob

PITER 设置

设置PITER框架元素的指南，以启用AFK（离开键盘）代理系统。

何时使用

配置GitHub作为提示输入源
设置Webhook或Cron触发器
准备专用的代理环境
设计审查过程
从在环移动到出环的代理式编码

PITER 概述

元素	问题	常见实现
P	任务从哪里来？	GitHub Issues
I	这是什么类型的工作？	LLM 分类
T	工作何时开始？	Webhooks / Cron
E	代理在哪里运行？	专用虚拟机/沙箱
R	工作如何验证？	Pull Requests

设置工作流

1. 配置提示输入 (P)

GitHub Issues 设置

# 验证GitHub CLI是否已认证
gh auth status

# 测试问题创建
gh issue create --title "测试问题" --body "测试ADW提示输入"

# 测试问题获取
gh issue view 1 --json title,body,labels

问题结构变为提示：

标题: 添加用户认证
正文: 我们需要Google提供商的OAuth...
标签: 功能, 高优先级

→ 变为: "/功能 添加用户认证..."

2. 配置分类 (I)

创建 /classify-issue 命令：

# 问题分类

分析问题并精确响应以下之一：
- /chore - 用于维护、更新、清理
- /bug - 用于缺陷、错误、意外行为
- /feature - 用于新功能

## 问题
$ARGUMENTS

测试分类：

claude -p "/classify-issue '修复登录按钮不工作'"
# 预期: /bug

claude -p "/classify-issue '更新依赖项'"
# 预期: /chore

3. 配置触发器 (T)

选项 A: Cron 轮询

# trigger_cron.py (简化版)
import time

POLL_INTERVAL = 20  # 秒

while True:
    issues = get_unprocessed_issues()
    for issue in issues:
        run_adw(issue.number)
    time.sleep(POLL_INTERVAL)

未处理 = 无评论 OR 最新评论是 “adw”

选项 B: Webhook

# trigger_webhook.py (简化版)
from flask import Flask, request

app = Flask(__name__)

@app.route("/gh-webhook", methods=["POST"])
def handle_webhook():
    event = request.json
    if is_new_issue(event):
        run_adw(event["issue"]["number"])
    return "OK"

Webhook 设置：

设置隧道 (ngrok/cloudflare)
在GitHub仓库设置中配置webhook
选择事件: Issues, Issue comments

4. 配置环境 (E)

环境检查清单：

# 验证 Claude Code
claude --version

# 验证 API 密钥
echo $ANTHROPIC_API_KEY | head -c 10

# 验证 GitHub 访问
gh auth status

# 验证仓库
git remote -v

# 测试模板
claude -p "/chore test" --dry-run

创建 .env 文件 (永不提交)：

ANTHROPIC_API_KEY=sk-ant-...
GITHUB_TOKEN=ghp_...
CLAUDE_CODE_PATH=claude

5. 配置审查 ®

基于PR的审查：

# 测试 PR 创建
gh pr create \
  --title "测试 PR" \
  --body "测试 ADW 审查过程" \
  --base main \
  --head feature-test

分支保护（推荐）：

要求 pull request 审查
要求状态检查通过
要求线性历史

验证检查清单

提示输入 (P)

[ ] GitHub CLI 已认证
[ ] 可以创建问题
[ ] 可以获取问题详情
[ ] 理解问题格式

分类 (I)

[ ] /classify-issue 命令有效
[ ] 正确分类杂务
[ ] 正确分类缺陷
[ ] 正确分类功能

触发器 (T)

[ ] 选择触发器方法 (cron/webhook)
[ ] 触发器脚本正在运行
[ ] 事件检测正确
[ ] 触发器时调用ADW

环境 (E)

[ ] 专用环境可用
[ ] API 密钥已配置
[ ] Claude Code 可访问
[ ] 模板已测试
[ ] 权限已配置

审查 ®

[ ] PR 创建有效
[ ] 问题链接有效
[ ] 分支保护已配置
[ ] 审查过程已记录

快速测试工作流

# 1. 创建测试问题
gh issue create --title "测试: 更新README" --body "添加安装部分"

# 2. 手动运行 ADW
python adws/adw_plan_build.py <问题编号>

# 3. 验证 PR 创建
gh pr list --state open

# 4. 审查并关闭
gh pr view <PR编号>

常见问题

认证失败

# 刷新 GitHub 认证
gh auth login

# 验证 API 密钥
curl -H "x-api-key: $ANTHROPIC_API_KEY" \
  https://api.anthropic.com/v1/models

Webhook 未接收

检查隧道是否运行
验证GitHub设置中的webhook URL
检查webhook密钥是否匹配
查看GitHub webhook交付日志

分类准确性

使用示例改进提示
添加边缘情况处理
考虑多标签问题

版本历史

v1.0.0 (2025-12-26): 初始发布

最后更新

日期: 2025-12-26 模型: claude-opus-4-5-20251101

PITER框架设置Skill piter-setup