Files

T

johnQ d43b414fc9 feat(skill): 技能治理 v0.2 —— 分桶/调用模式/校验/安全/清单/安装矩阵

- 新增 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 高危；现有测试通过

2026-10-31 22:03:13 +08:00

2.0 KiB

Raw Permalink Blame History

ai-proj-helper

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

快速开始

./install-skills.sh

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

./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

添加新技能

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

禁用技能

编辑 claude-config.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。

2.0 KiB Raw Permalink Blame History Unescape Escape