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

原文：https://itjc.com/tutorials/first-skill/
主题：Skills；级别：实战；更新时间：2026-11-15。

> 用一个小而明确的 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，真正需要自动执行的稳定逻辑再考虑脚本。脚本不是必需品；把输入和验收说清楚已经很有价值。

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

## 官方资料与参考

- [OpenAI Skills 构建说明](https://learn.chatgpt.com/docs/build-skills)
- [Claude Code Skills](https://code.claude.com/docs/en/skills)
