关于 wasp-plugin-init
wasp-plugin-init 是用于初始化 Wasp 插件知识的技能,面向使用 Claude Code 或其他 Agent 的 Wasp 项目开发者。它根据所用 Agent 将 Wasp 知识写入 CLAUDE.md 或 AGENTS.md,并用版本标记管理初始化。
主要功能
- 01确认 Agent 类型与继续意愿
- 02将知识文件导入项目
- 03更新对应记忆文件
- 04使用版本标记识别初始化
- 05提示可用插件技能
适用场景
- 01为 Claude Code 配置 Wasp 知识
- 02为其他 Agent 更新 AGENTS.md
- 03升级插件后重新初始化
MCP 相关
README 提到可让 Agent 使用 Chrome DevTools MCP server,但未说明该技能自身作为 MCP 服务或客户端。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ wasp-lang/ wasp-agent-plugins --skill wasp-plugin-init安装后在 Claude Code 中输入/wasp-plugin-init确认已加载。
附带文件general-wasp-knowledge.md
详细介绍
-
告知用户,此流程会将
general-wasp-knowledge.md文件导入用户的 AGENTS.md 或 CLAUDE.md 文件,让他们的 Agent(Claude、Codex、Copilot 等)能够访问有关 Wasp 功能、命令、工作流和最佳实践的知识。使用 AskUserQuestion 工具(或同等工具)来:a) 询问用户是否要继续;b) 询问用户使用的是 Claude Code(CLAUDE.md),还是 Codex、Gemini、Copilot 等其他 Agent(AGENTS.md)。 -
如果用户使用 Claude Code,请遵循 Claude Code memory 中的说明。如果用户使用其他 Agent,请遵循 Other agents memory 中的说明。
-
告知用户流程已完成,并且可以运行
/wasp-plugin-help查看该插件提供的技能和功能。 -
建议用户执行以下操作,以便获得最佳的 Wasp 开发体验(适用于 Claude、Codex、Copilot 等):
- 启动开发服务器:让它运行
start-dev-server技能来启动 Wasp 应用,并使其能够访问服务器日志、构建错误和 Wasp CLI 命令 - 启用 Chrome DevTools:提示它
use the Chrome DevTools MCP server,以便查看浏览器控制台日志、网络请求和运行时错误
说明这两项结合起来可以提供端到端的洞察(后端 + 前端),从而加快调试和开发。
- 启动开发服务器:让它运行
Claude Code memory
- 从
${CLAUDE_PLUGIN_ROOT}/.claude-plugin/plugin.json中获取插件版本(version字段)。在下文中将其用作{VERSION}。 - 检查
.claude/wasp/.wasp-plugin-initialized-v{VERSION}是否已存在。如果存在,告知用户该版本的插件已经初始化,并跳过其余步骤。 - 检查
.claude/wasp/中是否有任何匹配.wasp-plugin-initialized*模式的旧标记文件。如果找到,请将其删除——这是版本升级:
rm -f .claude/wasp/.wasp-plugin-initialized*
- 将
general-wasp-knowledge.md复制到用户项目根目录下的.claude/wasp目录中:
mkdir -p .claude/wasp && cp ./general-wasp-knowledge.md .claude/wasp/general-wasp-knowledge.md
- 如果 CLAUDE.md 文件中尚未包含
# Wasp Knowledge章节,则将其作为导入项追加:
# Wasp Knowledge
Wasp knowledge can be found at @.claude/wasp/general-wasp-knowledge.md
- 创建版本标记文件,让插件知道此版本的初始化已经运行:
touch .claude/wasp/.wasp-plugin-initialized-v{VERSION}
Other agents memory
- 从
${CLAUDE_PLUGIN_ROOT}/.claude-plugin/plugin.json中获取插件版本(version字段)。在下文中将其用作{VERSION}。 - 如果 AGENTS.md 文件中已经包含以
# Wasp Knowledge [GENERATED BY WASP开头的章节,请在添加新章节前删除整个章节(从标题开始,直到下一个#标题或文件末尾)。 - 将
general-wasp-knowledge.md的全部内容追加到用户的 AGENTS.md 文件中:- 在文件末尾追加一个新章节,标题为
# Wasp Knowledge [GENERATED BY WASP v{VERSION}]。 - 将
general-wasp-knowledge.md的内容复制并粘贴到这个新章节中。
- 在文件末尾追加一个新章节,标题为