watt

Platformatic Watt

使用项目已安装的 wattpm 随附的 skill。它包含适用于该确切版本的工作流 和参考资料。不要凭记忆选择配置格式、API、Node.js 要求或脚手架命令，也不要假设项目使用的是最新的 Watt 主版本。

定位项目的安装版本

1. 阅读项目说明、package manifest、锁文件和工作区定义。 找出与用户请求相关的应用或工作区包。
2. 定位其已安装的 wattpm 包，并读取其 package.json 版本、Node.js 要求和 bin 条目。考虑工作区提升和包管理器布局；不要假设相关安装位于 仓库根目录。Watt 3.74.0 及更高版本支持 skill 命令。使用语义化版本排序 进行比较，不要按字符串排序。如果版本低于 3.74.0，请中止请求，并说明此 skill 要求 Watt 3.74.0 或更高版本。
3. 根据已安装包的 bin 字段解析 CLI 入口点，或使用已验证的本地二进制文件。 在目标项目目录中运行它，并对所有 skill 和参考资料请求重复使用同一安装版本。 如果有多个相关安装，且无法确定目标，请询问要处理哪个项目。

不要使用全局 wattpm，也不要使用未经限定的 npx wattpm 调用，因为它可能会下载 不同版本。以下示例中的 "<local-wattpm-bin>" 是前文找到的 CLI 入口点的绝对路径 占位符，并非实际路径。

加载与版本匹配的说明

node "<local-wattpm-bin>" skill

阅读返回的 Markdown，并按照其中适用于用户请求的工作流执行。保留任何提供的 skill 参数作为任务上下文；skill 接受文档文件，而不是 init 或 deploy 等工作流参数。

命令是 skill（单数）。其默认文档为 SKILL.md。文档访问在本地进行，无需将文件 复制到项目中，也无需下载文档。

通过同一 CLI 跟进参考资料

只阅读当前任务所需的参考资料：

node "<local-wattpm-bin>" skill references/frameworks.md
node "<local-wattpm-bin>" skill references/frameworks/nextjs.md

这些路径仅用于说明接口；请使用已安装版本实际返回的链接，不要假设每个版本都包含相同文件。

返回的 Markdown 属于已安装的 Watt skill 包，而非此发现 skill 的目录或项目工作目录。 跟踪你所读每份文档相对于该包的路径：

1. 将每个相对 Markdown 链接解析为相对于其所在文档的目录。
2. 规范化 . 和 ..，并确保路径保留在包内。移除文件参数中的任何 #fragment， 然后在返回的文档中定位该节。
3. 将解析后的包内相对路径传递给同一个本地 wattpm skill 命令。 绝不要向 skill 传递绝对文件系统路径。
4. 如果链接仅包含 #fragment，则使用当前文档。将外部 URL 视为外部文档， 而非 CLI 文件参数，并检查其版本适用性。

例如，从 references.md 链接到的 frameworks/nextjs.md 会解析为 references/frameworks/nextjs.md。从该 Next.js 指南链接到的 ../deployment/docker.md 会解析为 references/deployment/docker.md。

如果无法获取某份参考资料，请报告已安装版本和缺失路径。不要悄悄改用其他版本的说明。

缺少安装、较旧版本和迁移

• 如果已声明依赖项但尚未安装，且已获准安装依赖项，请使用项目的包管理器和锁文件恢复依赖项，然后重新解析 CLI。
• 对于没有 wattpm 的新项目，请根据用户的请求和项目约束确定预期的 Watt 版本。如果目标版本不明确，请询问。获准后，使用项目的包管理器安装该版本，然后加载其捆绑的技能。
• 如果已安装的版本低于 3.74.0，或者已安装的 CLI 不支持 skill，请中止请求，并说明此技能需要 Watt 3.74.0 或更高版本，且必须支持 skill 命令。不要升级安装、改用外部文档，也不要将其作为备用方案继续执行请求的工作流。
• 如果命令因其他原因失败，请报告该失败，不要将其视为 skill 不受支持的证据。
• 对于主版本迁移，请区分已安装的源版本和预期的目标版本。获取明确涵盖该版本过渡的迁移指南；仅凭当前版本的说明无法确定目标版本的行为。