Markdown 驱动的 Prompt 工程
Markdown-Driven Prompt Engineering
通过 Markdown 文件组合构建 Agent 的 system prompt
子问题
1.多文件有序加载
2.YAML frontmatter 处理
3.运行时 prompt 刷新
4.Bootstrap 引导流程
5.会话恢复后 prompt 陈旧问题
6.首次交互的自毁式引导协议
7.Markdown 文件的双层目录管理（working + memory）
各项目的解法1 solutions
Signals
横向对比
| 维度 | CoPaw |
|---|---|
| Prompt 来源 | 三层 Markdown 文件（AGENTS.md → SOUL.md → PROFILE.md）按序加载 |
| 元数据处理 | YAML frontmatter 自动剥离，split('---', 2) 轻量实现 |
| 运行时刷新 | rebuild_sys_prompt 每次 query 前从磁盘重读，替换 memory 中 system 消息 |
| 冷启动引导 | BOOTSTRAP.md + pre_reasoning hook + .bootstrap_completed 标记文件 |
| 降级策略 | required 文件缺失 fallback 默认 prompt，optional 缺失静默跳过 |
| 文件管理 | AgentMdManager 单例提供 working_dir + memory 子目录双层 CRUD |
最佳实践
1.AGENTS.md + SOUL.md + PROFILE.md 三层分离关注点
2.rebuild_sys_prompt 在 session 恢复后立即调用确保一致性
3.BootstrapHook 用 .bootstrap_completed 标记文件防止重复触发
4.required/optional 属性控制文件缺失时的降级行为