lich-skills：7 个 Claude Code / Gemini CLI / Codex Skill 集合

lich-skills 是开发者 LichAmnesia（Shen Huang）维护的一套个人 Claude Code / Gemini CLI / OpenAI Codex skill 集合，采用 MIT 协议开源。它以电报式风格组织，不含废话，聚焦工程判断类技能和高杠杆实用工具。

核心设计哲学

整个 skill 集合围绕三个核心工作流构建，每个工作流对应一个主要 skill：

1. 规范驱动开发循环（spec-driven-dev）

DEFINE ──▶ PLAN ──▶ BUILD ──▶ TEST ──▶ REVIEW ──▶ SHIP
  ▲                                                    │
  └──────────── feedback / regression ──────────────────┘

单 skill 覆盖六阶段，每阶段有明确的退出标准：

• Spec / PRD：定义需求
• Plan / Tasks：制定计划
• Build / Impl：实现代码
• Test / Verify：验证测试
• Review / Gate：代码审查
• Ship / Tag：发布打标

内置反合理化表格、验证门控和原子提交。

2. 科学方法调试循环（debug-hypothesis）

防止 AI 调试中最常见的失败模式 ， bulldozing（盲目推倒重来）。要求：

• 复现 bug，收集症状
• 列出 3-5 个可能原因 + 每个原因的证据
• 单次实验最多 5 行代码，必须能证伪而非确认
• 根因确认后才修复 + 回归测试
• 所有内容写入 DEBUG.md 作为证据链

3. N 源聚合循环（wiki-aggregate）

┌────────────────────────────────────────┐
│  src_1   src_2   src_3  ...   src_N   │
│  [..]    [..]    [..]         [..]    │
│                                        │
│  not concatenated. not summarized.     │
│             navigated.                 │
└───────────────┬────────────────────────┘
                ▼
┌────────────────────────────────────────┐
│       AGGREGATOR  (lite agent)         │
│   inspect_file / inspect_section       │
│   search_sources / cross_pack_check  │
│                                        │
│   notes = []  (every claim → path:line)│
│   budget = 25 → loop until coverage  │
└───────────────────┬────────────────────┘
                    ▼
          pack/  brief.md / findings.md /
                 sources.tsv / _aggregation_log.md

Agentic 聚合用于长期研究。N 份原始笔记 → 1 份结构化 pack，每条声明都有 path:line 出处，跨源矛盾自动标出。

7 个 Skill 一览

subagent-brief：Token 优化 Skill

subagent-brief 是近期新增的 skill，解决 Claude Code 中 subagent 的 token 浪费问题。

核心洞察

Anthropic 的 subagent 之间不共享 prefix。每个 subagent 都是冷启动，会把完整上下文重发一遍。开 N 个 subagent 等于 N 份 token 开销。

5 条规则

1. 压缩 brief：spawn 前将上下文压成 ≤200 字的 brief，不要把整段 PRD / 整个 repo 塞过去
2. 主 agent 吃长文档、subagent 只拿摘要：50K context 只塞主 agent 一次
3. 串行优先：除非任务真互相无依赖，1 个 agent 顺序跑 token 直接省一半
4. 利用 prompt cache：在 cache TTL（约 1 小时）内连续 spawn 比间隔 10 分钟便宜一个数量级
5. 监控 input/output 比例：>10:1 说明 prefix 在浪费，合并回主 agent

模板结构

# Brief for {agent_role}

## Goal
{1-sentence outcome}

## Context
{≤100 words: what changed, what matters}

## Constraints
- {hard limit 1}
- {hard limit 2}

## Success Criteria
{measurable check}

## References
- path/to/file.ts:{line}
- path/to/other.md

快速安装

Claude Code（一行命令）

/plugin marketplace add LichAmnesia/lich-skills
/plugin install lich-skills@lich-skills

原理：.claude-plugin/marketplace.json 将仓库声明为插件市场，Claude Code 从同一 manifest 解析插件名和来源。

Gemini CLI（一行命令）

gemini extensions install https://github.com/LichAmnesia/lich-skills

原理：gemini-extension.json manifest 让 Gemini CLI 识别仓库为扩展并自动发现 skills/*/SKILL.md。

OpenAI Codex CLI

git clone https://github.com/LichAmnesia/lich-skills.git ~/.claude/skills/lich-skills

Claude Code 在会话启动时自动读取 ~/.claude/skills/**/SKILL.md。

安全设计

• 无密钥提交：仓库通过 gitleaks 在 pre-commit hook 和 CI 中扫描
• 环境变量读取：所有 skill 通过环境变量读取凭证（TAVILY_API_KEY、GEMINI_API_KEY 等），示例配置使用 YOUR_API_KEY_HERE 占位符

项目信息

• GitHub：https://github.com/LichAmnesia/lich-skills
• Stars：200+
• Forks：19
• License：MIT © 2026 Shen Huang