Agent/skills4claude/README.md

skills

Claude Code / Codex skills 的版本化源头。所有能给 Claude Code 或 Codex 使用的 skill 都放在这里，通过 install.sh 同步到对应客户端的 skills 目录。

这里放什么？

只放本仓库相关的 skill —— 也就是依赖或协作于 cyber-agent / KnowHub / ToolHub 的那些。

Skill	形态	依赖
agent/	CLI 薄壳 + 共享 config	cyber-agent editable install
toolhub/	自包含单脚本	仅 httpx（可选 cyber_sdk 走 OSS）
knowhub/	自包含单脚本	仅 httpx
content-search/	纯文档，调 python -m ...	cyber-agent editable install

个人/跨项目的 skill（如 glk-*、stitch-images）不放这里。

安装

# 默认：安装到 Claude Code，symlink，适合本机开发
bash skills4claude/install.sh

# 安装到 Codex
bash skills4claude/install.sh --codex

# 明确安装到 Claude Code
bash skills4claude/install.sh --claude

# 跨机器部署：copy，脱离 repo
bash skills4claude/install.sh --copy

# 只装指定 skill
bash skills4claude/install.sh --skills agent,toolhub

# 改安装路径
bash skills4claude/install.sh --target /some/other/dir

# 先看会做什么，不动文件
bash skills4claude/install.sh --dry-run

# 强制覆盖已有内容（否则冲突即失败）
bash skills4claude/install.sh --force

默认目标：

• Claude Code：~/.claude/skills/
• Codex：${CODEX_HOME:-~/.codex}/skills/

symlink 模式下在 skills4claude/X/* 改文件会立即反映在目标目录的 X/。 copy 模式下每次改完需要重跑脚本。 Codex 需要重启后才会重新索引新安装的 skills。

冲突处理

install.sh 不自动备份。遇到目标已存在的情况会这样处理：

• 已是指向本 repo 的 symlink → 安静跳过（no-op）
• 其他（旧目录 / 错位 symlink / 普通文件）→ 报错退出（exit 2），打印现状让你自己决定

想覆盖加 --force，它会 rm -rf 现有目标再装。不会偷偷复制到 .bak.* —— 那样只会污染客户端的 skills 目录（Claude Code / Codex 都可能把 .bak.* 当成 skill 去索引）。旧内容若有价值，大多数时候本来就在 git 里；真要保底，自己 mv 一下再跑脚本。

跨项目调用

所有脚本都用绝对路径调用，不受 CWD 影响：

# agent — 本地或远端 agent
python ~/.claude/skills/agent/invoke.py --agent_type=remote_librarian --task="..."
python ~/.codex/skills/agent/invoke.py --agent_type=remote_librarian --task="..."

# toolhub — 远程 AI 工具
python ~/.claude/skills/toolhub/toolhub.py call --tool_id=flux_gen --params='{...}'
python ~/.codex/skills/toolhub/toolhub.py call --tool_id=flux_gen --params='{...}'

# knowhub — 知识库
python ~/.claude/skills/knowhub/knowhub.py search --query="..."
python ~/.claude/skills/knowhub/knowhub.py save --task="..." --content="..."
python ~/.claude/skills/knowhub/knowhub.py ask --query="..."
python ~/.codex/skills/knowhub/knowhub.py search --query="..."
python ~/.codex/skills/knowhub/knowhub.py save --task="..." --content="..."
python ~/.codex/skills/knowhub/knowhub.py ask --query="..."

# content-search — 内容平台搜索
python -m agent.tools.builtin.content.tools platforms

每个脚本的 trace / 输出都落在调用方 CWD 的 .cache/ 下，和项目解耦。