ai-agent-skills
A curated collection of production-ready AI agent skills
for Claude Code, Codex, Cursor, and any tool that supports the
Agent Skills Open Standard.
## 这是什么？
**ai-agent-skills** 是一个可复用技能库，用于教授 AI 编程代理 _如何_ 专业地执行专门任务——每次都保持一致。每个技能都是一个独立的文件夹，其中包含结构化指令、参考材料和示例，代理可以按需加载。
把它看作一本战术手册：你只需定义一次流程，每当相关任务出现时，代理就会遵循该流程执行。
## 技能
| 技能 | 类型 | 描述 |
|---|---|---|
| **[vault-scribe](skills/vault-scribe/)** | `/vault-scribe` | 将录音稿、会议记录、头脑风暴会议、战略文档和草稿笔记转换为经过润色的 Obsidian vault Markdown —— 默认兼容 GitHub，并带有类型感知的 frontmatter 模式 |
| **[agentic-skeleton-dir-structure](skills/agentic-skeleton-dir-structure/)** | `/agentic-skeleton-dir-structure` | 使用 Agent-OS v3 (Builder Methods) 为 Agentic AI 项目搭建生产就绪的目录结构 —— 支持单仓库、单体仓库、多语言仓库，适用于任何平台和语言 |
| **[git-commit-pr-message](skills/git-commit-pr-message/)** | `/git-commit-pr-message` | 生成 Conventional Commits 消息、PR 标题/描述，以及 Keep a Changelog v1.1.0 条目 —— 具备敏感内容扫描、GitHub/Jira 工单链接和发布工作流功能 |
| **[design-critique](skills/design-critique/)** | `/design-critique` | 结构化的设计批判和计划压力测试 —— 充当一名无情的面试官，使用事前验尸、红队和 ATAM 技术对技术架构、产品计划和功能设计进行详尽挑战 |
| **[arch-lens](skills/arch-lens/)** | `/arch-lens` | 基于 Ousterhout 深度模块原则的七步交互式架构评审 —— 探索代码库以查找浅模块、隐藏耦合和可测试性接缝，生成并行的子代理以设计竞争性接口，然后编写可供 GitHub MCP 或 ROVO (Jira) MCP 读取的结构化 RFC 行动文件 |
| **[review-api-design](skills/review-api-design/)** | `/review-api-design` | 在规划阶段根据安全性、弹性、设计和运营最佳实践审查 REST API 设计 —— 生成具有严重性级别、来源引用和准备情况评估的结构化发现 |
| **[create-a-skill](skills/create-a-skill/)** | `/create-a-skill` | 从头开始创建新的代理技能，修改和改进现有技能，并衡量技能性能 —— 采访用户，起草包含捆绑资源的 SKILL.md，运行评估、基准测试，根据反馈进行迭代，优化描述触发机制，并打包可分发的 `.skill` 文件 |
| **[handoff](skills/handoff/)** | `/handoff` | 保存或加载会话状态的结构化 JSON 快照，以便在新会话中干净地恢复工作或委派给子代理 —— 比 `/compact` 更好，因为其 schema 强制要求每个字段都必须明确 |
| **[agent-os-assist](skills/agent-os-assist/)** | `/agent-os-assist` | 用于安装、斜杠命令、配置文件和工单到规范工作流的 Agent OS v3 参考 —— 包含 Claude 训练数据中没有的特定版本文档，并将 3.0 之前的安装引导至迁移参考 |
| **[agent-os-profile-critique](skills/agent-os-profile-critique/)** | `/agent-os-profile-critique` | 审计和批判 Agent OS v3 配置文件和标准 —— 生成带有严重性标签（阻塞、警告、建议）的发现，并提供具体的修复建议 |
### vault-scribe
你的 Obsidian vault 助手。将非结构化输入转换为组织良好、可搜索的笔记，包含适当的 YAML frontmatter、标注块和一致的格式。
**支持五种笔记类型：**
| 笔记类型 | 用例 |
|---|---|
| `article` | 知识库文章、指南、参考文档 |
| `meeting` | 会议记录、1:1 沟通、站会、回顾 |
| `brainstorming` | 构思会议 —— 与 AI 单独进行、一对一或团队进行 |
| `strategy` | 版本化计划、OKR 和动态战略文档 |
| `deep-research` | 包含多个来源的深度调研 |
**主要特性：**
- GitHub-Flavored Markdown 优先，在需要时使用 Obsidian 扩展
- 具有强制模式的类型感知 YAML frontmatter
- 自动格式化录音稿附录
- 用于跨平台标注块的 GFM Alerts
- 输出前的质量检查表验证
- 用于 frontmatter 模式、标注类型、嵌入语法和 Markdown 兼容性的参考文件
```
vault-scribe/
├── SKILL.md Workflow + quality checklist
├── references/
│ ├── FRONT-MATTER.md Frontmatter schemas for all note types
│ ├── CALLOUTS.md GFM Alerts + Obsidian callout reference
│ ├── EMBEDS.md Image + embed syntax (GFM + Obsidian)
│ └── MARKDOWN-SYNTAX.md Links, tags, math, diagrams, footnotes
└── examples/
├── article-example.md Article with callouts + code blocks
├── meeting-brainstorm-example.md Brainstorming session
└── transcript-example.md Article with transcript appendix
```
### agentic-skeleton-dir-structure
你的项目脚手架助手。以交互方式为 Agentic AI 项目构建生产就绪的目录结构，内置 Builder Methods 的 [Agent-OS v3](https://github.com/buildermethods/agent-os) 和 [Spec-Driven Development (SDD)](https://buildermethods.com/library/spec-driven-development-claude-code)。
**工作原理：**
1. **检测上下文** —— 检查当前目录是否已有文件，并在覆盖任何内容之前对你发出警告
2. **提出 6 个问题**（逐一提出） —— 仓库模式、平台类型、语言、IaC 工具、目标平台、代理工具
3. **显示汇总表**，并在创建任何内容之前等待你的确认
4. **搭建所有内容** —— 目录、`CLAUDE.md`、`.claude/` 配置、`agent-os/` 结构、IaC 布局、种子文件
5. **指导下一步操作** —— Agent-OS 安装、`/plan-product` 以及 SDD 工作流循环
**支持任意组合：**
| 维度 | 选项 |
|---|---|
| 仓库模式 | Single Repo, Mono-Repo, Multi-Language Mono-Repo |
| 平台 | Frontend, Backend, Full-Stack, Middleware, Agents/AI |
| 语言 | TypeScript, Python, Go, Java, Rust, Ruby, C# 等 |
| IaC | Terraform, Pulumi, CDK, Bicep, CloudFormation, Helm, Ansible |
**生成的内容：**
- `CLAUDE.md` —— 每次 Claude Code 会话加载的项目指令
- `.claude/` —— agents、skills、commands、hooks 目录
- `agent-os/` —— 标准、规范、产品上下文（使命、路线图、技术栈）
- `src/` 或 `apps/` + `packages/` —— 特定于语言的源码布局
- `iac/` —— 与你选择的工具匹配的 IaC 结构
- `deploy/` —— CI/CD 流水线、Docker、部署脚本
- `docs/` —— 架构决策记录、API 文档、运维手册
```
agentic-skeleton-dir-structure/
├── SKILL.md Interactive workflow + quality checklist
├── references/
│ ├── repo-patterns.md Language + platform source layouts (7 languages)
│ ├── iac-patterns.md IaC by tool (7 tools) + CI/CD + env promotion
│ └── agent-os-guide.md Agent-OS install, SDD methodology, commands
└── examples/
├── single-repo-typescript.md Completed single repo TypeScript API scaffold
└── mono-repo-fullstack.md Completed mono-repo full-stack scaffold
```
### git-commit-pr-message
你的 Commit 和 PR 工作流助手。生成专业的 git commit 消息、pull request 标题和描述、更新日志条目，并处理发布 —— 全部遵循行业标准约定。
**功能：**
1. **扫描敏感内容**（API 密钥、Token、密码、私钥） —— 任何提交前的强制关卡
2. **询问工单引用** —— 支持 GitHub Issues（所有 9 个关闭关键词）和 Jira（模式匹配的工单 Key）
3. **生成 commit 消息** —— Conventional Commits 格式，包含 type、scope、subject、body 和 footer
4. **更新 CHANGELOG.md** —— Keep a Changelog v1.1.0 格式，包含所有六个部分类型（Added、Changed、Deprecated、Removed、Fixed、Security）
5. **创建 pull request** —— 通过 `gh` CLI 或 GitHub MCP，包含摘要、工单链接、更改和测试计划
6. **执行发布** —— 将 Unreleased 重命名为带版本号的部分，添加比较链接，可选择创建 git 标签
**主要特性：**
- Conventional Commits，强制包含 type、scope 和祈使语气
- 所有 9 个 GitHub 关闭关键词（`close/closes/closed`、`fix/fixes/fixed`、`resolve/resolves/resolved`）
- 通过模式检测 Jira 工单 Key（`PROJ-1234`） —— 无需前缀
- Keep a Changelog v1.1.0，文件底部带有比较链接
- 敏感内容扫描，提供行级报告
- 用户确认关卡 —— 未经询问绝不执行 commit、push 或创建 PR
- 符合 Skills v2.0 规范，包含 `disable-model-invocation`、`allowed-tools`、`argument-hint`
```
git-commit-pr-message/
├── SKILL.md Workflow (9 steps) + behavioural rules
└── references/
└── examples.md Commit, PR, changelog, ticket, and scan examples
```
### design-critique
你的设计评审陪练。使用源自事前验尸分析、红队和 ATAM（架构权衡分析方法）的结构化访谈技术，对技术架构、产品计划和功能设计进行压力测试。
**功能：**
1. **静默定向** —— 在提出任何问题之前探索代码库或相关文件
2. **锚定会话** —— 通过一个开场问题确定范围
3. **无情追问** —— 每次只问一个问题，优先追踪风险最高的线索
4. **揭示隐藏假设** —— 指出未说明的内容，并强制进行权衡表达
5. **以总结收尾** —— 哪些站得住脚，哪些站不住脚，以及在继续进行之前需要解决什么问题
**它使用的问题模式：**
| 模式 | 目的 |
|---|---|
| 当 X 失败时会发生什么？ | 故障模式 |
| 替代方案是什么样的？ | 权衡表达 |
| 你怎么知道这是错的？ | 可证伪性 |
| 撤销这个的成本是多少？ | 可逆性 |
| 带我了解最坏的情况 | 事前验尸 |
| 这牺牲了什么质量属性？ | ATAM 权衡探究 |
**Skills 2.0：** `allowed-tools: Read Grep Glob` —— `argument-hint: [topic, file, or artifact to critique]` —— 在触发短语时自动调用；无需外部工具
```
design-critique/
└── SKILL.md Interviewing principles, question patterns, session flow
```
### arch-lens
你的架构评审助手。通过 Ousterhout 的深度模块原则的视角分析代码库 —— 深度模块拥有一个小型接口，隐藏了一个大型实现，使其可在边界进行测试，并且 AI 无需阅读内部代码即可导航。
检测是有机的，而非机械的：Explore 子代理像开发者一样导航代码库。它遇到的困惑、它必须在不同文件间跳转的情况、它找不到的测试边界 —— 这种摩擦本身就是信号。无需检查清单。
**功能：**
1. **有机探索** —— 生成一个 Explore 子代理，自然地导航代码库，记录摩擦：概念分散、浅接口、不可达的测试接缝、隐藏的编排以及模块边界上的集成风险
2. **呈现候选集群** —— 将摩擦观察结果分组为命名集群，每个集群包含：涉及的模块、耦合原因、共同所有者、调用模式、共享类型、依赖类别以及将被边界测试替换的现有测试
3. **询问探索内容** —— 单个开放式问题；用户选择一个集群并指定角度
4. **界定问题空间** —— 违反的原则、当前接口、已确认的依赖类别、爆炸半径，以及当前为了执行行为测试必须深入触及的代码
5. **生成并行子代理** —— 3–4 个并行代理，每个都获得独立的技术简报和独特的设计约束（最小化、最大化灵活性、为常见调用者优化、端口与适配器）
6. **呈现设计并给出建议** —— 每个设计的接口签名、使用示例、隐藏复杂性、依赖策略和权衡；以表格和文字形式进行比较；随后给出强烈的带有主观倾向的建议或命名的混合方案
7. **编写 RFC 行动文件** —— 位于项目根目录的 `arch-rfcs-YYYY-MM-DD.md`；每个发现对应一个 RFC，包含 Problem、Proposed Interface、Dependency Strategy、Testing Strategy 和 Implementation Recommendations —— 结构化为可供 GitHub MCP 或 ROVO (Jira) MCP 直接使用
**依赖类别** —— 每个候选集群被分类为四个类别之一，这些类别决定了测试策略：
| 类别 | 含义 | 测试方法 |
|---|---|---|
| In-process | 纯计算，无 I/O | 直接测试 —— 无需适配器 |
| Local-substitutable | 具有高保真替代品的基础设施 | 使用 PGLite、内存文件系统等进行测试 |
| Remote but owned | 跨越网络边界的自有服务 | 端口与适配器 —— 用于测试的内存适配器 |
| True external | 你无法控制的第三方服务 | 在边界处进行 Mock |
**测试策略** —— 替换，而不是分层。一旦存在边界测试，针对浅模块的旧单元测试就会变成废弃物 —— 删除它们。新测试通过公共接口断言可观察的结果，而不是内部状态。
**子代理设计约束：**
| 代理 | 约束 |
|---|---|
| Agent 1 | 最小化 —— 最多 1–3 个入口点，每个参数都必不可少 |
| Agent2 | 最大化灵活性 —— 支持扩展而无需调用者更改 |
| Agent 3 | 为常见调用者优化 —— 使默认情况变得微不足道 |
| Agent 4 | 端口与适配器 —— 纯领域接口，所有基础设施均被注入 |
**Skills 2.0：** `allowed-tools: Read Grep Glob Write Bash(git *)` —— `argument-hint: [path/to/scope]` —— 在触发短语时自动调用；需要 git 用于变动分析
```
arch-lens/
├── SKILL.md Workflow summary table + behavioural rules (66 lines)
└── references/
├── WORKFLOW.md Full step-by-step detail and Explore agent prompt
├── DETECTION-PATTERNS.md Friction vocabulary, dependency categories, testing strategy
├── INTERFACE-DESIGN.md Sub-agent brief template, design constraints, comparison format
└── RFC-FILE-FORMAT.md Action file format, effort/priority/label mapping, full example
```
### review-api-design
你的 API 设计评审助手。在规划阶段 —— 在编写任何代码之前 —— 审查 REST API 设计。生成包含严重性评级发现、来源引用和准备情况评估的结构化审查文档。
**功能：**
1. **收集上下文** —— 询问有关领域、消费者、规模、身份验证要求、部署和团队经验的问题（跳过输入中已回答的问题）
2. **加载相关参考** —— 根据设计需求从 10 个特定领域的检查清单中选择性读取
3. **进行系统评审** —— 根据安全性、弹性、设计原则、有效载荷、可扩展性、通信模式、网关和运营最佳实践进行评估
4. **生成结构化审查** —— 汇总表、详细发现（包含来源引用的 What/Why/Recommendation）、"What's Missing" 缺口分析，以及准备情况评估
**审查领域（10 个参考文件）：**
| 领域 | 涵盖内容 |
|--------|---------------|
| Design Principles | 命名、版本控制、CRUD、幂等性、健康检查、追踪、参数、ID 暴露 |
| Payloads & Errors | 响应结构、分页、RFC 9457 错误、标识符、内容协商 |
| Security (Auth) | 零信任、OAuth 2.0/2.1、RBAC/ABAC、MFA/passkeys、JWT、速率限制、会话、基于风险的防护 |
| Security (Defense) | 枚举、信息泄露、输入验证、CORS、CSRF、安全标头、OWASP API Top 10 |
| Extensibility | 固定与可变参数、元数据逃生舱口、SOLID 原则、响应演进、Hyrum's Law |
| Resilience | 重试、熔断器、超时、隔板、缓存、可观测性、SLI/SLO |
| Communication Patterns | REST vs GraphQL vs WebSockets vs SSE —— 何时使用各自方案、混合架构 |
| API Gateways | 网关模式、产品比较、何时使用/跳过 |
| Human Aspect | 采用、文档、NFR、测试策略 |
| Pragmatism | 依赖、框架锁定、自建与购买 |
**调用说明：** 此技能在通过 `/review-api-design` 显式调用时效果最佳。它也可能在进行 API 设计决策的计划模式期间激活，但显式调用更为可靠。
```
review-api-design/
├── SKILL.md Workflow + output format + example
├── evals/
│ └── evals.json 3 test cases
└── references/
├── design-principles.md Naming, versioning, CRUD, parameters
├── design-extensibility.md Arity, metadata, SOLID, response evolution
├── payloads-errors.md Response structure, pagination, errors, IDs
├── security-auth.md Identity, auth, tokens, trust boundaries
├── security-defense.md Enumeration, CSRF, CORS, info disclosure
├── resilience.md Retries, circuit breakers, observability
├── api-communication-patterns.md REST vs GraphQL vs WebSockets vs SSE
├── api-gateways.md Gateway patterns and product comparison
├── human-aspect.md Adoption, documentation, NFRs
├── pragmatism.md Dependencies, lock-in, build vs buy
└── sources.md Consolidated references (cited in findings)
```
### create-a-skill
你的技能编写助手。指导你完成创建、测试和发布代理技能的整个生命周期 —— 从最初的访谈直到打包可分发的 `.skill` 文件。
**功能：**
1. **收集需求** —— 就技能的目的、触发器、输出格式、边缘情况和依赖对你进行访谈；通过网络搜索和 MCP 研究领域
2. **起草技能** —— 使用适当的 frontmatter、渐进式披露、捆绑脚本和参考文件编写 SKILL.md
3. **使用评估进行测试** —— 生成并行运行（有技能与基线对比），起草断言，对输出进行评分，并汇总基准测试
4. **根据反馈迭代** —— 启动交互式查看器以进行定性审查，阅读你的反馈，并重写该技能
5. **优化描述** —— 生成触发评估查询，运行带有训练集/测试集划分的自动化优化循环，以最大化触发准确性
6. **打包** —— 验证并创建可供分发的 `.skill` zip 文件
**主要特性：**
- 在编写任何代码之前进行详细的用户访谈
- 对不熟悉领域进行网络研究
- 包含评分、基准测试和分析阶段的定量评估循环
- 用于定性审查的交互式 HTML 查看器
- 技能版本之间的盲测 A/B 比较（高级）
- 通过训练集/测试集划分优化描述，防止过拟合
- 符合 Skill 2.0 规范的输出
**许可说明：** 此技能是一项衍生作品，其中包含了 Anthropic 的 [skill-creator](https://github.com/anthropics/skills)（Apache 2.0）和 Matt Pocock 的 [write-a-skill](https://github.com/mattpocock/skills)（MIT）的材料。有关详细信息，请参阅 `skills/create-a-skill/NOTICE` 和 `skills/create-a-skill/LICENSE.txt`。
```
create-a-skill/
├── SKILL.md Workflow (6 phases) + writing guide
├── agents/
│ ├── grader.md Assertion evaluation against outputs
│ ├── comparator.md Blind A/B comparison
│ └── analyzer.md Post-hoc analysis + benchmark patterns
├── assets/
│ └── eval_review.html Trigger eval review UI template
├── eval-viewer/
│ ├── generate_review.py Interactive result viewer server
│ └── viewer.html Viewer HTML template
├── references/
│ └── schemas.md JSON schemas for all data structures
├── scripts/
│ ├── quick_validate.py SKILL.md validation
│ ├── package_skill.py .skill file packaging
│ ├── run_eval.py Trigger testing
│ ├── run_loop.py Description optimisation loop
│ ├── improve_description.py Description improvement
│ ├── aggregate_benchmark.py Benchmark aggregation
│ ├── generate_report.py HTML report generation
│ └── utils.py Shared utilities
├── LICENSE.txt Apache License 2.0
└── NOTICE Attribution notice
```
## 安装
### 通过 npx（适用于 Claude Code, Codex, Cursor）
安装所有技能：
```
npx skills add psenger/ai-agent-skills
```
列出所有可用技能：
```
npx skills list psenger/ai-agent-skills
```
安装特定技能：
```
npx skills add psenger/ai-agent-skills --skill vault-scribe
```
在本地安装以进行自定义：
```
npx skills add psenger/ai-agent-skills --skill vault-scribe --local
```
### 通过 Claude Code Marketplace
```
claude plugin marketplace add psenger/ai-agent-skills
claude plugin install vault-scribe@psenger-skills-marketplace
```
### 手动安装
克隆仓库并复制技能文件夹：
```
# 全局（适用于所有项目）
cp -r skills/vault-scribe ~/.claude/skills/vault-scribe
# 本地（特定项目）
cp -r skills/vault-scribe .claude/skills/vault-scribe
```
## 用法
安装后，技能会根据你的请求自动激活。你也可以直接调用它们：
### vault-scribe
```
/vault-scribe article
/vault-scribe meeting
/vault-scribe brainstorming
/vault-scribe strategy
/vault-scribe deep-research
```
或者描述你的需求 —— 技能会根据上下文触发：
```
"Turn this transcript into an Obsidian note"
"Write up meeting notes from today's standup"
"Create a strategy doc for the Q3 roadmap"
```
### agentic-skeleton-dir-structure
```
/agentic-skeleton-dir-structure
/agentic-skeleton-dir-structure single
/agentic-skeleton-dir-structure mono
/agentic-skeleton-dir-structure multi-lang
```
或者描述你的需求 —— 技能会根据上下文触发：
```
"Set up a new project for an agentic AI service"
"Scaffold a mono-repo for my full-stack TypeScript app"
"Create a directory structure for this project"
"Initialize an Agent-OS project layout"
```
将仓库模式作为参数传递以跳过第一个问题。不带参数时，技能将以交互方式引导你完成所有六个问题。
### git-commit-pr-message
```
/git-commit-pr-message commit
/git-commit-pr-message pr
/git-commit-pr-message changelog
/git-commit-pr-message release
```
或者描述你的需求 —— 技能会根据上下文触发：
```
"Commit these changes"
"Create a PR for this branch"
"Update the changelog"
"Cut a release for v1.2.0"
```
注意：此技能设置了 `disable-model-invocation: true`，因此只在你显式调用时才会激活 —— 它绝不会在正常对话中自动触发。
### design-critique
```
/design-critique
```
或者自然地触发它：
```
"Grill me on this architecture"
"Stress-test this plan"
"Pre-mortem this feature design"
"Red team my approach"
"Critique this"
```
该技能会自主导向相关上下文 —— 如果它拥有文件访问权限，它会在提出第一个问题之前静默读取代码库。
### arch-lens
```
/arch-lens
/arch-lens src/payments
```
或者自然地触发它：
```
"Arch review this codebase"
"Find shallow modules"
"Surface coupling and testability issues"
"Run an Ousterhout review on src/"
"Find architectural friction"
"Audit the module depth"
```
传递可选的路径以将分析范围限定于特定目录。不带参数时，技能将分析整个代码仓库。该技能将以交互方式引导你完成所有七个步骤 —— 在没有你输入的情况下，它不会越过候选确认或接口选择阶段。最终输出是位于项目根目录的 `arch-rfcs-YYYY-MM-DD.md` 文件，可直接使用你的 GitHub 或 Jira MCP 工具进行操作。
### review-api-design
```
/review-api-design
/review-api-design POST /users, GET /users/{id}, DELETE /users/{id}
```
或者自然地触发它：
```
"Review my API"
"API design review"
"Vet this REST contract"
"Check my endpoints"
"Is this endpoint structure any good?"
```
将端点列表或 OpenAPI 规范作为参数传递，或在后续消息中粘贴它。对于模糊的口头描述（“我正在为 X 构建 API”），技能会在生成审查之前提出澄清问题。输出是一份结构化的审查文档，包含严重性评级的发现和准备情况评估。
**注意：** 此技能在通过 `/review-api-design` 显式调用时最为可靠。它可能会在有关 API 设计的计划模式对话中自动触发，但建议显式调用。
### create-a-skill
```
/create-a-skill
```
或者自然地触发它：
```
"I want to make a skill for X"
"Turn this into a skill"
"Create a skill that does Y"
"Write a skill for managing Z"
"Help me build a new skill"
```
该技能在编写任何内容之前会先访谈你以了解需求。它处理整个生命周期 —— 从初稿到评估、迭代、描述优化和打包。
### handoff
将当前会话的完整状态捕获到结构化的 JSON 快照中，以便你可以在新会话中干净地恢复、切换任务阶段或将工作委派给子代理而不丢失上下文。
**两种模式：**
| 模式 | 何时使用 |
|---|---|
| CREATE | 会话接近 300–400k Token、切换阶段、委派给子代理，或带着正确状态重新开始时 |
| RESUME | 加载先前的快照以从你中断的地方继续 |
**为什么它优于 `/compact`：** 压缩是有损的，并且表现出近期偏好。该 schema 强制要求每个字段 —— 目标、决策、已完成步骤、待处理步骤、约束、发现的问题、已修改文件 —— 都必须明确。没有任何内容会被静默丢弃。
```
/handoff # save to .claude/handoffs/
-.json
/handoff auth-refactor.json # save to explicit path
/handoff load auth-refactor.json # resume from file
```
### agent-os-assist
你的 Agent OS v3 参考。涵盖安装、斜杠命令、配置文件、标准和工单到规范工作流 —— 包含 Claude 训练数据中没有的特定版本文档。
**用例：**
- 端到端地引导全新的 Agent OS v3 安装
- 将 Jira 或 GitHub 工单转换为 `/shape-spec` 运行
- 在 `~/agent-os/config.yml` 中配置配置文件继承
- 安装 Agent OS 后编写你的第一个标准
- 恢复损坏的规范而不丢失对话历史
- 从 v2 artifacts 迁移到 v3 约定
```
/agent-os-assist
```
或者自然地触发它：
```
"How do I install Agent OS?"
"Turn this GitHub issue into an Agent OS spec"
"What should be in ~/agent-os/config.yml?"
"I just installed agent-os, where do I start?"
"My spec is wrong — how do I recover without losing history?"
```
**注意：** 此技能很难仅通过自然语言可靠触发 —— 使用 `/agent-os-assist` 显式调用以获得最佳效果。
```
agent-os-assist/
├── SKILL.md Routing table + workflow overview
└── references/
├── getting-started.md Bootstrap and onboarding workflows
├── installation.md Install and scaffold steps
├── commands.md Slash command reference
├── profiles.md Profile structure and inheritance
├── standards.md Writing and managing standards
├── standards-vs-skills.md When to use a standard vs a skill
├── file-structure.md v3 directory layout
└── v2-vs-v3.md Migration reference and v2 artifact flags
```
### agent-os-profile-critique
你的 Agent OS 配置文件审计助手。根据 v3 约定审查配置文件和标准文件，并生成带有具体重写建议的严重性标签发现。
**严重性级别：**
| 级别 | 含义 |
|---|---|
| Blocking | 必须在配置文件可用之前修复 |
| Warning | 应该修复；会降低 AI 有效性或导致偏差 |
| Suggestion | 改善清晰度、上下文窗口效率或可维护性 |
```
/agent-os-profile-critique
```
或者自然地触发它：
```
"Audit my Agent OS profile"
"Review this standard — is it any good?"
"Critique my agent-os setup"
"What's wrong with this standards file?"
"Validate my profile against v3 conventions"
```
**注意：** 此技能很难仅通过自然语言可靠触发 —— 使用 `/agent-os-profile-critique` 显式调用以获得最佳效果。
```
agent-os-profile-critique/
├── SKILL.md Routing table + audit workflow
└── references/
├── review-checklists.md Severity-tagged audit checklists
├── standards.md Standards quality criteria
├── file-structure.md v3 directory layout reference
├── profiles.md Profile conventions
├── standards-vs-skills.md Standards vs skills decision guide
└── v2-vs-v3.md v2 artifact detection patterns
```
## 添加新技能
1. 在 `skills/` 下创建一个带有小写连字符名称的文件夹
2. 添加包含 YAML frontmatter 和过程指令的 `SKILL.md`
3. 如果需要，在 `references/` 中添加参考文件
4. 在 `examples/` 中添加示例以提高激活率
5. 在 `.claude-plugin/marketplace.json` 中添加条目
6. 更新此 README 表格
7. 提交 Pull Request
```
skills//
├── SKILL.md Required — metadata + instructions
├── references/ Optional — detailed reference material
└── examples/ Optional — example input/output pairs
```
## 作者
**Philip A Senger**
- GitHub: [@psenger](https://github.com/psenger)
## 许可证
本项目基于 [MIT License](LICENSE) 授权。
Copyright (c) 2026 Philip A Senger