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/ (24)

核心模型

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。

能力域	Skills
常驻 core	git-ops handoff teach；Claude 另含 cc-codex-review skill-creator
知识库 obsidian-kb	orbit-os orbit-session-diary official-article-ingest online-doc-html video-transcribe
前端设计 frontend-design	gsap fireworks-tech-graph ian-xiaohei-illustrations
API 测试 api-testing	apifox-cli apifox-test-case
社交只读 social-reading	bilibili bird-twitter reddit linuxdo xiaohongshu
macOS 维护