一个用 C# / .NET 一步一步拆解并实现 coding agent harness 的学习仓库。

这里不追求“快速搭个 demo”，而是尽量把真正决定 agent 能力的主干机制拆清楚、写出来、跑起来。

如果你想学的不是某个现成产品的表面用法，而是下面这些底层能力如何长出来，这个仓库就是为这个目标准备的：

• Agent Loop
• Tool Use
• Planning / Todo
• 后续会继续补 Subagent、Skills、Memory、Permission

当前版本先覆盖前三章最关键的教学骨架：

• Step01.AgentLoop：最小 loop
• Step02.ToolUse：工具注册与副作用
• Step03.Planning：最小 todo / planning

• 先做最小可运行版本，再逐章长出复杂度
• 先讲清状态流转，再接真实模型 SDK
• 先让代码可读、可验证、可复现，再谈“像不像某个产品”
• 少一点包装，多一点能自己手写出来的理解

dotnet build LearnAgent.slnx
dotnet run --project samples/LearnAgent.Step01.AgentLoop
dotnet run --project samples/LearnAgent.Step02.ToolUse
dotnet run --project samples/LearnAgent.Step03.Planning

src/
  LearnAgent.Core/              核心运行时与工具抽象
samples/
  LearnAgent.Step01.AgentLoop/  章节 1：最小闭环
  LearnAgent.Step02.ToolUse/    章节 2：工具平面
  LearnAgent.Step03.Planning/   章节 3：计划层
docs/
  csharp-self-study-roadmap.md
  learn-claude-code-mapping.md

• 先做离线、可跑、可读的最小版本
• 先理解 loop 和状态流转，再接真实模型 SDK
• 先把工具协议跑通，再扩展 permission、memory、skills

• 想用 C# 学 agent，而不是只会调 SDK 的人
• 想把 learn-claude-code 的主线真正迁移到 .NET 的人
• 想边学边改，自己往后续章节继续长的人

1. 把 IAgentBrain 从规则实现替换成真实 LLM SDK。
2. 增加 edit_file、search_text、shell_command 等工具。
3. 继续补 Subagent、Skill、Permission、Memory 等章节。