AI Skills Pool

这是一个个人 AI 编程工具技能（Skills）和配置的集合仓库。旨在模块化管理不同的 AI 辅助能力，方便按需部署到不同的开发项目中。

目前支持四个平台：Claude Code（skills.claude/）、OpenAI Codex（skills.codex/）、Gemini CLI（skills.gemini/）和 Cursor（.cursor/rules/）。

📁 目录结构

.
├── LICENSE
├── README.md
├── CLAUDE.md                    # Claude Code 开发规范元文档（本仓库自身）
├── docs/                         # 参考文档（不参与脚手架执行）
│   └── inspector/                # Inspector 设计与场景说明
│       ├── INSPECTOR-CROSS-PLATFORM.md
│       ├── INSPECTOR-SCENARIO-WALKTHROUGH.md
│       └── README.md
│
├── skills.claude/               # Claude Code 技能池（单技能独立部署）
│   ├── ai-spec/                 # [编程策略] 将需求转为技术规范
│   ├── api-first-modular/       # [架构框架] API-First 模块化开发
│   ├── code-debugger/           # [调试开发] 上下文优先的精准调试与增量开发
│   ├── debug-ui/                # [UI设计] 顶级 UI 设计师模式
│   ├── drawio-xml-roadmap/      # [设计] draw.io 路线图/流程图 XML 生成
│   ├── dr-midas/                # [科研] 科研炼金术士，图表分析与叙事
│   ├── extract/                 # [知识提取] 从内容抽提研究方法论框架
│   ├── nodejs-npm-auto-release/ # [工程] Node.js npm 自动发版与 GitHub Actions
│   ├── office-docs/             # [办公] PPTX/DOCX/XLSX 读取、编辑、创建与校验
│   ├── paper-submission-manager/# [投稿管理] 论文投稿全流程管理与材料打包
│   ├── ralph/                   # [迭代开发] 基于 PRD 的自主 Agent 循环
│   ├── ref-pubmed-linker/       # [文献] PubMed 引用链接查询与更新（参考实现）
│   ├── research-analyst-system/ # [金融分析] 多 Agent 分析师团队
│   ├── sam-dev-cc-init/         # [工作流] PDCA 项目初始化（/sam-init）
│   ├── scrna-celltype-annotation/# [生信] 单细胞亚群细胞类型注释与报告
│   ├── update-pubmed-links/     # [文献] PubMed 链接批量更新（命令变体）
│   └── ux-experience-audit/     # [体验] 用户体验问题扫描与修复闭环
│
├── skills.codex/                # OpenAI Codex 技能池（单技能独立部署）
│   ├── ai-spec/                 # [编程策略] 将需求转为技术规范
│   ├── api-first-modular/       # [架构框架] API-First 模块化开发
│   ├── code-debugger/           # [调试开发] 上下文优先的精准调试与增量开发
│   ├── debug-ui/                # [UI设计] 顶级 UI 设计师模式
│   ├── drawio-xml-roadmap/      # [设计] draw.io 路线图/流程图 XML 生成
│   ├── dr-midas/                # [科研] 科研炼金术士，图表分析与叙事
│   ├── extract/                 # [知识提取] 从内容抽提研究方法论框架
│   ├── inspector/               # [监管] PDCO 全局监管（Codex 版）
│   ├── nodejs-npm-auto-release/ # [工程] Node.js npm 自动发版
│   ├── office-docs/             # [办公] PPTX/DOCX/XLSX 读取、编辑、创建与校验
│   ├── paper-submission-manager/# [投稿管理] 论文投稿全流程管理与材料打包
│   ├── pubmed-linker/           # [文献] PubMed 引用链接查询与更新
│   ├── ralph/                   # [迭代开发] 基于 PRD 的自主 Agent 循环
│   ├── research-analyst-system/ # [金融分析] 多 Agent 分析师团队
│   ├── scrna-celltype-annotation/# [生信] 单细胞亚群细胞类型注释与报告
│   └── ux-experience-audit/     # [体验] 用户体验问题扫描与修复闭环
│
├── skills.gemini/               # Gemini CLI 技能池（单技能独立部署）
│   ├── ai-spec/                 # [编程策略] 将需求转为技术规范
│   ├── api-first-modular/       # [架构框架] API-First 模块化开发
│   ├── code-debugger/           # [调试开发] 上下文优先的精准调试与增量开发
│   ├── debug-ui/                # [UI设计] 顶级 UI 设计师模式
│   ├── drawio-xml-roadmap/      # [设计] draw.io 路线图/流程图 XML 生成
│   ├── dr-midas/                # [科研] 科研炼金术士，图表分析与叙事
│   ├── extract/                 # [知识提取] 从内容抽提研究方法论框架
│   ├── inspector/               # [监管] PDCO 全局监管（Gemini 版）
│   ├── nodejs-npm-auto-release/ # [工程] Node.js npm 自动发版
│   ├── office-docs/             # [办公] PPTX/DOCX/XLSX 读取、编辑、创建与校验
│   ├── paper-submission-manager/# [投稿管理] 论文投稿全流程管理与材料打包
│   ├── prd/                     # [需求文档] 结构化 PRD 生成
│   ├── pubmed-linker/           # [文献] PubMed 引用链接查询与更新
│   ├── ralph/                   # [迭代开发] 基于 PRD 的自主 Agent 循环
│   ├── ralph-yolo/              # [迭代开发] Ralph 全自动模式
│   ├── research-analyst-system/ # [金融分析] 多 Agent 分析师团队
│   ├── scrna-celltype-annotation/# [生信] 单细胞亚群细胞类型注释与报告
│   └── ux-experience-audit/     # [体验] 用户体验问题扫描与修复闭环
│
├── package/                     # 预打包的脚手架（多技能一体化部署）
│   ├── full-dev-脚手架/         # 全栈开发环境（仅开发技能，无 PDCA/Inspector）
│   │   ├── CLAUDE.md            # Claude Code 初始化引导
│   │   ├── AGENTS.md            # Codex 初始化引导
│   │   ├── GEMINI.md            # Gemini CLI 初始化引导
│   │   ├── .claude/             # Claude Code（8 commands + 9 skills + 3 agents）
│   │   ├── .codex/              # Codex 技能包（7 skills）
│   │   ├── .gemini/             # Gemini CLI 技能包（9 skills）
│   │   └── .cursor/             # Cursor 规则（2 rules）
│   └── full-dev-脚手架-inspector/ # 全栈开发 + PDCA/Inspector（含 /sam-init 与入职看板）
│       ├── CLAUDE.md
│       ├── AGENTS.md
│       ├── GEMINI.md
│       ├── .claude/             # 在 full-dev 基础上增加 sam-init、sam-dev-cc-init 及 PDCA 模板
│       ├── .codex/
│       ├── .gemini/
│       └── .cursor/
│
└── .cursor/                     # 本仓库自身的 Cursor 规则
    └── rules/
        ├── api-first-development.mdc
        └── project-structure.mdc

