《代理系统进入规模化运营》

Claude Code 系列｜第20期：把代理自测做成“先测后改”闭环

难度：进阶　动手时间：20分钟　成本：按账号套餐　环境：Git仓库、测试命令、Claude Code 2.1.269+

适用场景是让编码代理先阅读测试，再修改代码，最后把结果写进交付记录。不要让代理直接拥有生产密钥或自动发布权限。

cd /path/to/your-project
claude -p "先阅读项目说明和现有测试。只做一个小改动：为用户输入为空的情况补充校验。先告诉我计划，不要修改文件。"
claude -p "现在执行刚才的计划。修改后运行项目已有的最小测试命令；如果测试失败，说明失败文件、失败原因和下一步，不要自动扩大修改范围。"

可复制提示词：

你是代码审查代理。请先列出将读取的文件、将执行的测试和不会触碰的目录。完成改动后必须给出：改动文件、测试命令、测试结果、仍未验证的风险。若测试失败，只修复与本任务直接相关的问题。

常见坑：没有明确测试命令时不要猜；测试需要数据库时使用脱敏环境；代理要求扩大权限时先人工确认。不适用：没有回滚点、没有测试或能触达生产凭据的项目。
下期预告：权限白名单与高风险工具的人工复核。

参考：Claude Code发布页

Hermes Agent 系列｜第20期：用三阶段任务卡编排“调研—核验—归档”

难度：进阶　动手时间：25分钟　成本：免费起步，模型调用按服务商计费　环境：Hermes Agent、可用模型、输出目录

把任务拆成调研代理、核验代理、归档代理，每张任务卡写清输入、输出、停止条件和失败处理。

任务名称: AI日报单日生产
阶段:
  - 名称: 调研
    输出: 来源清单
    停止条件: 至少8条候选资讯且每条有原始链接
  - 名称: 核验
    输入: 来源清单
    输出: 已分层事实表
    停止条件: 每条都有类别、发布时间和可信度
  - 名称: 归档
    输入: 已分层事实表
    输出: Markdown与HTML
    停止条件: 锚点、链接、文件和分类索引均通过检查
失败处理:
  - 原始页面打不开: 标记未核验
  - 新闻不足8条: 扩大关键词
  - 写入失败: 保留已完成阶段并报告文件

可复制任务说明：

你现在只负责“核验”阶段。不要改写新闻，不要补写缺失事实。逐条打开原始链接，记录页面标题、发布时间、关键事实、证据强度和仍未确认的部分。没有证据的字段写“未核验”。

常见坑：一个代理同时搜索、判断、写作会混淆事实与观点；共享临时文件会互相覆盖；没有停止条件会无限扩张。下期预告：失败可恢复的定时任务与幂等归档。参考：Hermes Agent文档

Claude 模型系列｜第20期：中转站接入的超时、限流与费用账本

难度：进阶　动手时间：30分钟　成本：按中转站和模型用量计费　环境：Python 3.11+、兼容接口、环境变量密钥

下面示例不写真实密钥，把请求失败分类记录，便于对账。若中转站只提供 Anthropic 原生接口，请改用其官方 SDK。

import os, time
from datetime import datetime, timezone
from openai import OpenAI
base_url=os.environ["AI_BASE_URL"]
api_key=os.environ["AI_API_KEY"]
model=os.environ.get("AI_MODEL","claude-sonnet")
client=OpenAI(base_url=base_url,api_key=api_key,timeout=45.0)
start=time.time(); status="success"
try:
    r=client.chat.completions.create(model=model,messages=[{"role":"user","content":"用三句话解释什么是代理系统，并标出一个风险。"}],temperature=0.2)
    print(r.choices[0].message.content); print("用量:",getattr(r,"usage",None))
except Exception as exc:
    status="failed"; print("请求失败，请检查地址、密钥、模型名或限流状态。错误类型:",type(exc).__name__)
finally:
    print({"time":datetime.now(timezone.utc).isoformat(),"model":model,"status":status,"seconds":round(time.time()-start,2)})

成功标志是返回中文回答、打印用量（若接口提供）和不含密钥的账本记录。429/529或超时应指数退避并设置最大重试次数。不适用：医疗、支付或生产控制系统需额外合规与人工审批。
下期预告：按任务路由模型与上下文压缩。参考：Anthropic文档