all-my-ai-needs

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。

同步模型

日常同步由 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 倒计时和上下文压缩进度。 1.0.0-rc.23 让宠物住进同一间固定的小房间，状态只更换舞台上的动作和道具：思考、干活、回复来自模型响应的块种类，提问与计划确认弹窗显示“等你”，回合出错或被中断各闪现约 6 秒，休息时的咖啡随 cache 剩余寿命变凉；小人只有两只小眼睛。普通工具的权限确认宿主不单独通知，仍显示干活。保留两组完整额度、54px 高度、透明底色与浅深主题；主会话真实压缩和工作优先于后台等待，后台任务追踪补齐了子代理通知的声明外壳、续接会话补发的 stopped、快照里的新状态词和回合结束未返回的前台调用四处缺口；紧凑底栏及实际压缩阈值读数沿用现有逻辑，不增加轮询。宿主为已发布 Artifact 挂的评论监视等订阅类任务不再算等待，信箱不会因它们一直亮着；另有只读命令 /buddy-status，信箱疑似记错时可列出插件记着的后台任务及类型，与 /tasks 对照。 在已经克隆的仓库根执行：

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

需要 Python 3.9+ 和 Claude Code CLI。安装器校验包内源码与许可的 SHA-256，离线组装， 在设备私有缓存生成完整插件与本机 marketplace，用官方 CLI 安装到 user scope；不改项目、权限或现有会话。 原版已启用或发现本地改动时停止，不自动替换。保留原生目录入口与提示槽；rc.23 由作者于 2026-10-18 放行，未做原生 App 新会话实测；现场验证仍需要新的 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。

平台文档

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