Skill-hub - Codex / Claude Code 中文 Agent 技能库

English | 中文

为 Codex、Claude Code、Antigravity 等 AI 编程工具查找、复用与维护结构化 Agent 技能。

从这里开始： 按名字浏览全部技能 · 按能力域探索 · 查看机器可读索引 · 了解来源与维护边界

Skill-hub 是一个面向 Codex、Claude Code、Antigravity 等 AI 编程工具的中文 Agent 技能库，收集可复用的 SKILL.md 自动化实践、AI 编程工作流和提示词模板。仓库当前包含 70 个可复用技能，其中 62 个共享技能按能力域组织，8 个项目私有技能按项目归档，便于检索、本地同步、来源追踪和持续维护。

适合搜索： Codex 技能与 Claude Code 技能、中文 Agent 技能库、AI 编程工作流与提示词模板。

信任边界： 这是公开开源的个人 Skill 仓库，不是 OpenAI、Anthropic、Claude Code 或 Antigravity 官方技能库，也不是通用提示词市场。仓库公开，请只使用占位符填写凭据，不要提交真实密钥、客户数据、内部资料或个人隐私。

快速入口： 按名字查 | 按能力域查 | 机器可读索引 | 来源索引

仓库定位

Skill-hub 不是单一提示词合集，而是面向 Agent 使用的技能仓库。每个技能通常包含触发条件、执行步骤、约束、参考资料或脚本，让 AI 编程助手能在相似任务中复用稳定流程。

典型场景： 查找可复用的 Agent 技能，整理自己的 Codex / Claude Code 工作流，把项目经验沉淀成 SKILL.md，为 AI 编程任务建立可复用的提示词和自动化步骤。

技能种类

共享技能位于 skills/，项目私有技能位于 projects/。当前分类来自 _meta/skills-lock.json 和 _meta/by-domain.md。

目录结构

skills/                        # 62 个共享技能，分 7 个能力域
|-- 01-agent-engineering/      # Agent 构建、调试、自治循环、harness
|-- 02-coding-languages/       # 编程语言
|-- 03-frameworks/             # 框架与技术栈
|-- 06-data-search/            # 数据抓取、检索、深度研究
|-- 07-media-content/          # PPT、视频、PDF、文档、图像
|-- 08-writing-marketing/      # 写作、风格仿写、营销
`-- 10-business-industry/      # 医疗、法律、金融、市场研究等行业技能

projects/                      # 8 个项目私有技能
_meta/                         # 中文索引、机器可读映射、来源索引
docs/                          # 目录约定与隐私脱敏说明
scripts/                       # Junction 建立、同步、索引重建脚本
assets/README/icons/           # README 使用的 Lucide SVG 图标

索引入口

第一次阅读时，建议先从索引入口开始，而不是直接浏览所有目录。

来源索引

_meta/skill-upstreams.json 是 Skill-hub 的来源索引。它记录已验证的开源上游、候选来源、本地或项目私有来源、上游路径、最近检查信息、升级策略和状态。具体数量和分类摘要以该文件中的 verificationSummary、sources 和相关字段为准。

来源索引用来回答三个维护问题：

• 这个技能是自制、项目私有、开源镜像，还是经过本地映射改造。
• 如果上游更新，哪些技能允许自动或半自动比对升级。
• 哪些技能证据不足，不能仅凭名称覆盖本地版本。

未在来源索引中明确标注的技能，不应被当作可自动覆盖的上游镜像。

技能格式

每个技能是一个目录，核心文件是 SKILL.md。推荐 frontmatter 保持简洁，便于不同 Agent 读取。

---
name: skill-name
description: 一句话触发条件：什么场景下 Agent 应该使用这个技能。
---

# 正文：指令、参考、示例

description 应该描述触发条件，而不是营销话术。详细命名规则见 docs/directory-conventions.md。

安装与本地接入

普通使用者可以把仓库作为技能源克隆到本地，再把自己的 Agent 技能目录指向同一份源。

git clone <this-repository-url> skill-hub
cd skill-hub

Windows 上常用 Directory Junction 让多个 Agent 共享同一份技能目录，避免维护多份副本。

# 预览
.\scripts\setup-junctions.ps1 -Source "D:\path\to\your\skills" -DryRun

# 执行
.\scripts\setup-junctions.ps1 -Source "D:\path\to\your\skills"

不同工具的实际技能目录不同，脚本只负责建立本地目录连接；不会替你配置远程账号、密钥或私有服务。

同步流程

本地使用时可以保持扁平技能目录，仓库内则按能力域分组。同步脚本负责在两种结构之间转换。

同步前建议先查看 git status 和 git diff，确认没有把真实凭据、临时输出或项目私有草稿带入公开仓库。

升级与维护流程

维护 Skill-hub 时，优先按证据升级，而不是按技能名猜测。

1. 查看 _meta/skill-upstreams.json，确认技能是否有已验证上游。
2. 只对 classification=open-source 且 updatePolicy=mirror 或 updatePolicy=mapped 的条目执行上游比对。
3. 对 candidate、unknown、自制技能和项目私有技能，先补证据或人工审查，不直接覆盖。
4. 升级后运行 scripts/build-indexes.ps1，让 _meta/ 索引反映最新技能数量、路径和描述。
5. 用 git diff 审查技能内容、索引变化和脱敏情况，再提交。

仓库内的 skills/01-agent-engineering/skill-lifecycle-manager/ 提供跨 Codex 与 Claude Code 的 skill 搜索、安装、升级、同步、来源校验和质量审计流程，可维护 Skill-hub 来源索引，识别个人/项目级安装，并安全处理 Claude Code 插件缓存。

维护约定

• 新增共享技能时，先放入合适的 skills/<domain>/ 子目录，并保持目录名为 kebab-case。
• 新增项目私有技能时，放入 projects/<project-name>/，避免混入通用技能目录。
• 修改技能描述后，运行索引重建脚本，确保 by-name、by-domain 和机器索引一致。
• 修改上游来源判断时，必须有证据；不要把未证实的相似仓库写成确定来源。
• 不修改别人的工作区改动；提交前只整理自己本次触碰的 README、图标或明确授权文件。

隐私边界

仓库是公开的。所有技能在纳入仓库前都应做脱敏扫描，规则见 docs/privacy-audit.md。

使用本仓库技能时，请在本地填入自己的凭据；不要把填入真实凭据的文件提交回公开仓库。

许可

本仓库采用 MIT License 完全开源。第三方开源 skill 如保留原始许可证或来源说明，以其上游许可证为准。