用途:指导在仓库 skills/ 目录中创建与完善技能。技能是打包好的指令,用于教 AI 代理如何使用 Phoenix 功能。
目录结构:skills/{skill-name}/ 使用 kebab-case,Phoenix 功能前缀为 phoenix-。其中 SKILL.md 为必需,定义技能并充当索引;README.md 可选;rules/ 可选,存放详细规则文件,命名形如 {prefix}-{topic}.md 或 {prefix}-{topic}-{lang}.md。
已有技能示例:phoenix-tracing(含 31 个规则文件)、phoenix-evals(33 个)、phoenix-cli(无规则文件,仅单个 SKILL.md)。
主要流程:先规划范围,决定是单 SKILL.md 还是 SKILL.md 加 rules/;创建目录;编写带 YAML frontmatter 的 SKILL.md,包含 name、description、license(固定 Apache-2.0)、metadata.author(Phoenix 技能用 oss@arize.com)、metadata.version、可选的 languages 与 internal;正文作为索引,含 Quick Reference 映射任务到规则文件、Rule Categories 列出前缀,SKILL.md 应保持在 500 行以内。
规则文件命名用前缀(如 setup-、fundamentals-、instrumentation-、span-、evaluators-、experiments-、production-、annotations-、validation-)加主题和可选语言后缀(-python.md、-typescript.md),全部平铺在 rules/ 下,不建子目录。
限制与注意:SKILL.md 只作索引,详细内容放入规则文件;避免深层引用链,规则应自洽;不要混用语言,除非真正语言无关;新增规则必须同步更新 SKILL.md 索引;不写时间敏感信息。以上为公开资料整理,具体细节以官方文档为准。