- decisions.md 新增 memcore memory-update/lint 路径锁定决策条目
- project_overview.md 已发布插件表新增 obsidian 插件族(9 个技能)
- CLAUDE.md 已发布插件表同步更新,顶部元数据刷新至 9c91382
- MEMORY.md / lint_report.md 索引与执行时间更新至 2026-05-08
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
77 lines
2.4 KiB
Markdown
77 lines
2.4 KiB
Markdown
---
|
||
name: 项目概述
|
||
description: yixiong-claude-marketplace 的定位、目录结构、插件规范和发布流程
|
||
type: project
|
||
last_updated: 2026-05-08
|
||
commit: 9c91382
|
||
---
|
||
|
||
# 蚁熊内部 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 |
|
||
| `obsidian` | 9 个(obsidian/bases/daily/history/meta/plugins/search/tasks/workflow-pkm) | 纯技能,无 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**,同事安装后需手动开启一次。
|