naruto-skills

naruto 为提升日常工作效率而分享的 Claude Code 技能集。

前置要求

• 已安装 Node.js 环境
• 能够运行 npx bun 命令

安装

快速安装（推荐）

npx skills add zlh-428/naruto-skills

注册插件市场

在 Claude Code 中运行：

/plugin marketplace add zlh-428/naruto-skills

可用插件

| 插件 | 说明 | 包含技能 | |------|------|----------| | content-skills | 内容生成和发布 | cover-image, comic, infographic, article-illustrator | | ai-generation-skills | AI 图像生成 | image-gen | | utility-skills | 内容处理工具 | url-to-markdown | | dev-skills | 开发工作流和工具 | smart-git-commit |

可用技能

内容生成与发布

cover-image

为文章生成手绘风格封面图，支持多种样式。

# 从 Markdown 文件自动选择样式
/cover-image path/to/article.md

# 指定样式
/cover-image path/to/article.md --style tech
/cover-image path/to/article.md --style warm

# 不显示标题文字
/cover-image path/to/article.md --no-title

可用样式: elegant (默认), blueprint, bold-editorial, chalkboard, dark-atmospheric, editorial-infographic, fantasy-animation, flat-doodle, intuition-machine, minimal, nature, notion, pixel-art, playful, retro, sketch-notes, vector-illustration, vintage, warm, watercolor

comic

知识漫画创作工具，支持多种风格 (Logicomix/Ohmsha 漫画指南)。创建原创教育漫画，包含详细分镜和顺序图像生成。

# 从源材料生成
/comic posts/turing-story/source.md

# 指定样式
/comic posts/turing-story/source.md --style dramatic
/comic posts/turing-story/source.md --style ohmsha

# 自定义样式 (自然语言)
/comic posts/turing-story/source.md --style "watercolor with soft edges"

# 指定布局和比例
/comic posts/turing-story/source.md --layout cinematic
/comic posts/turing-story/source.md --aspect 16:9

# 指定语言
/comic posts/turing-story/source.md --lang zh

选项: | 选项 | 值 | |------|-----| | --style | classic (默认), dramatic, warm, sepia, vibrant, ohmsha, realistic, wuxia, shoujo, 或自定义描述 | | --layout | standard (默认), cinematic, dense, splash, mixed, webtoon | | --aspect | 3:4 (默认竖屏), 4:3 (横屏), 16:9 (宽屏) | | --lang | auto (默认), zh, en, ja 等 |

样式 (视觉美学):

| 样式 | 描述 | 适用场景 | |------|------|----------| | classic (默认) | 传统 Ligne Claire 风格，均匀轮廓线，平涂色彩，精细背景 | 传记，平衡叙事，教育内容 | | dramatic | 高对比度重阴影，强烈表情，角度构图 | 关键发现，冲突，高潮场景 | | warm | 柔和边缘，金色调，舒适内饰，怀旧感 | 个人故事，童年场景，指导 | | sepia | 复古插画风格，旧纸效果，时代细节 | 1950年前故事，古典科学，历史人物 | | vibrant | 活力线条，重量变化，明亮色彩，动感姿势 | 科学解释，"顿悟"时刻，年轻观众 | | ohmsha | 漫画指南风格，视觉隐喻 gadgets，师生互动 | 技术教程，复杂概念 (ML, 物理) | | realistic | 全彩写实漫画，数字绘画，平滑渐变，准确比例 | 红酒，餐饮，商业，生活，专业话题 | | wuxia | 香港武侠风格，墨水笔触，动态战斗，气效果 | 武侠，武侠/仙侠，中国历史小说 | | shoujo | 经典少女漫画，大闪亮眼睛，花朵，闪光，柔和粉紫色调 | 浪漫，成长，友谊，情感戏剧 |

