正文内容
编码智能体（Coding Agent）
当你需要另一个编码智能体在代码仓库中实现或审查变更时，请使用此技能。
适用场景
- 需要跨多个文件修改的功能开发。
- 规模较大的重构任务，希望并行开展多个工作流。
- 在隔离的代码检出环境中进行 PR 审查或问题分诊（issue triage）。
- 可重复执行的“运行 → 修复 → 验证”循环，且该过程能从后台异步执行中获益。
不适用场景
- 可直接手动完成的微小单行修改。
- 仅需读取代码的查找类任务（read-only code lookup）。
- 在
~/.openclaw目录下对外部仓库执行审查任务。
执行模式对照表
-
Codex：需启用pty:true。 -
Pi：需启用pty:true。 -
OpenCode：需启用pty:true。 -
Claude Code：使用--print --permission-mode bypassPermissions（无需 PTY）。
示例：
# Codex（必须启用 PTY） bash pty:true workdir:~/project command:"codex exec --full-auto '为 API 客户端添加请求超时处理，并更新对应测试。'" # Claude Code（打印模式，无需 PTY） bash workdir:~/project command:"claude --permission-mode bypassPermissions --print '重构认证中间件，并说明潜在风险区域。'" # OpenCode（必须启用 PTY） bash pty:true workdir:~/project command:"opencode run '为 Webhook 投递添加重试与退避机制。'" # Pi（必须启用 PTY） bash pty:true workdir:~/project command:"pi '修复 src/api 下失败的 Vitest 测试套件，确保行为保持不变。'"
后台会话模式（Background Session Pattern）
# 启动后台会话 bash pty:true workdir:~/project background:true command:"codex exec --full-auto '实现 issue #142 并运行全部测试。'" # 查看实时输出日志 process action:log sessionId:XXX # 查询会话运行状态 process action:poll sessionId:XXX # 当智能体提示输入时，提交响应 process action:submit sessionId:XXX data:"yes" # 终止会话 process action:kill sessionId:XXX
安全审查工作流（Safe Review Workflow）
切勿在你正在使用的活跃 OpenClaw 仓库中直接执行 PR 审查。请始终使用临时克隆（temp clone）或 Git worktree。
# 使用临时克隆进行审查 REVIEW_DIR=$(mktemp -d) git clone https://github.com/org/repo.git "$REVIEW_DIR" cd "$REVIEW_DIR" && gh pr checkout 130 bash pty:true workdir:"$REVIEW_DIR" command:"codex review --base origin/main" # 使用 worktree 进行审查 git worktree add /tmp/pr-130-review pr-130-branch bash pty:true workdir:/tmp/pr-130-review command:"codex review --base main"
长周期任务的提示词模板（Prompt Template for Long Tasks）
任务： - [明确的任务范围] - [约束条件] - [必需执行的检查项] 完成后： 1) 汇总被修改的文件及其修改原因； 2) 报告所执行的测试/代码检查（lint）命令及其结果； 3) 执行以下命令： openclaw system event --text "Done: [简明结果摘要]" --mode now
故障恢复检查清单（Failure Recovery Checklist）
- 若输出停滞，请先执行一次
process action:poll，再考虑终止会话； - 若智能体要求补充缺失上下文，请直接提供所需信息，并继续当前会话；
- 若会话提前中断，请使用更精确的提示词（tighter prompt）及显式限定文件范围重新启动；
- 若多次重试仍失败，请切换至全新的 worktree，以排除本地状态干扰。
行为准则（Rules）
- 当用户明确指定了目标智能体（如 Codex / Pi / Claude Code 等）时，必须严格匹配该智能体；
- 每个会话应严格限定于单一仓库和单一目标；
- 实现类任务优先使用
--full-auto；审查类任务则应采用保守参数（conservative flags）； - 必须在任务启动、关键里程碑、遇到阻塞点以及最终完成时，主动向用户发送进度更新；
- 若用户请求的是编排（orchestration）模式，则不得静默接管编码工作——所有操作均需明确告知并获得确认。