# ai-proj-helper

Codex 优先、兼容 Claude Code 的 Agent Skills 市场与 MCP 配置管理工具。

## 快速开始

```bash
./install-skills.sh
```

默认安装到 Codex 标准目录 `~/.agents/skills`。Claude Code 的 MCP 与 marketplace 初始化使用：

```bash
./init.sh --mode sse --token aiproj_pk_xxx
```

## 目录结构

```
ai-proj-helper/
├── skills-core/           # 基础设施技能
├── skills-dev/            # 开发与发布技能
├── skills-req/            # 需求管理技能
├── skills-integration/    # 第三方集成技能
├── skills-biz/            # 商务技能
├── skills-personal/       # 个人（.gitignore 排除）
├── claude-config.yaml     # 技能启用/禁用 + MCP 配置
├── init.sh                # MCP 初始化
└── generate-marketplace.py
```

## 添加新技能

1. 在对应分类目录下创建 `<name>-plugin/` 目录
2. 创建 `.claude-plugin/plugin.json` 和 `skills/SKILL.md`
3. 运行 `python3 generate-marketplace.py` 重新生成 marketplace.json

## 禁用技能

编辑 `claude-config.yaml`：

```yaml
skills:
  disabled:
    - "biz-ops-plugin"
```

重新运行 `./init.sh` 或 `python3 generate-marketplace.py`。

## 技能目录说明

- `skills-personal/` 不被 Git 跟踪，用于存放个人配置和工具
- 其余 `skills-*` 目录均由 Git 版本控制
- 只有受 Git 跟踪的分类目录会被 `generate-marketplace.py` 扫描并加入公开 marketplace；`skills-personal/` 始终排除

## 技能治理规则

- 公开 marketplace 只发布 `status=promoted`；`beta`/`deprecated` 不进 marketplace（`generate-marketplace.py` 已按 status 过滤）。
- 每个 `plugin.json` 建议带 `status`，每个 `SKILL.md` 在 `metadata.invocation` 标 `model-invoked` / `user-invoked`。
- 任何技能增删改后，回改 `catalog.json` 与入口技能 `ai-proj-helper-entry`。
- 提交前依次跑：`python3 scripts/validate-skills.py`、`./scripts/scan-skill.sh`、`python3 scripts/generate-catalog.py`。