布局 (面板排列): | 布局 | 每页面板数 | 适用场景 | |------|-----------|----------| | standard | 4-6 | 对话，叙事流畅 | | cinematic | 2-4 | 戏剧性时刻，定场镜头 | | dense | 6-9 | 技术解释，时间线 | | splash | 1-2 大图 | 关键时刻，揭示 | | mixed | 3-7 变化 | 复杂叙事，情感弧线 | | webtoon | 3-5 垂直 | Ohmsha 教程，手机阅读 |

infographic

专业信息图表生成工具，提供 20 种布局类型和 17 种视觉样式。分析内容，推荐布局×样式组合，生成可直接发布的信息图表。

# 基于内容自动推荐组合
/infographic path/to/content.md

# 指定布局
/infographic path/to/content.md --layout pyramid

# 指定样式 (默认: craft-handmade)
/infographic path/to/content.md --style technical-schematic

# 同时指定
/infographic path/to/content.md --layout funnel --style corporate-memphis

# 指定比例
/infographic path/to/content.md --aspect portrait

选项: | 选项 | 描述 | |------|------| | --layout <name> | 信息布局 (20 种) | | --style <name> | 视觉样式 (17 种，默认: craft-handmade) | | --aspect <ratio> | 横屏 (16:9), 竖屏 (9:16), 方形 (1:1) | | --lang <code> | 输出语言 (en, zh, ja 等) |

布局 (信息结构):

| 布局 | 适用场景 | |------|----------| | bridge | 问题-解决方案，差距跨越 | | circular-flow | 循环，重复过程 | | comparison-table | 多因素比较 | | do-dont | 正确 vs 错误做法 | | equation | 公式分解，输入输出 | | feature-list | 产品功能，项目符号 | | fishbone | 根本原因分析 | | funnel | 转化过程，过滤 | | grid-cards | 多主题，概览 | | iceberg | 表面 vs 隐藏方面 | | journey-path | 客户旅程，里程碑 | | layers-stack | 技术栈，层次 | | mind-map | 头脑风暴，想法映射 | | nested-circles | 影响范围，层级 | | priority-quadrants | 艾森豪威尔矩阵，2x2 | | pyramid | 层级，马斯洛需求 | | scale-balance | 利弊权衡 | | timeline-horizontal | 历史，年代事件 | | tree-hierarchy | 组织图表，分类 | | venn | 重叠概念 |

样式 (视觉美学):

| 样式 | 描述 | |------|------| | craft-handmade (默认) | 手绘插画，纸艺美学 | | claymation | 3D 黏土人物，趣味定格动画 | | kawaii | 日本可爱，大眼睛，粉彩 | | storybook-watercolor | 柔和水彩插画，异想天开 | | chalkboard | 彩色粉笔在黑板上 | | cyberpunk-neon | 霓虹灯光在暗色上，未来感 | | bold-graphic | 漫画风格，网点，高对比 | | aged-academia | 复古科学，棕褐色素描 | | corporate-memphis | 平面向量人物，活力填充 | | technical-schematic | 蓝图，等轴 3D，工程 | | origami | 折叠纸形式，几何 | | pixel-art | 复古 8-bit，怀旧游戏 | | ui-wireframe | 灰度框线，界面模型 | | subway-map | 交通图，彩色线条 | | ikea-manual | 极简线条艺术，装配风格 | | knolling | 整理平铺，俯视 | | lego-brick | 乐高积木构建，趣味 |

article-illustrator

智能文章配图工具。分析文章内容，在需要视觉辅助的位置生成插图。

# 基于内容自动选择样式
/article-illustrator path/to/article.md

# 指定样式
/article-illustrator path/to/article.md --style warm
/article-illustrator path/to/article.md --style watercolor

样式 (视觉美学):

