C# 实现简版 Claude Code | 用 Todo 对抗遗忘（3）
内容提要
本文介绍了基于Python的Claude Code核心原理，并将其重写为.NET 10版本。重点在于通过TodoWrite工具明确任务计划，解决上下文衰减问题，从而有效管理多步骤任务。约束设计提升了任务执行效率，实现了认知外部化。
关键要点
-
文章基于github.com/shareAI-lab/learn-claude-code，分析Claude Code核心原理。
-
代码已重写为.NET 10版本，源码已上传至github。
-
引入TodoWrite工具以解决上下文衰减问题，明确任务计划。
-
上下文衰减导致任务计划模糊，TodoWrite工具使计划显式化。
-
TodoManager设计核心数据结构，提升任务执行效率。
-
约束设计防止无限任务列表，确保一次只做一件事。
-
软提示机制引导模型使用Todo，提升任务管理效果。
-
TodoManager外部化模型的工作记忆，减少上下文污染。
-
v2版本解决了单个Agent的规划问题，v3将引入子代理以隔离上下文。
延伸解读
上下文衰减的挑战
上下文衰减是多步骤任务管理中的常见问题，尤其在长时间对话中，任务计划容易模糊。通过引入TodoWrite工具，任务计划变得显式化，帮助用户和模型保持清晰的任务进度。这种方法有效减少了因信息遗忘而导致的效率低下。
约束设计的重要性
文章中提到的约束设计不仅是限制，更是提升任务管理效率的护栏。通过限制同时进行的任务数量和最大任务列表长度，确保了用户能够专注于当前任务，避免了因任务过多而导致的混乱。这种设计理念在复杂任务管理中尤为重要。
外部化工作记忆的优势
TodoManager通过外部化模型的工作记忆，帮助模型专注于当前任务而不必担心遗忘整体计划。这种认知卸载的方式，不仅提升了任务执行的准确性，也使得多步骤任务的管理变得更加高效。
延伸问答
Claude Code的核心原理是什么？
Claude Code的核心原理是通过明确的任务计划和工具来解决上下文衰减问题，从而有效管理多步骤任务。
TodoWrite工具的作用是什么？
TodoWrite工具用于将任务计划显式化，帮助用户和模型清晰地跟踪任务进度，减少上下文模糊。
如何通过约束设计提升任务执行效率？
通过限制任务数量和确保一次只进行一项任务，约束设计防止无限任务列表，从而提升任务执行效率。
TodoManager的核心数据结构是什么？
TodoManager的核心数据结构是TodoItem，包括任务描述、状态和当前进行时的内容。
如何解决上下文污染问题？
通过引入子代理来隔离上下文，从而减少上下文污染，确保关键信息不被挤出。
v2版本与v3版本的主要区别是什么？
v2版本解决了单个Agent的规划问题，而v3版本将引入子代理以隔离上下文，处理更复杂的任务。
