Skills

写你的第一个 Skill:把周报整理流程保存下来

用一个小而明确的 SKILL.md,将输入要求、操作步骤和完成标准写清楚。

选择一个已经做顺的任务

Skill 适合保存稳定、可重复的方法。先用手动对话完成几次周报,确认需要哪些材料、如何检查结果,再抽出固定流程。不要把一整段聊天历史直接塞进去,其中常常包含已经过时的细节。

准备目录

不同工具的技能发现位置有区别,先按目标工具的官方文档确认。下面给出 Claude Code 本地项目技能的例子;它面向仓库本地会话,云端可用性需要另行查看官方说明。

text
.claude/skills/weekly-report/
└── SKILL.md

写入一个最小技能

将下面内容保存为 SKILL.md。这里的 frontmatter 用于描述技能,其余正文说明执行方法。

markdown
---
name: weekly-report
description: 根据用户提供的工作记录整理周报;不用于推测项目进度或发送邮件。
---

# 周报整理
1. 确认用户提供了本周工作记录;缺少时请求材料。
2. 按本周完成、待解决、下周计划整理。
3. 仅保留输入支持的事实,不编造日期、比例或结论。
4. 将需要确认的内容单独列出。
5. 输出草稿,供用户检查;不对外发送。

完成标准:每条记录有归属,无新增事实,待办清楚。

测试正常情况和边界

先给三条完整记录,再给一份缺少日期、互相矛盾的记录。确认技能会保留不确定性。另给一个“帮我安装数据库”的请求,确认这个技能的描述没有把它误吸引进来。

按需要拆分资源

正文只保留工作规则。很长的格式示例可以放进 references,模板放进 assets,真正需要自动执行的稳定逻辑再考虑脚本。脚本不是必需品;把输入和验收说清楚已经很有价值。

完成标准

别人不读原聊天也能使用;输入不足时有处理方式;测试覆盖正常和不适用场景。技能文件里不保存密码、私人材料或临时账号信息。

官方资料与参考

产品功能与命令可能调整。遇到差异时,以对应官方页面和当前环境为准。

读完了,动手试一次。

完成练习后,标记进度,方便继续学习。