Agent Dev Skills

Agent 开发 Skills（agent-dev-skills）

一套覆盖 AI Agent 开发全流程的可复用 Skills 集合，基于AGENT开发核心方法论 + 实际工程经验整理。

**同时兼容 Claude Code 与 OpenAI Codex**，也适用于任何支持 `SKILL.md`（YAML frontmatter + `name` + `description`）的 Agent 框架。

---

特性

• 46 个独立 Skill，覆盖全书 10 章：从上下文工程、工具设计、Harness 工程，到评估、后训练、持续进化、多 Agent 协作。
• 渐进式披露：每个 Skill 的 description 写成"何时该用我"（路由条件）而非"我能做什么"，让 Agent 按需路由加载，避免上下文膨胀。
• 统一格式：每个 Skill 遵循「角色与读者 + 核心原则（配正例/反例）+ 执行流程（SOP）+ 禁止清单（写清合法例外）+ 参考资料」。
• 可落地：融入书中的具体数字与案例（KV Cache 延迟 0.5s→3-5s、Pass@5≈99% vs Pass^5≈7.8%、检索失败率 ↓49%/↓67% 等）。
• 双框架兼容：扁平目录结构 + 标准 frontmatter，Claude Code 和 Codex 都能直接识别。

---

快速开始

安装

git clone <仓库地址> agent-dev-skills
cd agent-dev-skills
./install.sh

`install.sh` 默认用**软链接**同时安装到两个框架（更新仓库后自动同步）：

框架	目标目录
Claude Code	~/.claude/skills/
OpenAI Codex	~/.codex/skills/

**常用选项**：

./install.sh --claude-only   # 只装 Claude Code
./install.sh --codex-only    # 只装 Codex
./install.sh --copy          # 用复制代替软链接

**卸载**：

./uninstall.sh               # 同时卸载两个框架（只删软链接，不动仓库）

也可用环境变量覆盖目录：`CLAUDE_SKILLS=... ./install.sh`、`CODEX_SKILLS=... ./install.sh`。

使用

安装后重启 Claude Code / Codex，Agent 会自动根据任务加载对应的 Skill（由 `description` 路由触发）。你也可以手动调用：

• Claude Code：/context-engineering、/tool-interface 等（Skill 名即 slash command 名）。
• Codex：Skill 名作为可发现的技能，按需触发。

---

完整索引（46 个 Skill）

第 2 章 · 上下文工程

Skill	说明
context-engineering	上下文工程总览（静态前缀+轨迹、KV Cache、状态栏、压缩）
context-kv-cache-friendly	KV Cache 友好设计（三条结论、五种错误模式、缓存边界）
context-status-bar	Agent 状态栏（任务进度/工具计数/环境状态的显式注入）
context-compression	上下文压缩（三动机、上下文感知压缩、分层压缩）
prompt-engineering	提示词工程（流程驱动、业务规则细化、结构化提示）
skill-authoring	Skill 编写方法（渐进式披露三层、四部分、写作型迭代）

第 3 章 · 用户记忆和知识库

Skill	说明
memory-rag	记忆与 RAG 总览（双层记忆架构、混合检索、知识更新）
memory-user	用户记忆系统（三层次评估、四种存储格式、压缩、隐私）
memory-rag-retrieval	RAG 检