Claude Code Skills & Agents
给 Claude Code 加上深度调研、图片生成、GitHub 自动化等能力，配好多模型切换，开箱即用。
OpenAI Codex 的配置和自定义 prompt 请参考 feiskyer/codex-settings。
快速开始
推荐使用 Claude 官方 marketplace 安装，有两种等价方式：
方式一：在 Claude Code 会话内使用 slash command
/plugin marketplace add feiskyer/claude-code-settings
# 安装主插件（包含所有技能和代理）
/plugin install claude-code-settings
方式二：使用 Claude Code 命令行
claude plugin marketplace add feiskyer/claude-code-settings
# 安装主插件（包含所有技能和代理）
claude plugin install claude-code-settings@claude-code-settings
主插件包含的完整技能列表：brainstorming、codex-skill、deep-research、github-fix-issue、github-review-pr、gpt-image-skill、grill-me、handoff、nanobanana-skill、skill-creator、translate、youtube-transcribe-skill，详见技能列表。单个技能也可以通过 npx skills 按需安装（见下方其他安装方式）。
注意： ~/.claude/settings.json 不通过 Plugin 配置，需要手动设置。
npx skills
⚠️ 注意： npx skills 安装的技能版本可能滞后于本仓库最新版本。如需获取最新技能，请优先使用上方的官方 marketplace 方式。
npx skills 可以为你的 AI 编程工具按需安装单个技能：
# 列出可用技能
npx -y skills add -l feiskyer/claude-code-settings
# 安装全部技能
npx -y skills add --all feiskyer/claude-code-settings
# 手动选择要安装的技能
npx -y skills add feiskyer/claude-code-settings
手动安装
⚠️ 手动安装会覆盖 ~/.claude 目录，请务必先备份原有配置。
# 备份原有配置
mv ~/.claude ~/.claude.bak
# 克隆本仓库
git clone https://github.com/feiskyer/claude-code-settings.git ~/.claude
# 启动 Copilot Gateway 代理（监听 http://localhost:4141）
npx copilot-gateway@latest start --proxy-env
# 也可以用 tmux 在后台运行
# tmux new-session -d -s copilot 'npx copilot-gateway@latest start --proxy-env'
首次启动会提示认证：
Please visit https://github.com/login/device and enter code XXXX-XXXX to authenticate.
打开链接，登录并授权你的 GitHub Copilot 账户。
注意：
-
仓库根目录的 settings.json 是作者的配置模板，默认指向 copilot-gateway 代理（http://localhost:4141）。如需使用 LiteLLM Proxy Server 等其他网关，把 ANTHROPIC_BASE_URL 改为对应地址（如 http://localhost:4000）即可。
-
确保以下模型在你的账户中可用，否则需替换为你自己的模型名（模型名以你的网关实际提供的为准）：
- ANTHROPIC_DEFAULT_SONNET_MODEL: claude-sonnet-5
- ANTHROPIC_DEFAULT_OPUS_MODEL: claude-opus-5
- ANTHROPIC_DEFAULT_HAIKU_MODEL: claude-haiku-4-5
-
模板中 defaultMode 为 acceptEdits（自动接受文件编辑但保留命令确认）。如需完全跳过权限确认可自行改为 bypassPermissions，但请了解其安全风险后再启用。
技能列表
技能是可复用的能力模块，教会 Claude 如何完成特定任务。可通过 /skill-name [参数] 手动调用，或根据上下文自动触发。
在构建新功能、创建新组件或设计新系统之前使用。通过协作对话探索用户意图、需求和设计方案，再进入实现阶段。
触发词： 用户描述想要构建的东西且涉及设计决策
核心特性：
- 逐个提问，渐进式理解需求
- 提出 2-3 个方案并推荐最优解
- 分节呈现设计，每节获得用户认可
- 编写规格文档并自审
- 可选的浏览器可视化伴侣（展示 mockup、图表、布局对比）
非交互式自动化模式，把编码、代码审查和计划审查交给 OpenAI Codex 完成。
触发词： "codex", "use gpt", "gpt-5", "let openai", "full-auto", "adversarial review", "用codex", "让gpt实现", "对抗式审查", "让codex审查计划", "第二意见"
核心特性：
- 多种执行模式（只读、工作区写入、完全访问）
- 对抗式代码审查（结构化 JSON findings）与实现前的计划审查
- 审查结果只呈现不自动改码；Codex 调用失败时如实报告而非代答
- 默认使用
~/.codex/config.toml 中配置的模型；非交互、可嵌入自动化流程
- JSON 结构化输出、增量恢复会话（
resume --last）
- Prompt 组合模板、审查工作流、CLI 参考见
references/ 目录
依赖： Codex CLI（npm i -g @openai/codex 或 brew install codex）
通过 Google Gemini API 生成或编辑图片。这是默认图片技能——未指明提供商的图片请求都路由到这里。
触发词： "nanobanana", "generate image", "create image", "edit image", "图片生成", "生成图片", "AI绘图", "图片编辑"
核心特性：
- 多种宽高比和分辨率（1K、2K、4K）
- 图片编辑功能
- 多模型选择（gemini-3.1-flash-image-preview 默认, gemini-3-pro-image-preview 高质量）
依赖：
GEMINI_API_KEY（配置在 ~/.nanobanana.env）- Python3 + google-genai, Pillow, python-dotenv
使用 OpenAI GPT Image 模型（gpt-image-2, gpt-image-1 等）生成或编辑图片。仅在用户明确指定 OpenAI/GPT 时触发；未指明提供商的图片请求由 nanobanana-skill 处理。
触发词： "gpt image", "openai image", "generate image with openai", "用 openai 画图", "用 GPT 生成图片"
核心特性：
- 多模型支持（gpt-image-2, gpt-image-1.5, gpt-image-1, gpt-image-1-mini）
- 最多 3 张参考图编辑
- 多种尺寸和质量等级
- 透明背景、多输出格式（png, jpeg, webp）
依赖：
OPENAI_API_KEY（配置在 ~/.gpt-image.env 或环境变量）- Python3 + openai, Pillow
从 YouTube 视频链接提取字幕/转录文本。
核心特性：
- 双提取方式：CLI（快速）和浏览器自动化（兜底）
- 自动选择字幕语言（zh-Hans, zh-Hant, en）
- 保存转录文本到本地文件
依赖： yt-dlp（CLI 方式）或 chrome-devtools-mcp（浏览器方式）
多 Agent 编排工作流：将调研目标拆分为可并行子目标，通过 claude -p 子进程执行，聚合结果并交付精修报告。
触发词： "深度调研", "deep research", "wide research", "多Agent并行调研"
核心特性：
- 多 Agent 编排：拆分目标为并行子任务
- Skills 优先策略：已安装技能 → MCP 工具 → WebFetch/WebSearch
- 结构化交付：生成文件级报告，含摘要和结论
- 逐章精修与来源验证
- 可扩展执行：从微型（1-2 任务）到大型（15+）
产出目录结构：
.research/<name>/
├── prompts/ # 子任务 prompt
├── child_outputs/ # 子进程输出
├── logs/ # 执行日志
├── raw/ # 原始数据缓存
└── final_report.md # 最终报告
将英文或日文技术文章翻译为自然流畅的中文。采用三步法（直译、问题识别、意译），保留 Markdown 格式和技术术语原文。
用法： /translate [粘贴文本或提供文件路径]
针对方案或设计的高强度追问式面试，沿着设计决策树逐一深入，过程中同步维护领域模型（术语表和 ADR）。
触发词： /grill-me [方案/设计描述]（仅手动调用）
核心特性：
- 一次只问一个问题，每个问题给出推荐答案
- 自动对照术语表质疑含糊表达
- 与代码交叉验证用户陈述
- 即时更新
CONTEXT.md 术语表
- 审慎创建 ADR（仅限难以逆转的重大决策）
- 支持单上下文和多上下文（Context Map）仓库
将当前对话压缩为交接文档，供下一个 agent 无缝接续工作。
触发词： /handoff [下一次会话的重点方向]（仅手动调用）
核心特性：
- 结构化交接：背景与目标、已完成工作、当前状态、待办事项、推荐技能、关键上下文
- 通过路径/URL 引用已有产物，避免重复
- 自动脱敏处理（API key、密码、PII）
- 智能判断：对话过短时提示无需生成
输出： $TMPDIR/handoff-YYYY-MM-DD-HHMM.md
从分析到创建分支、实现、测试、提交 PR 的完整 Issue 修复流程。
使用并行子代理进行多角度代码分析（含安全维度），配合对抗式验证——质疑者需在 head SHA 处复读代码、findings 必须附 file:line 与原文引用。支持置信度评分与误报过滤、去重与一致性计数、更新 PR 的增量复审、批量行内评论，干净 PR 自动 LGTM 通过。
创建、迭代优化和基准测试 Agent 技能，包含定量评估循环和描述优化。
子代理
agents/ 目录包含扩展 Claude Code 能力的专业化子代理。
| 代理 | 功能 |
|---|
| pr-reviewer | GitHub PR 代码审查专家 |
| github-issue-fixer | GitHub Issue 修复专家 |
| instruction-reflector | 分析和改进 Claude Code 指令 |
| deep-reflector | 会话分析和学习捕获 |
| insight-documenter | 技术突破文档化 |
| ui-engineer | UI/UX 开发专家 |
配置模板
配置模板目录 — 为各种模型提供商预配置的 settings.json。
脚本工具
scripts/ 目录包含维护 Claude Code 环境的实用脚本。
bash ~/.claude/scripts/update-cc-plugins.sh
扩展 Web 搜索
WebSearch 是 Anthropic 专有工具，仅限官方 API 环境。通过接入以下 MCP 服务器可在任意环境中启用网页搜索：
常见问题
- 确认路径正确：
~/.claude/skills/<name>/SKILL.md（注意大小写，必须是 SKILL.md）
- 通过 Plugin 安装的技能需要重启会话才能加载
- 检查是否存在双层嵌套目录（
skills/name/name/SKILL.md），需上移一层
- 验证加载状态：直接问 Claude "What skills do you have access to?"
disable-model-invocation: true 的技能（如 grill-me、handoff）不会自动触发，需用 /skill-name 手动调用
- 本仓库提供了 10 套配置模板，复制对应的 settings.json 即可
- 核心是设置
ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 指向你的提供商端点
- 使用 GitHub Copilot 需先启动 copilot-gateway：
npx copilot-gateway@latest start --proxy-env
- 详细指南见 使用 GitHub Copilot 作为模型提供商 和 使用 LLM 网关
- 建议精选需要的技能，不要全装。过多技能会增加上下文消耗、降低触发准确度
- 推荐用 Plugin 安装后按需禁用；也可以用
npx skills add feiskyer/claude-code-settings 手动挑选（注意该方式版本可能滞后）
- 如果发现 Claude 响应变慢或触发错误的技能，考虑减少已安装数量
- 重新运行
npx copilot-gateway@latest start --proxy-env，按提示完成设备认证
- VSCode 扩展用户需在扩展设置中单独配置环境变量（见下方 VSCode 登录问题）
- 本仓库 settings.json 模板默认
defaultMode 为 acceptEdits（自动接受编辑，保留命令确认）
- 如需进一步减少确认，可在 settings.json 的
permissions.allow 中配置允许列表
- 完全跳过确认可改为
bypassPermissions，但请了解其安全风险
如果不使用 Claude.ai 订阅，需在 VSCode settings.json 中手动配置环境变量：
{
"claude-code.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "http://localhost:4000" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-dummy" },
{ "name": "ANTHROPIC_MODEL", "value": "opusplan" },
{ "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" },
{ "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5" },
{ "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "gpt-5-mini" },
{ "name": "DISABLE_TELEMETRY", "value": "1" }
]
}
同时需要 ~/.claude/config.json 的内容来跳过 claude.ai 登录。
确保 ANTHROPIC_AUTH_TOKEN 中配置的 API key 已添加到 ~/.claude.json 的已批准列表：
{
"customApiKeyResponses": {
"approved": ["sk-dummy"],
"rejected": []
}
}
贡献
欢迎提交 Issue 和 Pull Request！开发与测试指南详见 CONTRIBUTING.md。
参考指南
参考资源
如果这个项目对你有帮助，欢迎点个 ⭐ 支持一下！
许可证
本项目基于 MIT 许可证发布 — 详见 LICENSE。
@feiskyer