all-my-ai-needs

跨 Claude Code 与 Codex 两套 agent 的 skill 真源，以及点名安装的 Claude Mods 来源与迁移约定。写入由 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
    │   ├── skills.meta.yaml         # repo-only 同步分层真源
    │   ├── skills/ (23)
    │   ├── mods.meta.yaml           # 可选 Mod 清单，默认 manual-only
    │   ├── mods/pixel-buddy/        # 原创/授权源码、来源哈希和点名安装器
    │   └── .claude-plugin/plugin.json
    └── codex/                      # Codex 平台真源 → ~/.codex
        ├── README.md  runtime.yaml  config.toml
        ├── skills.meta.yaml         # repo-only 同步分层真源
        └── skills/ (21)

核心模型

1. platform-first —— platforms/claude/、platforms/codex/ 各为真源，互不依赖；不设跨平台共享 skill 目录，同名 skill 按各自平台约定演化。
2. agent 写入 · 人审校 —— 仓库内容默认由 agent 维护。涉及写入的操作先产出差异清单交人审批再执行；仓库不提供全局镜像脚本；skills 同步由 agent 读元数据完成，可选 Mod 使用自身经过审查的点名安装器。
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 official-article-ingest online-doc-html video-transcribe
前端设计 frontend-design	gsap fireworks-tech-graph ian-xiaohei-illustrations mono-color
API 测试 api-testing	apifox-cli apifox-test-case
社交阅读与收藏整理 social-reading	bilibili bird-twitter bird-bookmark-folders reddit linuxdo xiaohongshu
macOS 维护 macos-local	mole-mac-cleanup
点名 manual-only	aihot

同步模型

日常同步由 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 Mods

pixel-buddy-sam 保存像素剩余额度、透明宠物背景和 cache / ctx 高亮。 1.0.0-rc.4 接入 MIT 授权的 pixel-at-work 动画并补充浅色白天、深色夜晚两套场景，额度区收窄 80px，动画高度保持 54px；仅依据主会话生命周期切换，cache 底栏独立更新。 在已经克隆的仓库根执行：

python3 platforms/claude/mods/pixel-buddy/install.py

需要 Python 3.9+ 和 Claude Code CLI。安装器校验包内源码与许可的 SHA-256，离线组装， 在设备私有缓存生成完整插件与本机 marketplace，用官方 CLI 安装到 user scope；不改项目、权限或现有会话。 原版已启用或发现本地改动时停止，不自动替换。候选版现场验证需要新的 Desktop Code 本地会话。 Mod 由 mods.meta.yaml 单独登记，默认不随 skills 同步；运行态、凭据、真实设置不入仓，未明确许可的上游源码不公开发布。

治理与约定

• 协作规范：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。