Skills 示例(官方原生方式)
基于 Codex 与 Claude Code 官方机制的最小 Skills 示例
什么是 Skills?
Skills 是 AI 代理可复用的能力单元。核心文件是 SKILL.md,内容应尽量小而实用。
官方文档优先
本示例提供什么
- 一个可直接使用的
biomeskill 示例 - 保留官方原生思路,不依赖固定大模板
安装位置(按官方文档)
- Claude Code(项目级):
<project>/.claude/skills/biome/SKILL.md - Codex(项目级):
<project>/.codex/skills/biome/SKILL.md - 用户级路径仅用于跨项目共享,不作为本项目默认方式
---
name: biome
description: 运行 Biome 检查并自动修复代码问题
---
执行 Biome 代码检查和格式化:
## 1. 优先执行(项目标准)
\`\`\`bash
bun run lint
\`\`\`
## 2. 可选直接执行 Biome
\`\`\`bash
biome check --write .
\`\`\`
## 3. 分析结果
检查输出:
- `Checked X files in Xms. No fixes applied.`:已通过
- `Fixed X files.`:已自动修复,建议再跑一遍确认
- `error`:需手动修复
## 4. 失败处理
如有无法自动修复的问题:
1. 显示具体错误信息
2. 给出修复建议
3. 修复后重新运行检查使用建议
- 直接让 Agent 根据任务目标生成最小 skill
- 用 1-2 次真实任务验证后再扩展内容
- 避免先写大而全模板