SkyJourneyandClaude Sonnet 5
42f8e9f483
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015D4xWG3gRWkUKJDgyvtyJw
81 lines
5.0 KiB
Markdown
81 lines
5.0 KiB
Markdown
---
|
||
name: 项目概述
|
||
description: yixiong-claude-marketplace 的定位、目录结构、插件规范和发布流程，同时支持 Claude Code 与 Codex/ChatGPT 桌面应用两条市场线（huanxi/huanxi-admin/memcore/obsidian/zentao 五个已发布插件）
|
||
type: project
|
||
last_updated: 2026-08-25
|
||
commit: 9d9e31c
|
||
---
|
||
|
||
# 蚁熊内部 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 规范字段
|
||
|
||
## 已发布插件
|
||
|
||
| 插件 | 技能 | 特性 | Codex 支持 |
|
||
|------|------|------|------|
|
||
| `huanxi` | 个人端 7 个（report/leader/task/issue/meeting/lookup/shared） | userConfig Bearer Token（hxp_）+ MCP Server（URL 走 office 子域，无端口） | ✅ `.codex-plugin/plugin.json` 共用同一 `skills/`，Token 走环境变量 `HUANXI_TOKEN`（`bearer_token_env_var`） |
|
||
| `huanxi-admin` | 管理端 4 个（admin-report/admin-module/admin-ops/admin-shared） | userConfig Bearer Token（hxa_）+ MCP Server；普通员工无需安装，2026-08-21 v1.0.0 生产切换后首次发布 | ✅ 同上模式，Token 环境变量 `HUANXI_ADMIN_TOKEN` |
|
||
| `memcore` | Claude 版 4 个（memory-sync/lint/update/shared） | 纯技能，无 MCP；memcore-shared 作内部 include（路径锁定 + 阈值常量 + PROJECT_DIR 解析），支持 synonyms.md 等价词表、Phase 3C 即时引用快扫、Phase 0 并发冲突保护、lint_report 稳定 ID + resolved 跳过、Base commit 兜底 | ✅ 独立目录 `plugins/memcore-codex/`（不与 Claude 版共用 `skills/`），架构不同：`AGENTS.md` 会话入口、`.claude/memory` 优先复用否则落 `.codex/memory`、无远程同步 |
|
||
| `obsidian` | 10 个（obsidian/bases/canvas/daily/history/meta/plugins/search/tasks/workflow-pkm） | 纯技能，无 MCP；对标社区基准（kepano/obsidian-skills 31.8k★、AgriciDaniel/claude-obsidian）后扩展 canvas 视觉层；核心 obsidian 含 OFM 语法速查；workflow-pkm 含 Web Clip 子流程 | ✅ `.codex-plugin/plugin.json` 共用同一 `skills/`，无 MCP 无需 Token |
|
||
| `zentao` | 8 个（project/story/bug/task/test/plan/misc/shared） | userConfig Token（禅道「个人中心 → 获取凭证」14 天有效期自助生成，非 Bearer 标准格式，走自定义 header `"token": "${user_config.token}"`）+ MCP Server；MCP Server 是基于开源 merzzzl/openapi-mcp-server 二次开发的 zentao-mcp 网桥，部署在 `pm.ops.yixiong-tech.com/mcp`，请求体字段统一包在 `payload` 里；README 配了三张截图（`docs/images/zentao-token/`）图解获取凭证流程 | ✅ `.codex-plugin/plugin.json` 共用同一 `skills/`，Token 走环境变量 `ZENTAO_TOKEN`（`bearer_token_env_var`）；网桥已确认同时兼容自定义 `token` header 与标准 `Authorization: Bearer`，双端认证均可用 |
|
||
|
||
Codex/ChatGPT 桌面应用侧市场索引独立维护在 `.agents/plugins/marketplace.json`（marketplace 名 `yixiong-codex-hub`），与 Claude 侧 `.claude-plugin/marketplace.json`（`yixiong-claude-hub`）并存，互不干扰。已确认不做 Antigravity（Google agy）兼容。
|
||
|
||
**See Also**：[[decisions.md#huanxi plugin 使用 userConfig 而非环境变量传 Token]]、[[decisions.md#Codex/ChatGPT 桌面应用插件骨架——三个插件共享 skills/，memcore 独立目录（2026-08-22）]]、[[decisions.md#不做 Antigravity（Google agy / Antigravity 2.0）兼容（2026-08-22）]]、[[decisions.md#zentao-mcp 网桥已打补丁，双认证格式兼容（2026-08-25）]]
|
||
|
||
## 发布流程
|
||
|
||
1. 新增/修改插件内容
|
||
2. 提交 main 分支（`git push`）
|
||
3. 已安装用户会话启动时自动检测更新（需用户先手动开启 auto-update 一次：`/plugin` → Marketplaces → Enable auto-update）
|
||
4. 有更新时提示执行 `/reload-plugins`
|
||
|
||
**第三方 marketplace 默认关闭 auto-update**，同事安装后需手动开启一次。
|