📖 参考文档

以下文档仅作阅读与理解用，不参与脚手架或脚本执行：

docs/inspector/ — Inspector Agent 跨平台架构与场景演示（从入职到专家的完整周期）。部署了 sam-dev-cc-init 或使用 Inspector CLI 时，可在此查阅设计与用法说明。

🚀 使用方法

方式一：单技能部署（按需挑选）

适合只需要特定能力的场景。

Claude Code

在 skills.claude/ 中找到需要的技能目录，例如 skills.claude/code-debugger/。
将目录下的 .claude/ 文件夹完整复制到目标项目根目录。
- 若项目已有 .claude/ 目录，合并 commands/ 和 skills/ 子目录（注意不要覆盖已有的 settings.json）。
重启 Claude Code 终端，使用对应的 slash command（如 /debug）激活。

OpenAI Codex

在 skills.codex/ 中找到需要的技能目录，例如 skills.codex/code-debugger/。
将目录下的 .codex/ 文件夹完整复制到目标项目根目录。
- 若项目已有 .codex/ 目录，合并 skills/ 子目录。
在 Codex 中使用 $skill-name（如 $code-debugger）激活。

Gemini CLI

在 skills.gemini/ 中找到需要的技能目录，例如 skills.gemini/code-debugger/。
将目录下的 SKILL.md 文件复制到目标项目的 .gemini/skills/[skill-name]/ 目录。
- 若目录不存在，创建 .gemini/skills/[skill-name]/ 后再复制。
Gemini CLI 会根据任务描述自动匹配并触发对应技能。

