all-my-ai-needs

all-my-ai-needs

跨 Claude Code 与 Codex 两套 agent 的 skill 能力真源与同步规则。写入由 agent 执行，人只审校与决策。

把 Claude Code 与 Codex 的可复用能力收敛到一个仓库，按 platform-first 维护：每个平台独立持有自己的 skills/ 与运行约定，同名 skill 允许在两端并存，不强行抽象去重。

仓库要解决的是多端 AI 配置的漂移——GitHub 仓库、本地工作区、本地 CLI 运行目录（~/.claude、~/.codex）三者保持一致。所有写入（同步、提交、推送）由 agent 执行：agent 拉仓库后读 runtime.yaml / skills.meta.yaml，把 skill 真源 diff 后落到运行目录，人负责审校差异与最终决策。

仓库结构

all-my-ai-needs/
├── README.md                       # 仓库总览(本文件)
├── CLAUDE.md / AGENTS.md           # Claude / Codex 协作规范
├── PROFILES.md                     # skill 同步分层(scope / profile)
├── .claude-plugin/marketplace.json
└── platforms/
    ├── claude/                     # Claude 平台真源 → ~/.claude
    │   ├── README.md  runtime.yaml  .mcp.json
    │   ├── skills.meta.yaml         # repo-only 同步分层真源
    │   ├── skills/ (24)
    │   └── .claude-plugin/plugin.json
    └── codex/                      # Codex 平台真源 → ~/.codex
        ├── README.md  runtime.yaml  config.toml
        ├── skills.meta.yaml         # repo-only 同步分层真源
        └── skills/ (22)

核心模型

1. platform-first —— platforms/claude/、platforms/codex/ 各为真源，互不依赖；不设跨平台共享 skill 目录，同名 skill 按各自平台约定演化。
2. agent 写入 · 人审校 —— 仓库内容默认由 agent 维护。涉及写入的操作先产出差异清单交人审批再执行；仓库不提供同步脚本，同步与校验都由 agent 读元数据完成。
3. scope / profile 分层 —— 每个 skill 标注 scope（core / project / manual-only）与项目类型 profile，决定何时下发到运行目录。机读真源是各平台 skills.meta.yaml，人读视图与同步剧本见 PROFILES.md。

能力地图

按能力域分组；完整 per-skill 能力与运行依赖见各平台 README。

同步模型

日常同步由 agent 驱动：agent 拉仓库后，读各平台 skills.meta.yaml 与 skills/ 真源，与对应运行目录（~/.claude/skills、~/.codex/skills）做最小差异 diff，人审通过后再落盘。仓库不再提供同步脚本；新机初始化 / 灾备同样由 agent 按 runtime.yaml 把全部 skill 铺到运行目录。

下发禁区（任何方向都遵守）：

• runtime.yaml、skills.meta.yaml、PROFILES.md 等治理元数据只留在仓库，不进入 ~/.claude、~/.codex。
• 本地 repo 之外的私有 skill（带私有前缀，不公开）与含内网信息的配置不回流仓库，也不被同步删除。

治理与约定

• 协作规范：CLAUDE.md（Claude Code）、AGENTS.md（Codex / 通用 agent）。
• 同步分层：PROFILES.md；改动 skill 后由 agent 核对 skills.meta.yaml manifest 与 skills/ 目录是否一致。
• 提交门禁：推送前必过隐私扫描与 git diff --check；提交信息遵循 Conventional Commits 且含 [更新摘要]，提交后打 annotated tag。细则见 AGENTS.md。

平台文档

• Claude 完整 skill 清单与同步说明：platforms/claude/README.md
• Codex 完整 skill 清单与同步说明：platforms/codex/README.md