用途:该技能用于指导创建网关脚本,即进入智能体编程(agentic coding)的入口点,帮助从对话式使用转向自动化。原文强调“这个脚本是进入智能体编程的网关,与任何其他类型的代码明显不同——它在调用智能体”。
适用时机:为智能体创建新的 CLI 入口点、构建程序化的智能体调用、设计组合工作流、搭建自动化脚本。
三种网关模式:
- 直接提示(Direct Prompt):执行临时提示,示例命令为 adw_prompt.py,通过 AgentPromptRequest 构建 prompt、model、agent_name,调用 prompt_claude_code。适用于快速一次性任务、测试与探索。
- 斜杠命令封装(Slash Command Wrapper):以编程方式执行斜杠命令,示例为 adw_slash_command.py,通过 AgentTemplateRequest 传入 slash_command 与 args,调用 execute_template。适用于定时命令、触发器、外部集成。
- 组合工作流(Composed Workflow):串联多个智能体,示例为 adw_chore_implement.py,先执行 /chore 规划,再执行 /implement 实现。适用于多步骤自动化与完整工作流。
设计清单:CLI 接口使用 click 定义参数与选项(--model 默认 opus、--verbose);用 uuid.uuid4().hex[:8] 生成唯一短 ID;输出组织到 agents/{adw_id}/{agent_name} 目录;提供仅含必要变量的安全环境;处理超时与执行错误并退出码 1;用 rich 面板展示输出。
请求/响应模型:AgentPromptRequest 含 prompt、adw_id、model、agent_name、output_file;AgentPromptResponse 含 output、success、error、output_file。
输出文件结构:每个网关产生 cc_raw_output.jsonl、cc_raw_output.json、cc_final_object.json、custom_summary.json。
反模式:向子进程传递完整环境变量、不生成唯一 ID(冲突风险)、缺少错误处理(静默失败)、输出内联而非落盘(不可审计)、无 CLI 接口(难使用)。
版本:v1.0.0(2025-12-26)。具体依赖版本、收费与平台支持资料暂未提供。