johnQ
d43b414fc9
- 新增 SCOPE.md 收录门槛 + .out-of-scope/ 拒绝档案 - 生命周期分桶 promoted/beta/deprecated，marketplace 只发布 promoted - 调用模式 model-invoked/user-invoked（user-invoked 不占模型目录） - 新增脚本 validate-skills.py / generate-catalog.py / scan-skill.sh(+allowlist) - 新增 beta 技能 skill-creator、ai-proj-helper-entry、verification-before-completion（各带 evals） - install-skills.sh: --agent dsh / --link / --audit / --include-beta / --no-validate - 融合：dev-review 接收评审意见、req-design 依赖边、agent-swarm 并行编排、dev-test TDD - catalog.json 61 个技能（58 promoted / 3 beta）；validate 0 错误；scan 0 高危；现有测试通过
62 lines
2.0 KiB
Markdown
62 lines
2.0 KiB
Markdown
# 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`。
|