jingchaodev/skills-lab
GitHub: jingchaodev/skills-lab
一个面向 Claude Code 的可复用 Agent 技能库，提供涵盖研究、代码审查、运维事件响应及技术写作等数十项开箱即用的模型调用能力。
Stars: 1 | Forks: 0
# skills-lab
一个可复用的 **[Agent Skills](https://code.claude.com/docs/en/skills)** 库，专为
Claude Code（及兼容的 agent 框架）设计——并包含其背后的编写原则。
每个 skill 都是一个独立的、由模型调用的能力：包含一个带有
YAML frontmatter 的 `SKILL.md` 文件，用于告知 agent *何时*调用以及*如何*使用它，
有时还会搭配一个小型零依赖脚本。这里的每个 skill 都是
**通用且可移植的** —— 没有专有工具，没有公司内部系统，
没有任何你无法在笔记本电脑上运行的内容。
## Skills
**研究与信息**
| Skill | 作用 |
|-------|--------------|
| [`deep-research`](skills/deep-research) | 分解问题，在网页/代码/文档中展开搜索，阅读最佳来源，针对缺口进行优化，并综合生成带引用的回答。 |
| [`fact-check`](skills/fact-check) | 通过多个独立来源验证声明，并返回带有置信度和引用的结构化判定结果。 |
| [`search-strategy`](skills/search-strategy) | 高效搜索任何语料库——选择正确的来源，构建精确的查询，进行迭代、过滤，以及在关键词和语义搜索之间切换。 |
| [`web-search`](skills/web-search) | 在终端中进行 DuckDuckGo 搜索——零依赖 Node 脚本，输出文本或 JSON。 |
| [`web-fetch`](skills/web-fetch) | 获取网页并提取可读文本（或原始 HTML，或所有链接）——零依赖 Node 脚本。 |
**代码、审查与交付**
| Skill | 作用 |
|-------|--------------|
| [`git-workflow`](skills/git-workflow) | 功能分支的 git 工作流、约定式提交、变基、冲突解决，以及通过 `gh` CLI 创建 PR。 |
| [`code-review`](skills/code-review) | 理解意图 → 按照八大维度准则进行审查 → 发布具有严重性标签、可操作的行内评论。 |
| [`design-review`](skills/design-review) | 按照准则审查技术设计（或为你自己的设计辩护）：涵盖问题、替代方案、故障模式、可操作性和成本。 |
| [`call-chain-tracing`](skills/call-chain-tracing) | 跨服务和代码逐跳追踪请求/值，找出它是在哪里被转换、过滤或丢弃的。 |
| [`test-coverage-analysis`](skills/test-coverage-analysis) | 解读覆盖率指标和 CI 测试运行失败；优先处理真正重要的缺口（基于风险，而非盲目追求 100% 覆盖率）。 |
| [`ci-cd-triage`](skills/ci-cd-triage) | 诊断流水线报错——对失败阶段进行分类，按优先级“首错优先”阅读日志，并分诊构建/测试/部署/基础设施故障。 |
**运维与基础设施**
| Skill | 作用 |
|-------|--------------|
| [`tmux-runner`](skills/tmux-runner) | 在后台 tmux 会话中运行构建、服务器、监听器和并行 agent 任务，而不会阻塞主 agent。 |
| [`aws-cli-safety`](skills/aws-cli-safety) | 安全有效地使用 AWS CLI——写前必读、最小权限、谨慎操作生产环境、`--dry-run`、`--query`/`jq`、分页。 |
| [`change-management`](skills/change-management) | 编写并执行生产环境变更记录：包含内容/原因/影响范围/回滚/验证、风险等级和审批流。 |
| [`operational-readiness-review`](skills/operational-readiness-review) | 执行或准备上线就绪审查：监控、runbook、on-call、容量、回滚、持久性和负载测试。 |
| [`security-review-gate`](skills/security-review-gate) | 对安全敏感的请求（密钥、PII、身份验证、IAM）保持暂停，在行动前查阅标准，绝不生成不安全的代码。 |
**Oncall 与事件响应** —— 一套协同配合的 skill；[`oncall-agent`](skills/oncall-agent) 是 orchestrator，负责将其余 skill 组合成一个 on-call 助手（参见[将 Skills 组合成 Agent](#composing-skills-into-an-agent))。
| Skill | 作用 |
|-------|--------------|
| [`oncall-agent`](skills/oncall-agent) | **Orchestrator** —— 将每种情况（轮班开始、分诊、警报、实时事件、交接）路由到下方合适的专业 skill，并通过共享的上下文文件进行协调。 |
| [`oncall-context-system`](skills/oncall-context-system) | 一个基于文件的轮班记忆系统，确保 on-call 上下文永不丢失——工单台账、截止日期日历、工作进展追踪、缺口日志、每日日志以及交接生命周期。 |
| [`ticket-triage`](skills/ticket-triage) | 对工单队列进行分类、划分优先级并清理过期状态；使用只读子 agent 并行调查 3 个以上的工单，然后在一个流程中进行核对。 |
| [`alarm-correlation`](skills/alarm-correlation) | 将相关的警报聚类，评估是系统性问题还是偶发故障的严重程度，并追踪跨服务依赖链以找出根本原因。 |
| [`incident-response`](skills/incident-response) | 处理正在发生的 sev1/sev2 事件——量化影响范围、主/次要事件关联、解决总结检查点以及服务中断通讯。 |
| [`runbook-authoring`](skills/runbook-authoring) | 编写可供 agent 使用的服务 runbook：警报定义块、基于可能性排序的调查表、质量等级以及 agent 路由元数据。 |
| [`postmortem`](skills/postmortem) | 编写并协助进行无指责的 postmortem——包含时间线、影响范围、根本原因以及具体的预防性行动项。 |
| [`evidence-discipline`](skills/evidence-discipline) | 让每一个操作声明都有可追溯的来源作为依据，标记其证据等级，且绝不将相关性呈现为因果关系。 |
**写作与沟通**
| Skill | 作用 |
|-------|--------------|
| [`technical-writing`](skills/technical-writing) | 撰写清晰的长篇文档（设计文档、提案、叙事）——结构严谨，直奔主题，用数据说话而非堆砌辞藻，并进行自我审查。 |
| [`document-review`](skills/document-review) | 审查他人的文章：是否回答了提出的问题，结构是否合理，缺少了什么——并提供带有严重性标签的评论。 |
| [`writing-style-transfer`](skills/writing-style-transfer) | 通过可复用的风格卡片，从样本中提取并复现个人或品牌的写作语气。 |
| [`diagrams-as-code`](skills/diagrams-as-code) | 通过代码生成清晰的架构图（Mermaid / Graphviz / PlantUML / SVG）——并附带工具决策表。 |
**思维、判断与元技能**
| Skill | 作用 |
|-------|--------------|
| [`socratic-questioning`](skills/socratic-questioning) | 在采取行动之前，提出有针对性的问题以达成共识——附带一套详尽询问与立即行动的决策模型。 |
| [`engineering-judgment`](skills/engineering-judgment) | 在高级/主管/首席工程师层面进行工作：把控范围、处理歧义、在无授权情况下发挥影响力，以及判断何时“足够好”即是最佳选择。 |
| [`behavioral-interview`](skills/behavioral-interview) | 主持或准备能力/行为面试——STAR 法则、能力领域、挖掘真实信号、职级校准。 |
| [`technical-interview`](skills/technical-interview) | 主持或准备编程和系统设计面试——面试轮次类型、校准准则、面试官准备文档、撰写总结反馈、候选人指导。 |
| [`terminal-recording`](skills/terminal-recording) | 通过 asciinema + tmux 录制高质量的终端演示，并支持空闲时间压缩和后期修剪。 |
| [`agent-retrospective`](skills/agent-retrospective) | Agent 分析自身的会话记录以发现摩擦和未纠正的错误，随后提出长效的改进建议。 |
## 将 Skills 组合成 Agent
Skills 不仅是独立存在的——这里有几个 skill 被设计为**组合进同一个
Agent** 中。Oncall 套件就是这样一个完整的范例：七个专业 skill
（`oncall-context-system`、`ticket-triage`、`alarm-correlation`、
`incident-response`、`runbook-authoring`、`postmortem`、`evidence-discipline`）
共享一组上下文文件，并由一个 **orchestrator**
（[`oncall-agent`](skills/oncall-agent))）进行协调。
这种模式可推广到任何多 skill 的 Agent：
1. **专业能力各司其职。** 每个 skill 都能独立发挥效用，并
可独立测试。
2. **Orchestrator skill 负责路由**，将不同情况分配给相应的专家（建立一套 *情况 →
skill* 的对应表），并记录端到端流程的阶段顺序。
3. **共享状态即契约。** Orchestrator 定义了谁拥有共享
文件的所有权——例如，*单一写入者*（只有主 agent 可以写入台账；并行的
子 agent 仅具备只读权限），*日志记录 ≠ 事实来源*，以及诸如要求每个专家
都必须遵守的证据规范等全局性规则。
4. **Orchestrator 的 `description` 字段需指明整个领域**，以便 Agent
将其作为入口点加载，并按需调用各个专业 skill。
将整套 skills 一起安装，并优先加载 orchestrator——请参阅
[`oncall-agent`](skills/oncall-agent) 以获取路由表、轮班生命周期，
以及如何将专业 skill 与你的工单 / 监控 / CI-CD / 聊天
技术栈对接。
## 安装说明
Skills 存放在你的 agent 可读取的 `skills/` 目录中。对于 Claude Code，
请将所需的 skill 软链接（或复制）到你的 skills 目录中：
```
git clone https://github.com/jingchaodev/skills-lab.git
cd skills-lab
# 为你的用户安装单个 skill
ln -s "$PWD/skills/tmux-runner" ~/.claude/skills/tmux-runner
# ...或者全部安装
for d in skills/*/; do
ln -s "$PWD/$d" ~/.claude/skills/"$(basename "$d")"
done
```
随后，Agent 会自动识别它们——它会读取每个 `SKILL.md` 的
frontmatter，并在 `description` 与任务相匹配时调用该 skill。
## 环境要求
大多数 skill 都是纯 Markdown 和 shell 脚本。少数具有额外依赖的 skill 如下：
- **`web-search` / `web-fetch`** —— 需要 Node.js 18+（内置全局 `fetch`；无需 `npm install`）。
- **`terminal-recording`** —— 需要 `asciinema`、`tmux`、`python3`，可选 `agg` 用于导出 GIF。
- **`tmux-runner`** —— 需要 `tmux`。
- **`git-workflow` / `code-review`** —— 需要 `git` 和 [`gh`](https://cli.github.com/) CLI。
- **`aws-cli-safety`** —— 需要 AWS CLI。
- **`diagrams-as-code`** —— 需要 Mermaid、Graphviz 或 PlantUML 中的任意一种（由你选择）。
## Skill 结构剖析
```
skills/web-search/
├── SKILL.md # frontmatter (name, description) + usage docs the agent reads
└── search.js # optional: a self-contained script the skill drives
```
`description` 字段是整个文件中最重要的一行——这是 Agent 在决定
某个 skill 是否相关时唯一能看到的内容，因此它必须明确列出具体的触发条件。有关完整的原理说明，请参见 [`docs/authoring-skills.md`](docs/authoring-skills.md)。
## License
[MIT](LICENSE)。可自由使用、fork 并修改它们。
标签：AI智能体, Claude Code, Cutter, MITM代理, SOC Prime, 代码审查, 开发工具, 自定义脚本, 防御加固