---
name: 项目概述
description: yixiong-claude-marketplace 的定位、目录结构、插件规范和发布流程
type: project
last_updated: 2026-05-01
commit: 0c46ed0
---

# 蚁熊内部 Claude Code Marketplace

## 定位

蚁熊公司内部 Claude Code Plugin Marketplace（技能市场），统一管理和发布供全员安装的 Claude Code 插件与技能。Marketplace 名称：`yixiong-claude-hub`。

## 目录结构

```
.claude-plugin/
└── marketplace.json          # 市场索引：声明所有插件

plugins/
└── <plugin-name>/
    ├── .claude-plugin/
    │   └── plugin.json       # 插件元数据
    └── skills/
        └── <skill-name>/
            ├── SKILL.md
            └── references/   # 可选：详细工作流文档
```

## 文件格式规范

### marketplace.json
```json
{
  "name": "yixiong-claude-hub",
  "owner": { "name": "蚁熊团队" },
  "description": "...",
  "plugins": [
    { "name": "<name>", "source": "./plugins/<name>", "description": "..." }
  ]
}
```

### plugin.json（关键字段）
- **无 `version` 字段**：用 git commit SHA 作为版本基准，每次推送 main 即发布
- `userConfig`：用于用户输入敏感配置（token 等），`sensitive: true` 存系统钥匙链
- `mcpServers`：声明 MCP 服务器，headers 中可用 `${user_config.KEY}` 替换

### SKILL.md frontmatter（只需两字段）
```yaml
---
name: skill-name
description: "触发描述（用户实际口语，不用内部视角）"
---
```
- **不写 `version`**：version 不是 SKILL.md 规范字段

## 已发布插件

| 插件 | 技能 | 特性 |
|------|------|------|
| `huanxi` | 6 个（report/leader/task/weekly/org/shared） | userConfig Bearer Token + MCP Server |
| `memcore` | 3 个（memory-sync/lint/update） | 纯技能，无 MCP |

**See Also**：[[decisions.md#huanxi plugin 使用 userConfig 而非环境变量传 Token]]

## 发布流程

1. 新增/修改插件内容
2. 提交 main 分支（`git push`）
3. 已安装用户会话启动时自动检测更新（需用户先手动开启 auto-update 一次：`/plugin` → Marketplaces → Enable auto-update）
4. 有更新时提示执行 `/reload-plugins`

**第三方 marketplace 默认关闭 auto-update**，同事安装后需手动开启一次。