共25篇

文章分类:AI

AI 工具与实践

烂笔头-自定义图像 烂笔头 3 周,5天前 AI • AI 编程 • Agent

给 AI 派活:四份文档与一套验收标准

把开发活长期交给 AI agent 干,靠的不是更长的对话,而是磁盘上的四份文档:需求合同、施工日志、卡点上报、验收报告。这篇把整套方法讲清楚——FR 与 AC 怎么分工、验收标准为什么要写成「命令 + 期望输出」、假绿从哪来、阶段门与红绿测试怎么用,以及上下...

把开发活长期交给 AI agent 干,靠的不是更长的对话,而是磁盘上的四份文档:需求合同、施工日志、卡点上报、验收报告。这篇把...

AI 236 0
烂笔头-自定义图像 烂笔头 1月前 最佳实践 • AI 编程 • Agent

AI Agent 实战手记 04:给 Agent 选对 Loop 工作方式

同一个 Agent,为什么你只聊聊天,别人却能让它通宵改完 40 个测试?差别在 Loop 工作方式。本文用 5W 拆解 Agent 循环工作方式:什么是 Loop、为什么划分、主流框架怎么设计(QwenPaw 默认 / Goal / Mission,DSH ...

同一个 Agent,为什么你只聊聊天,别人却能让它通宵改完 40 个测试?差别在 Loop 工作方式。本文用 5W 拆解 Age...

AI 220 0
烂笔头-自定义图像 烂笔头 1月前 AGENTS.md • 最佳实践 • Agent

AI Agent 实战手记 03:让技能越用越好用

AI Agent 实战手记第三篇。痛点:技能交付那天最贴合实际,之后每用一次都在积累不贴合——规则误报漏报、文档与实现脱节、输出噪音堆积,最后被弃用重建。经验:把复盘写成技能的强制步骤,固定自省四问,观察先落账(LEARNINGS 记为什么、CHANGELOG...

AI Agent 实战手记第三篇。痛点:技能交付那天最贴合实际,之后每用一次都在积累不贴合——规则误报漏报、文档与实现脱节、输出...

AI 220 1
烂笔头-自定义图像 烂笔头 1月前 踩坑 • API网关 • new-api

new-api 重试配置最佳实践:RetryTimes 与状态码范围

new-api 的重试机制常被误解:RetryTimes 不是简单的失败重试次数,它决定渠道档位能下探多深;状态码范围决定哪些错误值得降级。本文结合多档位渠道实战讲清两者关系——为什么 6 次重试刚好覆盖 7 档链路、429 原生可重试根本不需要渠道级映射、4...

new-api 的重试机制常被误解:RetryTimes 不是简单的失败重试次数,它决定渠道档位能下探多深;状态码范围决定哪些错...

AI 404 0
烂笔头-自定义图像 烂笔头 1月前 踩坑 • API网关 • new-api

new-api 网关改写实战:param_override 与 header_override 的两个坑

两个看似无关的 new-api 渠道故障,根因都藏在渠道级改写机制里:客户端传了上游不认的参数值(reasoning_effort=max),以及降级渠道莫名丢失请求头(x-opencode-session)。第二个尤其诡异——直击渠道正常、多档重试降级必失败...

两个看似无关的 new-api 渠道故障,根因都藏在渠道级改写机制里:客户端传了上游不认的参数值(reasoning_effor...

AI 464 0
烂笔头-自定义图像 烂笔头 1月前 踩坑 • API网关 • new-api

new-api 分流与重试降级实战:三个免费渠道如何做到逐级兜底

new-api 网关里优先级决定选渠顺序、权重只影响同档分摊,而失败重试默认是关闭的。本文从一次真实的 429 限流事故出发:三个同档免费渠道互不兜底、限流后请求直接降级到低优先级,服务频繁报错。通过开启 RetryTimes、状态码映射把 429 改成可重试...

new-api 网关里优先级决定选渠顺序、权重只影响同档分摊,而失败重试默认是关闭的。本文从一次真实的 429 限流事故出发:三...

AI 613 0
烂笔头-自定义图像 烂笔头 1月,1 周前 踩坑 • AI 编程 • API网关 • new-api

new-api 协议转换后 Codex 报错两连:会话头缺失与 developer role

用 new-api 做接口协议转换后,Codex / opencode 客户端经网关调用上游连续撞上两个报错:一个是 opencode 托管服务强制的 x-opencode-session 会话请求头,一个是 DeepSeek 官方 API 拒收的 devel...

用 new-api 做接口协议转换后,Codex / opencode 客户端经网关调用上游连续撞上两个报错:一个是 openc...

AI 405 0
烂笔头-自定义图像 烂笔头 1月,1 周前 AGENTS.md • 最佳实践 • Agent

AI Agent 实战手记 02:别等上下文占满,主动交接

AI Agent 实战手记第二篇。痛点:项目一大就装不进单次会话,等上下文占满才被迫切换,压缩丢的是状态,新会话冷启动重复劳动。经验:主动交接、把交接当成写文件——双文件系统管规则与状态,五项交接模板,状态落盘,控制加载体量,交接后归档。操作:给出两份可直接复...

AI Agent 实战手记第二篇。痛点:项目一大就装不进单次会话,等上下文占满才被迫切换,压缩丢的是状态,新会话冷启动重复劳动。...

AI 226 0
烂笔头-自定义图像 烂笔头 1月,1 周前 AGENTS.md • 最佳实践 • Agent

AI Agent 实战手记 01:先立规矩再干活

AI Agent 实战手记系列开篇。痛点:Agent 越能干,工作区越乱,文件散落、没有一个锚,而且不报错,直到乱到没法找。经验:让 Agent 在初期就制定好工作空间的目录结构规划,写进行为准则并配硬性规则。操作:立规矩的执行时机(第一天任务开始前)、两种可...

AI Agent 实战手记系列开篇。痛点:Agent 越能干,工作区越乱,文件散落、没有一个锚,而且不报错,直到乱到没法找。经验...

AI 148 0
烂笔头-自定义图像 烂笔头 1月,1 周前 Agent Skills • AGENTS.md • AI 编程

主流 AI Agent 技能与配置加载机制横评

从 Claude Code 到 DeepSeek Harness,主流 AI Agent 各自长出了一套技能、指令文件与配置插件的加载机制。本文横向梳理 Claude Code、Codex、ZCode、WorkBuddy、dsh、OpenClaw、OpenCo...

从 Claude Code 到 DeepSeek Harness,主流 AI Agent 各自长出了一套技能、指令文件与配置插件...

AI 1009 0