方式二：脚手架一键部署（推荐全栈项目使用）

适合需要完整 AI 辅助开发环境的全栈项目，一次部署即可让 Claude Code、Codex、Gemini CLI、Cursor 四个工具同时获得全套开发能力。

两种脚手架如何选：

脚手架	适用场景	区别摘要
full-dev-脚手架	只要「需求→规范→开发→调试」全流程，不需要项目级 PDCA 与看板	仅开发技能：ai-spec、api-first、debug、debug-ui、prd、ralph 等，无 `/sam-init`
full-dev-脚手架-inspector	需要 PDCA 循环、任务看板、进度日志与 Inspector 入职/专家周期管理	在 full-dev 基础上增加 `/sam-init`、sam-dev-cc-init、PROGRESS-LOG、tasks、self.opt 等，可与 docs/inspector/ 配合使用

将所选脚手架目录下的内容复制到目标项目根目录（下例以 full-dev-脚手架 为例，若选 inspector 则替换为 full-dev-脚手架-inspector）：

# 方法一：完全替换（推荐新项目）
cp -r package/full-dev-脚手架/* /path/to/your-project/
cp -r package/full-dev-脚手架/.[a-z]* /path/to/your-project/

# 方法二：增量合并（推荐有存量代码的项目）
# 复制文档
cp package/full-dev-脚手架/{CLAUDE,AGENTS,GEMINI}.md /path/to/your-project/

# 创建并复制配置目录内容
mkdir -p /path/to/your-project/.claude
cp -r package/full-dev-脚手架/.claude/* /path/to/your-project/.claude/

mkdir -p /path/to/your-project/.codex
cp -r package/full-dev-脚手架/.codex/* /path/to/your-project/.codex/

mkdir -p /path/to/your-project/.gemini
cp -r package/full-dev-脚手架/.gemini/* /path/to/your-project/.gemini/

mkdir -p /path/to/your-project/.cursor
cp -r package/full-dev-脚手架/.cursor/* /path/to/your-project/.cursor/

部署后目标项目的结构（若使用 full-dev-脚手架-inspector 还会多出 /sam-init 及 PDCA 相关能力）：

your-project/
├── CLAUDE.md        ← Claude Code 读取，显示可用 commands 和核心规范
├── AGENTS.md        ← Codex 读取，显示可用 skills 和核心约束
├── GEMINI.md        ← Gemini CLI 读取，显示可用 skills 和使用方式
├── .claude/         ← Claude Code：/ai-spec, /api-first, /debug, /debug-ui, /prd, /ralph, /ralph-yolo, /ux-experience-audit（inspector 版另有 /sam-init）
├── .codex/          ← Codex：$ai-spec, $api-first-modular, $code-debugger, $debug-ui, $ralph
├── .gemini/         ← Gemini CLI：ai-spec, api-first-modular, code-debugger, debug-ui, prd, ralph, ralph-yolo
├── .cursor/         ← Cursor：API-First 开发规则自动生效
└── (your code...)

打开项目后：
- 若使用 full-dev-脚手架-inspector：第一步执行 /sam-init 初始化 PDCA 工作流（生成/更新 CLAUDE.md、PROGRESS-LOG.md、tasks/TASKS.md、self.opt）。
- Claude Code：输入 / 查看所有可用命令
- Codex：自动根据任务触发对应技能，或使用 $skill-name 手动触发
- Gemini CLI：描述意图即可自动匹配技能
- Cursor：规则自动生效，无需手动操作

⚠️ Inspector CLI（仅 full-dev-脚手架-inspector 或单独部署 sam-dev-cc-init 时可用）。在本仓库（Claude_skill_pool）中测试：

# 方式1: 相对路径 (在项目根目录)
bash skills.claude/sam-dev-cc-init/.claude/scripts/inspector-cli.sh dashboard

# 方式2: 部署到实际项目后
# 先将 package/full-dev-脚手架-inspector/ 或 skills.claude/sam-dev-cc-init/.claude/ 复制到目标项目根目录
# 然后在目标项目中运行:
./.claude/scripts/inspector-cli.sh dashboard

🛠️ 开发指南

如果你需要让 Claude Code 帮你在这个仓库中创建新技能，请参考 CLAUDE.md 中的详细规范。

Claude Code 技能结构

skills.claude/[SkillName]/
└── .claude/
    ├── commands/[command].md    # Slash Command 定义
    ├── skills/[skill].md        # 核心 Prompt 和处理逻辑
    ├── agents/[agent].md        # (可选) 多角色 Agent
    └── settings.local.json      # (可选) 局部配置

OpenAI Codex 技能结构

skills.codex/[skill-name]/
└── .codex/
    └── skills/
        └── [skill-name]/
            ├── SKILL.md              # 核心 Skill 定义（含 YAML frontmatter）
            └── agents/
                └── openai.yaml       # 接口配置（display_name / short_description / default_prompt）

Gemini CLI 技能结构

skills.gemini/[skill-name]/
└── SKILL.md                          # 核心 Skill 定义（含 YAML frontmatter）

部署时复制到目标项目的 .gemini/skills/[skill-name]/SKILL.md。

Skill 元数据规范（SKILL.md frontmatter）

所有平台的 SKILL.md 统一使用 YAML frontmatter，便于发现与索引：

name（必填）：小写字母与连字符，与目录名一致，如 api-first-modular、code-debugger。
description（必填）：第三人称、一句话说明「做什么 + 何时使用」；可含触发场景关键词，便于 Agent 匹配。

示例：

---
name: code-debugger
description: 基于深度上下文的智能代码调试与增量开发。用于 Bug 定位与修复、增量功能开发、技术栈 Checkfix 闭环及 .debug 文档维护。
---

目录命名与技能池保持一致：skills.claude/、skills.codex/、skills.gemini/ 下均使用英文小写+连字符（如 research-analyst-system），避免中文或空格。

Cursor 规则结构

.cursor/
└── rules/
    └── [rule-name].mdc              # Cursor Rule 定义（含 frontmatter: description, globs, alwaysApply）

📦 现有技能列表

编程与开发

技能名称	Claude	Codex	Gemini	描述
PDCA 工作流初始化 (sam-dev-cc-init)	`/sam-init`	—	—	为项目一键初始化 CLAUDE.md、PROGRESS-LOG.md、tasks/TASKS.md、self.opt（项目级自优化）
编程策略工具 (ai-spec)	`/ai-spec`	`$ai-spec`	✓	全栈架构师模式，将自然语言需求转化为生产级技术规范和 AI 执行指令
API-First 模块化 (api-first-modular)	`/api-first`	`$api-first-modular`	✓	后端功能封装为独立 API 包，前端只调 API，跨层任务按 API 边界自动分解
智能调试助手 (code-debugger)	`/debug`	`$code-debugger`	✓	基于深度上下文理解的精准调试与增量开发，模块隔离防止连锁错误
UI 设计师 (debug-ui)	`/debug-ui`	`$debug-ui`	✓	顶级 UI 设计师模式，六维视觉诊断 + 像素级代码实施，与 debug 共享 `.debug/` 文档
PRD 生成器 (prd)	`/prd`	—	✓	交互式生成结构化产品需求文档
Ralph 工作流 (ralph)	`/ralph`	`$ralph`	✓	基于 PRD 的自主 Agent 循环，逐个实现 User Story 并自动提交
Ralph YOLO (ralph-yolo)	`/ralph-yolo`	—	✓	Ralph 全自动模式，无人值守
Draw.io 路线图 (drawio-xml-roadmap)	`/drawio-xml-roadmap`	`$drawio-xml-roadmap`	✓	基于 draw.io XML 生成可导入的路线图/流程图，遵循 mxfile/mxCell 规范
Inspector (PDCO 监管)	—	`$inspector`	✓	评估与管理所有 Agent 的质量、效率与成长（Codex/Gemini 版）
Node.js npm 自动发版 (nodejs-npm-auto-release)	✓	✓	✓	标准化 npm 发版：自动版本号、GitHub Actions 发布与本地预检
Office 文档 (office-docs)	`/office-docs`	`$office-docs`	✓	PPTX/DOCX/XLSX 读取、编辑、创建与校验，支持解包/打包 XML 与 PptxGenJS
UX 体验审计 (ux-experience-audit)	`/ux-experience-audit`	`$ux-experience-audit`	✓	从用户体验角度做问题扫描、优先级判定与修复闭环，解决「功能可用但体验不通」

科研与文献

技能名称	Claude	Codex	Gemini	描述
Dr. Midas (dr-midas)	`/midas`	`$dr-midas`	✓	科研炼金术士，分析科研图表并结合 PubMed 文献生成深度科研叙事
PubMed Linker	`/update-pubmed-links`	`$pubmed-linker`	✓	自动查询并更新参考文献的 PubMed 链接、PMID、DOI
论文投稿管理 (paper-submission-manager)	`/paper-submission-manager`	`$paper-submission-manager`	✓	论文投稿全流程管理：清单、QA、材料打包与提交追踪
单细胞细胞类型注释 (scrna-celltype-annotation)	`/scrna-celltype-annotation`	`$scrna-celltype-annotation`	✓	基于 Seurat 差异表达与文献 MCP 对单细胞亚群做 major/minor 注释并生成报告

研究与分析

技能名称	Claude	Codex	Gemini	描述
思路抽提 (extract)	`/extract`	`$extract`	✓	从深度研究文档中反向提取可复用的研究方法论框架和 Prompt 模板
金融分析师团队 (research-analyst-system)	`/research`	`$research-analyst-system`	✓	首席分析师 + 6 大研究小组并行深度调研，输出结构化投资报告

脚手架

名称	包含工具	描述
全栈开发脚手架 (full-dev)	Claude + Codex + Gemini + Cursor	仅开发能力：一键部署 ai-spec、api-first、debug、debug-ui、prd、ralph、ralph-yolo、ux-experience-audit、nodejs-npm-auto-release 等，8 commands + 7 Codex + 9 Gemini + 2 Cursor rules，无 PDCA/Inspector
全栈开发 + Inspector 脚手架 (full-dev-inspector)	Claude + Codex + Gemini + Cursor	在 full-dev 基础上增加 PDCA 工作流：`/sam-init`、sam-dev-cc-init、PROGRESS-LOG、tasks、self.opt；适合需要入职看板与专家周期管理的项目，详见 docs/inspector/

致谢

Inspector 相关设计与能力来源于 @samqin123 的贡献，特此感谢。

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

AI Skills Pool

📁 目录结构

📖 参考文档

🚀 使用方法

方式一：单技能部署（按需挑选）

Claude Code

OpenAI Codex

Gemini CLI

方式二：脚手架一键部署（推荐全栈项目使用）

🛠️ 开发指南

Claude Code 技能结构

OpenAI Codex 技能结构

Gemini CLI 技能结构

Skill 元数据规范（SKILL.md frontmatter）

Cursor 规则结构

📦 现有技能列表

编程与开发

科研与文献

研究与分析

脚手架

致谢

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 63 Commits
.claude		.claude
.cursor/rules		.cursor/rules
assets		assets
docs/inspector		docs/inspector
package		package
skills.claude		skills.claude
skills.codex		skills.codex
skills.gemini		skills.gemini
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

AI Skills Pool

📁 目录结构

📖 参考文档

🚀 使用方法

方式一：单技能部署（按需挑选）

Claude Code

OpenAI Codex

Gemini CLI

方式二：脚手架一键部署（推荐全栈项目使用）

🛠️ 开发指南

Claude Code 技能结构

OpenAI Codex 技能结构

Gemini CLI 技能结构

Skill 元数据规范（SKILL.md frontmatter）

Cursor 规则结构

📦 现有技能列表

编程与开发

科研与文献

研究与分析

脚手架

致谢

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages