yixiong-claude-marketplace/.claude/memory/project_overview.md

name, description, type, last_updated, commit

name	description	type	last_updated	commit
项目概述	yixiong-claude-marketplace 的定位、目录结构、插件规范和发布流程，同时支持 Claude Code 与 Codex/ChatGPT 桌面应用两条市场线（huanxi/huanxi-admin/memcore/obsidian/zentao 五个已发布插件）	project	2026-08-25	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

{
  "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（只需两字段）

---
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，同事安装后需手动开启一次。