最近，一款名为“纯文本认知架构”的开源项目在 Hacker News 上引发热议。这个名为 Show HN 的项目，通过简单的文本配置文件，让 Claude Code 能够更准确地理解开发者的意图和工作习惯。与传统的复杂集成方案不同，它仅依靠 Markdown 和 YAML 文件就能实现显著的效果提升。本文将深入解析这一创新方法，帮助你快速掌握这一前沿技术。

什么是纯文本认知架构

纯文本认知架构（Plain-Text Cognitive Architecture）是一种轻量级的 AI 对话增强框架。它不依赖任何外部数据库或专有协议，而是利用纯文本文件来存储和传递上下文信息。在 Claude Code 环境中，这些文本文件包含了项目规范、编码约定、任务分解逻辑以及历史决策记录。

核心文件结构通常包括三个部分：system-prompt.md 定义 AI 的角色定位和行为准则，context-rules.yaml 记录项目特定规则，而 memory-log.md 则保存对话过程中的关键信息。这种设计的巧妙之处在于，它将复杂的 AI 协作问题转化为文本编辑问题，让开发者能够像管理代码一样管理 AI 的行为模式。

从技术实现角度看，架构会在每次对话开始时自动读取这些文件，将其中的内容注入到 Claude Code 的上下文中。这意味着 AI 不再是从零开始理解项目，而是立即获得了项目的完整背景知识。

为什么纯文本架构更高效

传统的 AI 编程助手集成往往需要复杂的 API 配置、第三方服务对接，甚至需要专门的技术人员维护。而纯文本架构的核心优势在于它的零门槛特性。任何熟悉 Markdown 语法的开发者，都能在几分钟内完成配置并投入使用。

可维护性是另一个显著优势。由于所有配置都以纯文本形式存储，你可以直接将它们纳入版本控制系统。这意味着团队成员之间的配置同步、配置的变更历史追踪、回滚操作都变得轻而易举。相比之下，那些依赖数据库或云端配置的方案，在团队协作时往往面临同步延迟和版本冲突的问题。

可移植性同样值得称道。当你切换到新的项目或工作环境时，只需要复制这些文本文件即可。无需重新配置 API、导入历史数据或学习新的工具界面。对于需要在多个项目间频繁切换的开发者来说，这种一致性体验极大地减少了认知负担。

context-rules.yaml 示例
project:
  name: "my-web-app"
  language: "typescript"
  framework: "next.js"
coding_standards:
  naming_convention: "camelCase"
  indent_style: "space"
  indent_size: 2
code_review:
  require_tests: true
  min_coverage: 80
  block_lint_errors: true

如何快速上手

上手纯文本认知架构只需三个简单步骤。首先，在项目根目录创建一个 .cognitive 文件夹（名称可自定义）。其次，根据项目需求编写上述三个核心文件。最后，在 Claude Code 的初始化脚本中添加文件读取逻辑。

对于 Markdown 文件的编写，建议采用分层结构。第一层定义角色和职责，第二层描述具体的工作流程，第三层记录特殊情况和边界条件。每个部分都应该保持简洁明了，避免冗长的描述导致上下文溢出。

```markdown

system-prompt