diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
new file mode 100644
index 0000000..2c2e4bb
--- /dev/null
+++ b/.claude-plugin/marketplace.json
@@ -0,0 +1,15 @@
+{
+  "name": "engineering-conventions",
+  "owner": {
+    "name": "左林豪"
+  },
+  "description": "工程协作约定技能市场，提供通用 AI 编码协作约定。",
+  "plugins": [
+    {
+      "name": "engineering-conventions",
+      "source": "./",
+      "description": "通用工程协作约定：先找现成实现、公共代码改动先对齐、改实现同轮改文档、最小验证、长任务报进度、规范提交信息。",
+      "version": "1.1.0"
+    }
+  ]
+}
diff --git a/README.md b/README.md
index 51ba7bb..98a0604 100644
--- a/README.md
+++ b/README.md
@@ -12,6 +12,7 @@
 | `index.json` | DeepSeek Harness 市场索引（format 1） |
 | `package.json`、`cordis.patch.yml`、`lib/index.js` | DeepSeek Harness bundle 声明与技能提供方接线 |
 | `.claude-plugin/plugin.json` | Claude Code 插件清单 |
+| `.claude-plugin/marketplace.json` | WorkBuddy 套件市场清单（Claude Code 也识别） |
 
 `SKILL.md` 是纯 Markdown，可以直接阅读，也可以作为任意 AI 助手的指令文件（system prompt、规则文件、技能条目都适用）。
 
@@ -36,12 +37,30 @@ claude plugin install engineering-conventions@engineering-conventions
 
 桌面应用可在「添加插件 → Git URL」填上面的仓库地址，再从市场安装。
 
+## 在 WorkBuddy 中安装
+
+WorkBuddy 通过 `.claude-plugin/marketplace.json` 把这个仓库识别为套件市场，市场里只有一个套件 `engineering-conventions`。添加市场只是登记来源，不会自动安装，需要再手动点安装。
+
+界面路径：专家·技能·连接器 → 技能 → 技能市场 → 套件 → 套件市场 → 添加市场，市场源填：
+
+```
+https://www.zlhhh.com/ZLH/engineering-conventions.git
+```
+
+也可以在命令行操作：
+
+```bash
+codebuddy plugin marketplace add https://www.zlhhh.com/ZLH/engineering-conventions.git -n engineering-conventions
+codebuddy plugin install engineering-conventions@engineering-conventions
+```
+
 ## 版本
 
-同一份版本号记在三处，改动技能内容后一起递增：
+同一份版本号记在四处，改动技能内容后一起递增：
 
 - `package.json` 的 `version`（DSH bundle）
 - `.claude-plugin/plugin.json` 的 `version`（Claude Code 插件）
+- `.claude-plugin/marketplace.json` 的 `plugins[].version`（WorkBuddy 套件市场）
 - `index.json` 里的 `versions` 条目（DSH 市场索引，需同时更新 `commit` 为提交后的完整 SHA 与 `publishTimestamp`）
 
 ## 许可