当智能体变成一份 Markdown 文档
归档说明:原文是一篇 2,895 行的早期综合文,把 Markdown 载体、Agent Loop、Skill、Memory、Subagent 和 Harness 放在同一条叙事中。相关内容已在 2026-07-17 拆入带事实核验日期的专题文章;本页保留原 URL,作为迁移索引。
原文提出的核心问题仍然成立:一份 Markdown 可以向 Agent 提供指令、知识和工作流,但不能独立构成完整 Agent。文件需要由 Harness 发现和装配,动作需要工具、权限与 sandbox 执行,长会话还需要 compact、外部状态和恢复合同。
内容迁移表
| 原文主题 | 当前专题 |
|---|---|
| Markdown、Rules、Skills、Tools、Memory 的组件边界 | AI Coding Agent 的上下文栈:组件边界与装配顺序 |
| Agent Loop、Hook、权限、工具结果与停止条件 | 一次 AI Coding Agent Turn 的上下文生命周期 |
| Skill 的发现、目录、正文加载与 compact 恢复 | AI Coding Agent 的 Skill 加载机制深度解析 |
| Messages 的追加、裁剪、摘要、外置与重放 | 上下文管理全景:Messages 数组的六种策略 |
| Context window、外部状态与换入换出 | Context Paging:Compact、外部化、恢复与 Memory 生命周期 |
| Subagent 的独立工作集与信息回灌 | 子 Agent 的本质:上下文隔离与专门化 |
| Harness 的整体结构与阅读顺序 | AI Coding Agent 的上下文操作系统:组件、生命周期与阅读地图 |
| 模型、API、Harness 与产品实现的版本化对照 | 2026 Coding Harness 实现图谱 |
被订正的旧结论
SKILL.md被宿主读到,不等于正文已经进入模型上下文。- Skill 调用不会自动把全部 references、scripts 和 assets 一次性注入。
- Markdown 指令是上下文来源,不是权限、sandbox 和验证器的替代品。
- Messages 不是 Agent 的唯一状态;文件、数据库、索引、进程和外部服务也会保存状态。
- Claude Code、Codex、OpenCode、Cursor 与 Kimi Code 必须按版本和公开契约分别描述。
站内总入口会继续维护稳定机制与产品快照的分界。阅读具体工具行为时,以对应专题的核验日期和官方来源为准。
All articles on this blog are licensed under CC BY-NC-SA 4.0 unless otherwise stated.

