CraftKit/plugins/profile/skills/resolve/references/contract.md

Profile 契约

每个提供方以 references/manifest.json 声明能力。清单只包含路由元数据，规则正文保存在同一 Skill 的 Markdown 文件中。

必需字段包括 schemaVersion、provider 和 profiles。Profile 必须声明稳定 ID、版本体系、版本范围、优先级、探测证据、能力资料入口和回退入口。

首期能力标识：

• project-detection
• knowledge-routing
• backend-design
• backend-implementation
• backend-testing
• language-review
• framework-review
• command-resolution

缺少能力表示提供方不提供该能力，不能使用空文件占位。

首期版本范围只支持 *、精确数字版本，以及用逗号连接的 >=、>、<=、<、== 条件。不支持并集、排除、预发布标签和生态专属通配表达式。

诊断结果使用 <plugin>:<skill>/<skill 内相对路径> 逻辑标识。该值不能被消费者拼接为物理路径。