# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## 项目概述

蚁熊公司内部 Claude Code Plugin Marketplace（技能市场）。开发者在此仓库中维护供全员安装使用的 Claude Code 插件（Plugin）和技能（Skill）。

## 目录结构

```
.claude-plugin/
└── marketplace.json          # 市场索引：声明本仓库包含哪些插件

plugins/
└── <plugin-name>/            # 每个插件独占一个子目录
    ├── .claude-plugin/
    │   └── plugin.json       # 插件元数据（name, description, version, author）
    └── skills/
        └── <skill-name>/
            └── SKILL.md      # 技能实现（frontmatter + Markdown 指令）
```

## 核心文件格式

### marketplace.json（市场索引）

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

每新增一个插件，必须在 `plugins` 数组中追加对应条目。

### plugin.json（插件元数据）

```json
{
  "name": "plugin-name",
  "description": "...",
  "version": "1.0.0",
  "author": { "name": "蚁熊团队" }
}
```

版本遵循 SemVer：修改技能内容 → patch，新增技能 → minor，破坏性变更 → major。

### SKILL.md（技能实现）

```markdown
---
description: 一句话说明该技能的用途（Claude 用此判断何时触发该技能）
---

技能的具体指令内容…
```

`description` 字段是触发判据，务必精确描述使用场景，避免与其他技能产生歧义。

## 新增插件流程

1. 在 `plugins/` 下创建目录 `plugins/<plugin-name>/`
2. 创建 `plugins/<plugin-name>/.claude-plugin/plugin.json`
3. 在 `plugins/<plugin-name>/skills/<skill-name>/SKILL.md` 编写技能
4. 在 `.claude-plugin/marketplace.json` 的 `plugins` 数组中追加该插件条目

## 已发布插件

| 插件 | 技能 | 说明 |
|------|------|------|
| `huanxi` | `/huanxi-shared` `/huanxi-report` `/huanxi-leader` `/huanxi-task` `/huanxi-weekly` `/huanxi-org` | 寰汐企业管理系统完整工作流，含 MCP Server 自动配置 |
| `memcore` | `/memory-sync` `/memory-update` `/memory-lint` | 项目记忆体系核心引擎 |

### memcore 技能调用关系

```
/memory-sync   ← 总编排（11 phases），调用下面两个技能
  ├── /memory-update  ← 增量写入，可独立执行
  └── /memory-lint    ← 健康校验，可独立执行
```