创建 Skills
Skill authoring 的唯一 canonical user-facing 入口是：
本 developer page 只说明实现边界。
何时添加 Skill
当 capability 可以表达为 reusable instructions、supporting files 和 existing tools 时，创建 skill。
只有当 Anyy 需要新的 executable behavior 或新的 policy-governed side effect 时，才添加 runtime tool。
Runtime Loading
Skill parsing 和 management 位于 internal/skills。Runtime resolution、visibility、command descriptors
和 active-skill prompt material 位于 internal/runtime/skills 以及 gateway skill glue。
Skills 是 profile-scoped。Roles 不拥有 skill roots 或 permissions。
Skill Files
Skill 通常以 SKILL.md 为 root，并可包含 supporting files。Managed skills 位于 profile home；配置的
external roots 是 read-only，除非 manager 明确安装到 managed root。
不要把 workspace-local files 视为 product identity 或 trusted policy。
Commands
Skills 可以声明 commands。Runtime 会把这些声明转换成 protocol.CommandDescriptor values，同时尊重
reserved command names 和 surface/channel filters。
Commands 激活 skills；它们不会绕过 tool governance。
Validation
Tests 应覆盖 parser behavior、root precedence、reload、management tools、command descriptors、active-skill prompt inclusion 和 redaction。
Skill examples 应保持小，不要在 fixtures 中放 secrets。