skill-creator

Skill 创建器

通过渐进式披露创建有效的 Agent Skills。

何时创建 Skill

遇到以下情况时，创建一个 skill：

• 在多次对话中反复出现的上下文
• 需要反复运用的领域专业知识
• Agent 应自动了解的项目专属知识

渐进式披露

Skills 分 3 个层级加载：

1. 元数据（约 27 个 token）——用于触发的 YAML frontmatter
2. 指令（少于 680 个 token）——包含核心模式的 SKILL.md 正文
3. 资源（不限）——按需加载的 references/、scripts/ 和 assets/

要点：精简第 1 和第 2 层的内容。将详细信息移至第 3 层。

快速工作流

1. 创建 skill 目录：.aider-desk/skills/my-skill/
2. 编写 SKILL.md，包含 YAML frontmatter（name、description）和正文指令
3. 根据需要将详细文档添加到 references/
4. 验证：提及一个触发关键词——skill 应出现在活动 skills 侧边栏中

如果 skill 未加载：检查 YAML 语法是否有效，name 是否为小写连字符格式，以及 description 是否包含用户会说的触发词

SKILL.md 示例

---
name: deploy-helper
description: Deploy AiderDesk builds to staging and production environments. Use when deploying, releasing, or publishing builds.
---

# Deploy Helper

Build and deploy AiderDesk to target environments.

## Steps

1. Run `npm run build` to generate production artifacts
2. Verify build output exists in `dist/`
3. Deploy to staging: `./scripts/deploy.sh staging`
4. Verify deployment: check health endpoint returns 200

## Troubleshooting

- Build fails: check `tsconfig.json` paths and run `npm run typecheck`

## References

- [environments.md](references/environments.md) - Environment configs

结构

my-skill/
├── SKILL.md       # Core instructions + metadata
├── references/    # Detailed docs (loaded as needed)
├── scripts/       # Executable operations
└── assets/        # Templates, images, files

参考资料

• quick-start.md - 创建你的第一个 skill
• writing-guide.md - 编写有效的 skills
• development-process.md - 分步工作流
• skill-examples.md - 模式和 示例
• cli-reference.md - CLI 工具用法
• agent-skills-resources.md - 架构和最佳实践