核心功能
Claude Code Agent Skill 是一套完整的非交互式编码代理工作流，将 Anthropic 的 Claude Code CLI 转化为托管式自动化开发工具。该技能提供两大执行模式：
Quick Mode（快速模式）：适用于单文件修改、简单修复等轻量任务，通过 -p 非交互参数实现一次性执行，配合 stream-json 输出格式实现结构化日志捕获。采用"轮询-扩展"自适应超时机制，避免硬性超时 kill 长任务，支持 12 小时静默检测与循环检测安全网。
Full Mode（完整模式）：面向功能开发、Bug 修复等复杂任务，提供完整工程化工作流：
- 隔离工作树（git worktree）避免分支冲突
- tmux 会话支持中途介入 steering 而不中断任务
- JSON 任务注册表 + flock 原子锁实现多代理并行状态管理
- 定义明确的 DoD（Definition of Done）质量门禁
- 最多 3 次智能重试，支持失败日志分析与提示词自适应优化
显著优势
| 维度 | 亮点 |
|------|------|
| 可靠性 | 进程级状态检测（非仅 tmux 会话检测）、ANSI 清洗日志、100MB 日志轮转 |
| 可控性 | 权限分级（acceptEdits/plan/full skip）、工具白名单/黑名单、MCP 扩展 |
| 可观测性 | stream-json 实时输出、持久化轮询状态（支持 orchestrator 重启恢复） |
| 工程化 | 多模型交叉评审（Claude ↔ Codex）、PR 自动化、CI 状态集成 |
| 安全性 | `--dangerously-skip-permissions` 仅限容器/VM 沙箱环境使用，显式风险声明 |
局限性与风险
环境依赖：强制依赖 tmux（完整模式）、npm/Node.js 生态，非 Unix-like 系统支持有限。--dangerously-skip-permissions 标志本身提示了权限绕过的潜在风险，若误用于主机环境可能导致未授权文件操作。
成本与 Token 消耗：长时运行的 agent 可能产生高额 API 费用；重试机制虽有限（3 次上限），但复杂任务仍可能快速累积成本。
上下文窗口限制：大型代码库场景下可能出现 context overflow，需人工介入 narrowed scope。
状态持久化边界：任务注册表存储于本地 JSON 文件，分布式场景下无原生集群同步能力。
适用人群
- 需规模化处理并行开发任务的 Platform/MLE 团队
- 追求"代码即工单"（ticket-to-PR automation）的 DevOps 工程师
- 已采用 Claude Code 作为日常工具、希望降低交互开销的高级用户
- 具备 tmux、git worktree、jq 等基础 Linux 工具链熟练度的技术团队
风险评级说明
本技能涉及代码生成与自动执行，但权限模型设计较为完善（分级权限、工具限制、沙箱建议）。主要风险集中于 --dangerously-skip-permissions 的误用场景，属于可控的操作风险而非系统性安全漏洞。建议在 CI/CD 容器或隔离 VM 中运行，避免直接作用于生产主机。