内容
# .NET + Claude 代码启动器
[](https://github.com/Khavel/dotnet-claude-starter/actions/workflows/ci.yml)
[](https://dotnet.microsoft.com/)
[](LICENSE)
一个微小的、生产就绪的 **.NET 10 最小化 API**，旨在由 **AI 编码代理**（Claude Code、Copilot、Cursor）驱动。代码故意保持小巧。重点是围绕它的 **操作层**：一个调优的 [`CLAUDE.md`](CLAUDE.md)，一个 [`AGENTS.md`](AGENTS.md)，一个精选的 [MCP 配置](.mcp.json)，以及允许代理在无忧的情况下重构的契约测试。
这是 **[Sharpyard](https://sharpyard.dev/founding/?utm_source=github&utm_medium=readme&utm_campaign=dotnet-claude-starter)** 的免费试用版 - 一个 AI 代理原生的 .NET + Angular SaaS 启动工具包。相同的约定，扩展到身份验证、多租户、计费等。
> ⭐ **如果这为您节省了时间，[请给仓库点星](https://github.com/Khavel/dotnet-claude-starter)** - 这有助于其他 .NET 开发人员找到它。
## 内容
```
CLAUDE.md ← 代理如何在这里工作（请阅读此文件）
AGENTS.md ← 相同，用于 Copilot / Cursor
.mcp.json ← 精选的 MCP 服务器：文件系统 + git（可选的 Roslyn C# 服务器，参见 docs/mcp.md）
.editorconfig ← 代理遵循的 C# 约定
src/Api/ ← 最小化 API：内存中的 Notes，按功能文件夹组织
tests/Api.Tests/ ← 契约测试，启动真实应用程序并固定其行为
docs/ ← “20 分钟内添加功能”演练 + MCP 注释
```
## 快速入门
```bash
git clone https://github.com/Khavel/dotnet-claude-starter
cd dotnet-claude-starter
dotnet test # 4 个契约测试，全部通过
dotnet run --project src/Api # 然后打开打印的 URL + /openapi/v1.json
```
然后在 Claude Code（或您选择的代理）中打开文件夹，并尝试：
> 在笔记中添加一个 `priority` 字段和一个 `GET /api/notes?priority=high` 过滤器。首先编写契约测试。
代理读取 `CLAUDE.md`，复制 `Notes/` 功能模式，保持测试通过，并保持在轨道上。这就是整个想法。
如果此仓库为您节省了时间，请给它点星 - 这有助于其他 .NET 开发人员找到它。
## 为什么存在
AI 代理在小型、文档齐全、测试充分的代码库中表现最佳，且具有清晰的约定。大多数 .NET 仓库都没有这些条件。这个仓库则相反：一个 **AI 原生 .NET** 项目的示例，您可以复制其 *结构*。
参见 [`docs/add-a-feature-in-20-min.md`](docs/add-a-feature-in-20-min.md) 以获取完整的循环。
## 需要整个项目？
这是 1%。完整的 **[Sharpyard](https://sharpyard.dev/founding/?utm_source=github&utm_medium=readme&utm_campaign=dotnet-claude-starter)** 套件是一个生产就绪的 .NET 10 + Angular SaaS 基础项目，具有相同的约定：身份验证 + RBAC + 多租户，通过 Merchant-of-Record 计费，事务电子邮件，管理员，背景作业，Docker，CI/CD - 以及贯穿整个项目的调优代理层。
**→ [加入 Sharpyard 等待列表](https://sharpyard.dev/founding/?utm_source=github&utm_medium=readme&utm_campaign=dotnet-claude-starter)**，以锁定创始人价格 149 欧元（启动价格 249 欧元，前 100 位创始人），并获得对完整套件的早期访问。
*Lo mismo en español: un starter de .NET pensado para que lo maneje tu agente de IA. [Únete a la lista de espera](https://sharpyard.dev/founding/?utm_source=github&utm_medium=readme&utm_campaign=dotnet-claude-starter&utm_content=es) para reservar el precio fundador de 149 EUR (lanzamiento 249 EUR, primeros 100).*
## License
MIT - 参见 [LICENSE](LICENSE)。可用于任何用途，包括商业用途。
