选择一个已经做顺的任务
Skill 适合保存稳定、可重复的方法。先用手动对话完成几次周报,确认需要哪些材料、如何检查结果,再抽出固定流程。不要把一整段聊天历史直接塞进去,其中常常包含已经过时的细节。
准备目录
不同工具的技能发现位置有区别,先按目标工具的官方文档确认。下面给出 Claude Code 本地项目技能的例子;它面向仓库本地会话,云端可用性需要另行查看官方说明。
.claude/skills/weekly-report/
└── SKILL.md写入一个最小技能
将下面内容保存为 SKILL.md。这里的 frontmatter 用于描述技能,其余正文说明执行方法。
---
name: weekly-report
description: 根据用户提供的工作记录整理周报;不用于推测项目进度或发送邮件。
---
# 周报整理
1. 确认用户提供了本周工作记录;缺少时请求材料。
2. 按本周完成、待解决、下周计划整理。
3. 仅保留输入支持的事实,不编造日期、比例或结论。
4. 将需要确认的内容单独列出。
5. 输出草稿,供用户检查;不对外发送。
完成标准:每条记录有归属,无新增事实,待办清楚。测试正常情况和边界
先给三条完整记录,再给一份缺少日期、互相矛盾的记录。确认技能会保留不确定性。另给一个“帮我安装数据库”的请求,确认这个技能的描述没有把它误吸引进来。
按需要拆分资源
正文只保留工作规则。很长的格式示例可以放进 references,模板放进 assets,真正需要自动执行的稳定逻辑再考虑脚本。脚本不是必需品;把输入和验收说清楚已经很有价值。
完成标准
别人不读原聊天也能使用;输入不足时有处理方式;测试覆盖正常和不适用场景。技能文件里不保存密码、私人材料或临时账号信息。