Files
CraftKit/plugins/profile/skills/resolve/SKILL.md
T

1.6 KiB

name, description
name description
resolve 根据目标模块、项目技术事实和当前会话已发现的技术提供方解析 Profile 能力,返回匹配结果、资料入口和缺口。适用于多语言项目的能力选择与诊断;项目初始化、业务设计或直接实现不应触发。

Profile 解析

根据项目证据选择技术能力,不扫描用户插件缓存,也不写入项目画像。

工作流

  1. 读取目标路径、所需能力和 .craftkit/project.json;项目画像缺失时只使用构建文件、锁文件和源码中的可验证事实。
  2. 按模块根最长匹配规则确定目标模块;同长度命中多个模块时返回 ambiguous。
  3. 从当前会话可用 Skill 判断提供方是否已被发现,不推断未暴露插件的安装状态。
  4. 已发现提供方时,由对应 Profile Skill 读取自身清单并返回候选;本 Skill 不拼接其他插件物理路径。
  5. 按解析规则选择候选,并按回退规则处理缺失、未知和冲突。
  6. 返回标准能力上下文,区分事实、选择、逻辑资料标识、项目覆盖入口和缺口。

详细字段和能力枚举见契约,提供方发现边界见发现协议。

边界

  • Profile 提供的命令只是选择建议,不构成执行授权。
  • 项目规范的合并和覆盖由 guidance 负责。
  • 稳定项目事实只有在用户要求初始化或更新画像时才由 knowledge:init 写入。
  • 逻辑资料标识只用于诊断;消费者不能将其转换成用户目录绝对路径。