这个项目的起因特别真实——我老婆是她们公司市场部负责人，某天晚上她一边改文案一边叹气：”这个实习生又把 B 端产品的官网 banner 写成了小红书卖货文案的语气，产品经理又发火了。”
我随口问了一句：”你们公司没有品牌 tone & manner 手册吗？”
她一脸苦笑：”有啊，一份 40 页的 PDF。谁会每写一条文案就翻一遍？”
就这一句...
先说结论：Agent SDK 的 quickstart 真的很友好，3 分钟出效果那种。但这个 3 分钟和我后来折腾的 3 天之间，隔着一条相当宽的沟。
从一行 npx 开始2025 年 Anthropic 把 Agent SDK 开源出来之后，我一直想找个周末摸一摸。那天晚上 10 点多，我打开终端敲了第一行：
1npx @anthropic-ai/...
去年 9 月一个朋友在美国做医疗影像中心的 CTO 找到我，说他们一直想搞读片报告自动生成，但合规一块总过不了关。他们规模不大，12 个放射科医生，日均 320 份读片报告，主要做 CT 和 MRI。
医生读片本身快，真正耗时的是写 SOAP note——Subjective（主诉）、Objective（客观发现）、Assessment（评估）、Pla...
写这篇之前我犹豫过要不要写。因为我们监控这套做了挺久，调了不少参数，怕写出来别人照抄反而不合适。但转念一想，这正是可观测性的魅力——每个 agent 系统的工作负载都不同，分享思路比给配方重要。
SDK 层 hook 和 Claude Code hook 的区别先澄清一个容易混的东西。
Claude Code CLI 有一套 hook 系统，配在 ~/...
开场说明文案这事儿没法教——你只能看别人改稿，然后照着感觉走。我这一两年给客户改落地页文案少说 60 个，下面挑 7 个记忆最深的案例，每个案例对应 copywriting/SKILL.md 讲到的一条原则。
这个 SKILL 本身是整个合集里写得最”薄”的一份——没有罗列 50 条规则，就几条核心原则加几张对照表。但它的密度很高，每条都能撬一个案例出...
做过内容运营的都知道，AI 初稿不是”不能用”，是”一眼能被看出来”。平台算法不一定检测得出，但读者的眉头能。content-humanizer 这个 Skill 不是帮你过 AI 检测器的，它是把”为什么读着像机器”拆成可执行的信号清单，让你知道到底要改哪里。定位写得很直接：这不是写作 Skill，是”去 AI 味”的 Skill。初稿不管是人写的还...
这篇不是教程，也不是评测，更接近田野笔记。过去两个月，我分别在三个不同阶段的 SaaS 团队里帮忙过一段内容策略的活，顺手把 content-strategy 这个 Skill 塞进去跑。三家公司的语境差别极大：一家在找 PMF，一家在抢关键词，一家在做合规导向的 enterprise 获客。Skill 在每一家用起来，都给出了不一样的骨架。
我把三段...
前情提要：我接了个任务，给公司 PR 流程做 Claude Code 自动化。
最开始我写了个叫 pr-helper 的 Skill，正文 2,817 字，把所有事儿都放里面——分析 diff、评估风险、写描述、建议测试、生成 changelog、推荐审阅人。一条龙。
跑起来就出事。
为什么单个大 Skill 干不动复杂工作流三个问题，越用越明显。
第...
有个朋友上周开了 Claude 账号，问我第一天该怎么用。我发了几句，他说太多了记不住。我想想也是，与其甩一堆能力清单，不如按”正常人真的会遇到的顺序”排一条上手路径。
下面这 10 个场景是我带过十几个非技术朋友之后总结的，按他们实际使用的先后顺序排，不是按官方文档的功能分类。
1. 总结一篇读不下去的长文章这是 90% 的人第一次用 Claude ...
先抛个反差数字。
我们公司 Confluence 里有 2,341 个页面。过去一年被点开过的只有 318 个（13.6%），被点开过 3 次以上的只有 91 个（3.9%）。剩下 96% 的内容写了就烂在那。
同一时期，我们做的 Skill 合集，67 个 Skill，过去 30 天被触发 13,408 次。平均每个 Skill 每月被用 6.2 次...
Agent SDK 本地跑起来挺舒服。但是一旦你要把它塞进生产环境——容器里跑、k8s 里调度、被监控系统盯着——就会发现本地那套玩法不够用。
这篇是把我自己踩过的坑和客户现场见过的部署方式整理成一份清单。不保证面面俱到，但至少少走弯路。
1. 多阶段 Dockerfile别用单阶段，node:20 基础镜像加依赖动辄 1.2GB。我的模板大概是这样：...
一个让我重新做人的实验两年前我还比较自信，觉得写 prompt 这事儿我摸得差不多了。直到一个周五晚上，跟同事吃饭时他随口问我：”你们 prompt 里的文档是按什么顺序排的？”
我说按相关度降序啊，最相关的放最前面，这不是常识吗？
他笑了笑说他们团队最近发现——把最相关的放最后，准确率反而高。
我第二天一早就跑去跑实验。我当时就懵了：同样 20 段 ...
