Skills 示例(官方原生方式)

基于 Codex 与 Claude Code 官方机制的最小 Skills 示例

什么是 Skills?

Skills 是 AI 代理可复用的能力单元。核心文件是 SKILL.md,内容应尽量小而实用。

官方文档优先

本示例提供什么

  • 一个可直接使用的 biome skill 示例
  • 保留官方原生思路,不依赖固定大模板

安装位置(按官方文档)

  • 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 次真实任务验证后再扩展内容
  • 避免先写大而全模板

目录