cli-faq-shortcuts

cli-faq-shortcuts 是一款 Agent Skill，能够读取你在 Claude Code 和 Codex 中的使用历史，自动发现你反复输入的相同请求，将其转化为简短的快捷命令（如 /sent 或 /project billing），让你不再重复打字。该技能适用于 Claude Code、Codex 和 Cursor。

技能简介

cli-faq-shortcuts 的核心价值在于解决「每天向 AI 编程工具重复输入相同指令」的痛点。它分析你的使用历史，找出最常重复的请求，按意图聚类后，为每个高频请求创建一个轻量级 Skill 文件。以后只需输入简短命令，AI 就能调用项目已有的脚本和查询工具执行对应操作——既省打字，又避免遗漏关键步骤。

核心能力

• 历史扫描：读取 Claude Code（~/.claude/projects/*/）和 Codex（~/.codex/sessions/）的对话历史，自动提取你输入的所有 prompt
• 意图聚类：将不同表述但同一意图的请求归为一组，识别真正的使用频率
• 快捷命令生成：将高频请求转化为 .claude/skills//SKILL.md 格式的快捷 Skill
• 脚本整合：快捷命令直接调用项目已有的脚本和查询工具，保留项目的业务逻辑
• 跨平台支持：支持 Claude Code、Codex 和 Cursor（Cursor 历史读取功能开发中）
• 隐私优先：所有处理在本地完成，不上传任何数据

安装配置

基本安装

git clone https://github.com/kishormorol/cli-faq-shortcuts ~/.agents/skills/faq-shortcuts
mkdir -p ~/.claude/skills && ln -sfn ~/.agents/skills/faq-shortcuts ~/.claude/skills/faq-shortcuts

Windows 安装

git clone https://github.com/kishormorol/cli-faq-shortcuts "$env:USERPROFILE.agentsskillsfaq-shortcuts"
New-Item -ItemType Directory -Force "$env:USERPROFILE.claudeskills" | Out-Null
New-Item -ItemType Junction -Path "$env:USERPROFILE.claudeskillsfaq-shortcuts" -Target "$env:USERPROFILE.agentsskillsfaq-shortcuts"

使用步骤

1. 安装：将仓库克隆到本地，创建软链接
2. 打开项目：在 Claude Code 中打开目标项目目录，开启新会话
3. 运行分析：输入「我在这个项目中最常问什么？」或直接输入 /faq-shortcuts
4. 查看结果：AI 返回一个表格，列出高频请求及其出现次数
5. 选择快捷命令：从列表中选择要转换的请求
6. 自动生成：AI 为每个选中的请求创建对应的 SKILL.md 文件
7. 使用快捷命令：以后在项目中直接输入 /sent、/project billing 等简短命令

适用场景

• 高频查询自动化：将「本周注册了多少人（不含测试账号）」这类重复查询转为 /signups
• 项目状态检查：将「项目 X 的进度如何」转为 /project X
• 批量操作封装：将「导入这个 CSV」类操作封装为快捷命令，自动处理dry run
• 团队知识共享：快捷命令提交到 Git，团队成员均可使用

适用人群

• 每天高频使用 Claude Code / Codex 的开发者
• 有固定工作流但讨厌重复输入相同指令的程序员
• 团队 leader，希望将最佳实践封装为可复用快捷命令

工作原理

cli-faq-shortcuts 的工作分为六步：

1. 收集：extract_asks.py 脚本从 Claude Code 和 Codex 历史文件中提取用户输入的所有 prompt
2. 聚类：AI 将不同表述但同一意图的请求归为一组
3. 检查：查找项目中已有的快捷方式和工具脚本
4. 提议：向用户展示高频请求列表，用户选择要转换的项
5. 写入：每个选中的请求生成 .claude/skills//SKILL.md 文件
6. 注册：在 CLAUDE.md / AGENTS.md 中建立快捷命令与原始请求的映射

官方链接

• GitHub：https://github.com/kishormorol/cli-faq-shortcuts