技能开发指南：YAML规范与工程实践

本文档旨在指导开发者如何创建一个标准的技能（Skill），并避免新手常见的错误。首先，介绍了YAML头部元数据（Frontmatter），它是技能的入口文件，通常命名为SKILL.md，包含了技能的名称、描述、标签和版本等信息。接着，推荐了一种目录结构，即“三抽屉”结构，包括工具箱（scripts）、设置（config）和仓库（data），以保持项目的整洁和可维护性。然后，通过一个简单的Python脚本实例，展示了如何编写技能的代码，包括参数解析、错误处理和依赖管理。此外，还介绍了如何使用配置文件和与用户交互，例如读取外部配置和打印问题以获取用户输入。最后，提供了一些新手避坑指南，如使用空格而非Tab键进行缩进、冒号后必须有空格等。总结来说，编写技能的关键在于编写好YAML身份证，保持目录整洁，以及代码中多打印进度提示。