上周三晚上,我把同一个「把乱七八糟的会议纪要收成能直接发的周报」需求,先后丢给两个 Claude Skill。第一个写了半个月,从来没自己跳出来过;第二个只改了 frontmatter 里那几行 description,当天就在相关对话里被触发了。
这篇按Ingénierie du mot de repère写。我不讲空泛的「提示词技巧」,只讲一件可复现的事:Skill 会不会被选中,几乎完全取决于 description;真正写好周报的那份完整提示词,放在 SKILL.md 正文里。
差输出长什么样

我最初给 Skill 写的 description 是这样的(第三人称都没用上):
description: Helps with documents and weekly reports
结果很稳定:聊代码、聊排期、甚至明确说「帮我整理这周进展」时,它都不触发。我只好手动 @ 那个 Skill,等于又变回普通提示词。
同一份乱七八糟的原始输入(真实脱敏后):
- 周一跟产品对了登录页改版,他们想砍掉第三方登录,我反对,没结论
- 周二修了支付回调超时,大概花了 3 小时,根因是网关重试把幂等键弄丢了
- 周三下午被拉去看客服工单,两单都是发票抬头校验太严
- 周四写了半截文档,周五继续,还没合并
- 周五站会提了下 Q4 OKR,没人接话
在旧 Skill「勉强手动触发」时,模型给过我这种周报草稿:
本周完成了多项重要工作,包括产品讨论、支付修复、客服问题处理与文档推进。团队就登录方案进行了深入交流,后续将继续优化用户体验,赋能业务增长。
读完等于没读。领导要的是决策、阻塞、下一步,不是口号。
改进后的完整提示词(可复制)

先给会触发的 description(按 Anthropic 官方建议:第三人称、写清做什么 + 何时用,核对文档日期 2026-10-27):
---
name: weekly-report-from-notes
description: Turns messy meeting notes, chat logs, and bullet dumps into a concise Chinese weekly report with decisions, blockers, and next actions. Use when the user asks for 周报, 周进展, 周总结, standup summary, or pastes unordered work notes to clean up.
---
再给SKILL.md 正文里那份完整提示词(这才是产出质量的关键):
# 会前纪要 → 可直发周报
你是在帮一位工程师写给直属上级的周报,不是写公众号。
## 输入
用户会粘贴本周零散笔记(可能含吐槽、未结论事项、时间戳)。不要发明没有出现过的业绩数字。
## 输出格式(严格)
只用下面五个小标题,中文,总字数 350–550:
### 本周完成
- 每条:动作 + 对象 + 结果(可验证)。禁止「推进了」「优化了」这类空动词。
### 关键决策
- 写清:谁提的、争论点、最终有没有拍板。没拍板就写「未决」。
### 阻塞 / 风险
- 每条附一个「如果本周不处理会怎样」。
### 下周计划
- 最多 3 条,按优先级。每条能在下周五验收。
### 需要你支持
- 没有就写「无」。有就写成可回复的请求(谁、何时前、要什么)。
## 硬性规则
1. 保留具体名词:接口名、工单类型、页面名;去掉情绪词。
2. 同一件事只出现一次;冲突信息以「更晚的笔记」为准,并在决策里标明未决。
3. 禁止:赋能、生态、闭环、抓手、对齐颗粒度、未来已来。
4. 禁止把「讨论过」写成「已完成」。
5. 若输入不足以支撑某一节,写「笔记不足,待补充:…」,不要编。
逐段拆解:为什么这么写

description 里的触发词。官方 best practices 写得很直白:description 会被注入系统提示,用来从可能上百个 Skill 里做匹配;要同时写「做什么」和「什么时候用」,并带上用户原话里的关键词(Skill authoring best practices,核对 2026-10-27)。我把「周报 / 周进展 / standup / 乱七八糟的笔记」都写进去,是因为我自己平时就这么喊它。
输出五段而不是「自由发挥」。上级扫周报通常只看决策、阻塞、要他拍板的事。把格式锁死,比再写八百字「写作风格」管用。
硬性规则第 3、4 条。这是我踩过的坑:模型特爱把「开了个会」升级成「完成了方案」。明文禁止之后,幻觉会少一截——不是消失,是好拦。
「笔记不足,待补充」。没有这条,它会为了填满五个标题开始脑补业务结果。我宁可周报短,也不要假完成。
前后对比(同一输入)

用上面那份完整提示词后,同一输入的输出大致变成:
本周完成
– 修复支付回调超时:定位到网关重试丢失幂等键,回调链路恢复可用。
– 客服侧发票抬头校验过严导致的两单工单已复现;校验规则仍待产品确认是否放宽。
– 登录页改版相关文档写到一半,尚未合并。关键决策
– 产品提议砍掉第三方登录;我反对。周一讨论未决.
– 支付幂等键方案:以网关侧保留原始 idempotency key 为准(工程侧已按此改)。阻塞 / 风险
– 第三方登录去留未决:若下周仍无结论,改版排期会空转。
– 发票抬头规则未确认:同类工单可能继续进线。下周计划
1. 与产品定第三方登录去留(要书面结论)。
2. 合并登录改版文档并提审。
3. 补一条支付回调的回归用例。需要你支持
– 请在周三前帮我拉产品拍板「第三方登录是否保留」。
差别不在文采,在未决还是未决、完成还是完成.
两个变体

给客户的周报:把「需要你支持」改成「待客户确认」,并禁止出现内部吐槽与未公开排期。
给自己的复盘版:加第六节「本周判断失误」,强制写一条当时以为对、后来打脸的判断——这节对向上管理没用,对自己有用。
局限(别指望一次写完)

1. description 写得再好,如果系统里装了十几个「文档 / 总结」类 Skill,仍可能抢触发;那时要靠更窄的触发词,或临时手动指定。
2. 这份提示词不会替你从日历、Git、工单系统拉数据——输入垃圾,输出只能少垃圾。
3. Anthropic 自己也提醒:Skills 能跑代码、能带资源,只安装可信来源,并审计捆绑脚本(见 Equipping agents for the real world with Agent Skills)。周报 Skill 这种纯文本还好;一旦往里面塞脚本,安全边界就变了。
你要是现在就有一份混乱笔记,直接把上面的 description + 正文提示词存成 Skill,再用同一段笔记跑一遍。触发了却写得虚,优先改正文规则;根本不触发,优先改 description 里的「何时用」那句。


评论列表 (0条):
加载更多评论 Chargement...