| 样式 | 描述 | 适用场景 | |------|------|----------| | notion (默认) | 极简手绘线条艺术 | 知识分享，SaaS，生产力 | | elegant | 精致，老练，专业 | 商业，思想领导力 | | warm | 友好，接纳，以人为中心 | 个人成长，生活 | | minimal | 超干净，禅意，专注 | 哲学，极简主义 | | playful | 有趣，创造，俏皮 | 教程，入门指南 | | nature | 有机，平静，朴实 | 可持续发展，健康 | | sketch | 原始，真实，笔记本风格 | 想法，头脑风暴 | | watercolor | 柔和艺术，自然温暖 | 生活，旅行，创造 | | vintage | 怀旧旧纸美学 | 历史，传记 | | scientific | 学术精确图表 | 生物，化学，技术 | | chalkboard | 课堂粉笔画风格 | 教育，教程 | | editorial | 杂志风格信息图 | 技术解释，新闻 | | flat | 现代平面向量插画 | 创业，数字 | | flat-doodle | 粗轮廓，粉彩，可爱 | 生产力，SaaS，工作流 | | retro | 80/90s 活力怀旧 | 流行文化，娱乐 | | blueprint | 技术图表，工程 | 架构，系统设计 | | vector-illustration | 平面向量，黑色轮廓，复古 | 教育，创造，品牌 | | sketch-notes | 柔和手绘，温暖感受 | 知识分享，教程 | | pixel-art | 复古 8-bit 游戏美学 | 游戏，技术，开发者 | | intuition-machine | 技术简报，双语 | 学术，技术，研究 | | fantasy-animation | 吉卜力/迪士尼异想天开风格 | 故事讲述，儿童 |

AI 生成后端

image-gen

基于官方 OpenAI 和 Google APIs 的图像生成工具。支持文本到图像、参考图像、宽高比和质量预设。

# 基础生成 (自动检测提供商)
/image-gen --prompt "一只可爱的猫" --image cat.png

# 指定宽高比
/image-gen --prompt "风景" --image landscape.png --ar 16:9

# 高质量 (2k)
/image-gen --prompt "横幅" --image banner.png --quality 2k

# 指定提供商
/image-gen --prompt "一只猫" --image cat.png --provider openai

# 使用参考图像 (仅 Google 多模态)
/image-gen --prompt "变成蓝色" --image out.png --ref source.png

选项: | 选项 | 描述 | |------|------| | --prompt, -p | 提示词 | | --promptfiles | 从文件读取提示词 (拼接) | | --image | 输出图像路径 (必填) | | --provider | google 或 openai (默认: google) | | --model, -m | 模型 ID | | --ar | 宽高比 (如 16:9, 1:1, 4:3) | | --size | 尺寸 (如 1024x1024) | | --quality | normal 或 2k (默认: normal) | | --ref | 参考图像 (仅 Google 多模态) |

环境变量: | 变量 | 描述 | 默认值 | |------|------|--------| | OPENAI_API_KEY | OpenAI API 密钥 | - | | GOOGLE_API_KEY | Google API 密钥 | - | | OPENAI_IMAGE_MODEL | OpenAI 模型 | gpt-image-1.5 | | GOOGLE_IMAGE_MODEL | Google 模型 | gemini-3-pro-image-preview | | OPENAI_BASE_URL | 自定义 OpenAI 端点 | - | | GOOGLE_BASE_URL | 自定义 Google 端点 | - |

提供商自动选择:

1. 如果指定 --provider → 使用该提供商
2. 如果只有一个 API 密钥 → 使用该提供商
3. 如果两个都有 → 默认使用 Google

内容处理工具

url-to-markdown

通过 Chrome CDP 获取任意 URL 并转换为干净的 Markdown。支持两种捕获模式。

# 自动模式 (默认) - 页面加载后捕获
/url-to-markdown https://example.com/article

# 等待模式 - 用于需要登录的页面
/url-to-markdown https://example.com/private --wait

# 保存到指定文件
/url-to-markdown https://example.com/article -o output.md

捕获模式: | 模式 | 描述 | 适用场景 | |------|------|----------| | Auto (默认) | 页面加载后立即捕获 | 公开页面，静态内容 | | Wait (--wait) | 等待用户信号再捕获 | 需要登录，动态内容 |

