内容
# 代理技能
共享的代理技能和MCP配置，适用于Jeremy Kuhne的.NET仓库。
这是**公共部分**：每个仓库都从这里获取其所需的技能的固定、来源标记的副本。
它既是[`gh skill`](https://docs.github.com/copilot/reference/copilot-cli-reference/cli-plugin-reference)的来源，也是Copilot/Claude插件市场。
> **状态：早期。** 分发框架、MCP配置和CI已经就绪，首批共享技能核心已经在`skills/`下上线。更多的技能和代理角色将在后续阶段陆续推出。请参阅touki仓库中的设计文档：`docs/skills-improvement-plan.md`。
## 模型
技能被编写为可移植的**核心**，并从这里共享。每个使用该技能的仓库（touki、madowaku、thirtytwo等）都持有**固定副本**，以及一个薄的、特定于仓库的**叠加层**：
- **核心**是通用的：没有特定于仓库的路径、项目名称、交叉引用或源示例链接。它必须在不修改的情况下通过消费者的链接检查。
- **叠加层**位于消费仓库中，包含特定于该仓库的所有内容 - 路径、与其他技能的交叉引用、示例链接。
公共部分是**双向的**：在任何仓库中进行的通用改进都会流回这里（当合理时 - 上游更新并非自动），而特定仓库的调整则保留在其自身的叠加层中。生命周期由`manage-skills`技能驱动（`find` / `build` / `update`）。
## 使用技能
使用GitHub CLI（>= 2.90，需要 `gh auth login`）：
```pwsh
# 将一个技能安装到仓库的.agents/skills/目录中，固定到某个标签或SHA。
gh skill install JeremyKuhne/agent-skills <技能> --pin vX.Y.Z
# 稍后，作为正常差异检查上游偏移。
gh skill update <技能>
```
`--pin`记录确切的版本（并写入来源仓库、引用和树SHA到副本的frontmatter中）。提交固定副本和任何叠加层。
作为插件（技能 + 代理角色 + MCP服务器）：
```pwsh
copilot plugin marketplace add JeremyKuhne/agent-skills
copilot plugin install agent-skills@jeremykuhne-agent-skills
```
安装插件会引入 `.mcp.json` 中声明的MCP服务器。客户端可以根据需要启动它们：NuGet服务器通过 `dnx` 在本地运行，并固定版本（`NuGet.Mcp.Server@1.4.3`），而 `microsoft-learn` 是官方微软域名上的托管HTTP端点。在安装前请检查 `.mcp.json`，如果这在您的环境中很重要。
## 布局
| 路径 | 用途 |
| ---- | ------- |
| `skills/` | 共享的技能核心（`gh skill`来源）。 |
| `agents/` | 可移植的代理角色（例如，通用审查员）。 |
| `plugin.json` | 插件清单（技能 + 代理角色 + MCP），适用于CLI / Claude。 |
| `.github/plugin/marketplace.json` | 市场列表，以便插件可以按名称安装。 |
| `.mcp.json` | 技能依赖的MCP服务器（`microsoft-learn`，NuGet）。 |
| `FORMAT.md` | 贡献核心技能时遵循的技能文件格式。 |
| `CONTRIBUTING.md` | 如何编写和验证共享核心技能。 |
| `CODE_OF_CONDUCT.md` | 项目中每个人都应遵守的行为准则。 |
| `SECURITY.md` | 如何私下报告漏洞。 |
| `LICENSE` | 项目所依托的MIT许可证。 |
## 管理
消费者提供固定、来源标记的副本，因此已发布引用的稳定性很重要。管理门控：`LICENSE`（MIT），安全策略（[SECURITY.md](SECURITY.md)），贡献条款（[CONTRIBUTING.md](CONTRIBUTING.md)），以及行为准则（[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)）；固定安装；以及不可变的发布，因此固定标签在事后不能被重写。
## 许可证
[MIT](LICENSE)。
