All My Ai Needs

Claude 平台目录（claude）

platforms/claude 是 Claude 平台专属真源。这个 README 负责展示当前 Claude agent 的完整能力与同步方式。仓库按 platform-first 维护：Claude 只关心 platforms/claude 下的内容，不再依赖 shared/skills/。

同步入口

./scripts/syncctl.sh check --direction repo-to-local --platform claude --scope all
./scripts/syncctl.sh apply --plan-id <plan_id> --approve-token <token>
./setup.sh
./setup.sh list
./setup.sh <skill-name>

退出码：

• 0：自动完成
• 2：需手动补齐
• 1：失败

说明：

• syncctl 是日常一致性检查与执行入口（最小同步口径 + 两阶段审批）
• 处理同步/提交/推送请求时，若用户只说“看下本地跟仓库有什么内容需要同步的”等未授权写入请求，默认先执行 check 并汇总，再等待用户审批后执行 apply / commit / push
• setup.sh 主要用于 bootstrap / 灾备 fallback

当前 Skills

Skill	能力	运行说明
bilibili	B站搜索、热门、排行、视频详情、音频入口与字幕读取	依赖 bili-cli + opencli（缺失时降级到 search API）
bird-twitter	只读访问 X/Twitter 内容	依赖 Bird CLI（仓库内置包优先）
cc-codex-review	Claude / Codex 协作讨论与 Battle Loop	依赖 CodexMCP 与 topic-manager
fireworks-tech-graph	结构化技术图与图片生成（架构图/流程图/时序图/泳道图，SVG+PNG）	依赖 python3 与 rsvg-convert
git-ops	按 Sam 习惯安全执行 Git 分支、提交、合并、推送与对比	依赖 git 与 rg
gsap	前端动效实现辅助，覆盖 GSAP core、React、ScrollTrigger、插件与性能约束	依赖 gsap，React 项目可加 @gsap/react
handoff	为下一位 agent、新线程或跨机器任务生成临时/持久交接文档	纯指令型 skill；临时写入 OS 临时目录，跨机器长期接力写入 Obsidian 08_交接台
ian-xiaohei-illustrations	为中文内容生成小黑 2.0 实物场景正文图与长卷故事图	直接出图依赖当前 Claude Code 环境的图片生成能力
linuxdo	只读访问 LINUX DO 论坛	依赖 Chrome Cookie
mole-mac-cleanup	安全使用 Mole (mo) 预览和清理 macOS 磁盘空间	依赖 Mole CLI，推荐 Homebrew 安装
official-article-ingest	官方文章收录到 Obsidian，区分原文 1:1 与英文中文对照 1:1，并保持源站排版美感	依赖目标 Vault、源站页面与本地媒体校验
online-doc-html	Markdown 导出为适合在线文档粘贴的 HTML	依赖 pandoc / rsvg-convert
orbit-os	OrbitOS Obsidian Vault 共享配置与规范	供 orbit-* 系列 skill 引用；含 08_交接台 与 iCloud AgentArtifacts 规范
orbit-session-diary	基于本地会话日志生成 Obsidian 日记	依赖本地 jsonl 与目标 Vault
playwright	MCP-only 真实浏览器自动化	依赖 playwright-ext 浏览器扩展会话
reddit	只读访问 Reddit 内容	依赖 Composio MCP
screenshot	系统级截图与区域捕获	使用 OS 级截图能力
skill-creator	创建、优化、评估 skills	用于 skill 设计与迭代
teach	在当前 workspace 中进行跨会话、可沉淀的概念与技能教学	纯指令型 skill；建议在独立学习目录中使用
video-transcribe	视频/音频全量转录、图文笔记与关键帧分析	依赖 yt-dlp / ffmpeg / Groq
xiaohongshu-session-reader	小红书 HTTP/API 优先读取	Chrome Cookie + Playwright fallback

平台能力资产

• 受管内容：CLAUDE.md、skills/、agents/、hooks/、.mcp.json、.claude-plugin/
• ./setup.sh 负责在 bootstrap / 灾备场景下把 platforms/claude 应用到 ~/.claude
• platforms/claude/.mcp.json 已内置 MCP：playwright-ext、chrome-devtools、playwright、context7、tavily
• skill 若需要依赖、手动步骤、验证命令，统一写入 repo 中对应 skill 目录下的 runtime.yaml
• 平台级 platforms/claude/runtime.yaml 仅用于仓库内 AI 理解迁移规则，不会同步到 ~/.claude 根目录
• skill 级 runtime.yaml 仅保留在 repo，不同步到 ~/.claude/skills/<skill>/