选项: | 选项 | 描述 | |------|------| | <url> | 要获取的 URL | | -o <path> | 输出文件路径 | | --wait | 等待用户信号再捕获 | | --timeout <ms> | 页面加载超时 (默认: 30000) |

开发工作流和工具

smart-git-commit

智能 Git 提交工具，自动生成符合 Conventional Commit 格式并带有 Emoji 的提交信息。支持预提交检查、变更分析和智能拆分建议。

# 基础提交 (自动生成信息)
/smart-git-commit

# 自定义提交信息
/smart-git-commit "add user authentication"

# 跳过预提交检查
/smart-git-commit --no-verify

# 修正上次提交
/smart-git-commit --amend

工作流程:

1. 预提交检查 (默认): 运行 pnpm lint, pnpm build, pnpm generate:docs
2. 暂存分析: 检查已暂存文件，若无文件则自动暂存所有变更
3. 变更分析: 执行 git diff --cached 分析变更类型
4. 智能拆分: 检测多个独立变更并建议拆分
5. 生成信息: 格式 <emoji> <type>: <description>

选项: | 选项 | 描述 | |------|------| | [message] | 自定义提交描述 (可选) | | --no-verify | 跳过预提交检查 | | --amend | 修正上次提交 |

提交类型: | 类型 | Emoji | 描述 | |------|-------|------| | feat | ✨ | 新功能 | | fix | 🐛 | Bug 修复 | | docs | 📝 | 文档 | | style | 💄 | 格式/样式 | | refactor | ♻️ | 重构 | | perf | ⚡️ | 性能优化 | | test | ✅ | 测试 | | chore | 🔧 | 工具/配置 | | ci | 🚀 | CI/CD |

拆分建议:

• 不同关注点的变更
• 混合多种类型 (feat + fix + docs)
• 不同文件模式 (源代码 vs 文档 vs 测试)
• 超大的变更集

示例:

# 自动生成
/smart-git-commit
# 输出: ✨ feat: add user authentication system

# 自定义
/smart-git-commit "resolve memory leak"
# 输出: 🐛 fix: resolve memory leak

# 快速修复
/smart-git-commit --no-verify "typo"
# 输出: ✏️ fix: typo

最佳实践:

• 原子提交: 每次提交只做一件事
• 现在时态: "add feature" 不是 "added feature"
• 简洁描述: 首行不超过 72 字符
• 审查 diff: 确保信息匹配变更

环境配置

某些技能需要 API 密钥或自定义配置。环境变量可在 .env 文件中设置：

加载优先级 (高优先级覆盖低优先级):

1. CLI 环境变量
2. process.env (系统环境)
3. <cwd>/.content-gen-skills/.env (项目级)
4. ~/.content-gen-skills/.env (用户级)

设置:

# 创建用户级配置目录
mkdir -p ~/.content-gen-skills

# 创建 .env 文件
cat > ~/.content-gen-skills/.env << 'EOF'
# OpenAI
OPENAI_API_KEY=sk-xxx
OPENAI_IMAGE_MODEL=gpt-image-1.5
# OPENAI_BASE_URL=https://api.openai.com/v1

# Google
GOOGLE_API_KEY=xxx
GOOGLE_IMAGE_MODEL=gemini-3-pro-image-preview
# GOOGLE_BASE_URL=https://generativelanguage.googleapis.com/v1beta
EOF

项目级配置 (团队共享):

mkdir -p .content-gen-skills
# 将 .content-gen-skills/.env 添加到 .gitignore
echo ".content-gen-skills/.env" >> .gitignore

自定义

所有技能都支持通过 EXTEND.md 文件进行自定义。创建扩展文件以覆盖默认样式、添加自定义配置或定义自己的预设。

扩展路径 (按优先级检查):

1. `.content-gen-skills//EXTE