当前目录 是这个仓库的可移植源包，用来提供一套“提示词优先”的本地工作流。

把当前目录复制到别的项目里之后，可以在本地完成 bootstrap，并获得一套轻量的 prompt 系统，包含记忆、任务状态、审计日志和轻量 checkpoint。

• ./prompts/intake.md：首次接手项目时的关键问题收集 prompt
• ./framework_construction.md：总入口 Prompt
• ./prompts/：面向不同任务类型的专用 Prompt
• ./.ai/：源记忆、状态和日志模板
• ./AGENTS.md：会被复制到项目根目录的运行规则
• ./scripts/pipeline.py：本地 bootstrap 和生命周期脚本
• ./scripts/pipeline.py 还会自动生成项目进展和固定 prompt 文件

1. 把整个当前目录复制到目标项目里。
2. 在目标项目里执行 python ./scripts/pipeline.py bootstrap，把运行时文件放到根目录。
3. 先把 README、AGENTS.md 和现有流程说明交给助手。
4. 用 ./prompts/start.md 或 ./prompts/intake.md 先补齐项目背景和当前进展。
5. 后续按 progress、status、snapshot、run、validate 维护项目进展。
6. 用 fixed-prompt 直接查看自动生成的固定项目 prompt。
7. 如果要升级或清理，再用 upgrade、purge。

• 项目是做什么的
• 目前做到哪一步了
• 现在最想优化 log 系统、run 系统，还是别的地方
• 现在最想解决什么问题
• 运行环境是什么，尤其是 Python、conda、系统依赖和私有变量
• 你希望它能用哪些工具
• 你希望它不要碰哪些工具或文件
• 你不能接受哪些改动
• 如果方便，直接把现有 README 或流程说明发过去

你回答完问题后，工具会自动帮你处理这些事：

• 识别当前项目适合走哪种工作方式
• 判断是否需要先做安全准备
• 记录当前任务状态
• 必要时创建可回退版本
• 按需切换到合适的处理路径
• 自动生成固定项目 prompt，把背景、效率要求、代码规范和阅读优先级固化下来
• 如果要写代码，默认补简洁注释，并给新文件和已有代码文件加简短文件头，先写明用途，再写日期、作者 lxk 和 GPL
• 读代码文件时先看文件头和顶部描述，再决定是否需要读全文，优先节省 token
• 文件头默认直接贴这段模板：

# 文件用途：<一句话说明这个文件是干什么的>
# 日期：<YYYY-MM-DD>
# 作者：lxk
# 协议：GPL

这部分是给需要直接操作命令的人看的。日常使用不必先看这里。 snapshot 现在会尽量复用上一版结果；如果没有变化，它会直接复用上一次 checkpoint。它会输出一个很小的 JSON 记录，主要覆盖项目文件，不会反复把运行时的 state 和 logs 打进去。

• upgrade：更新根目录规则文件，同时保留现有 .ai 数据

• purge：清除根目录生成的项目痕迹，主要是 .ai 和 AGENTS.md

• python <package>/scripts/pipeline.py bootstrap

• python <package>/scripts/pipeline.py init

• python <package>/scripts/pipeline.py preflight

• python <package>/scripts/pipeline.py snapshot

• python <package>/scripts/pipeline.py run

• python <package>/scripts/pipeline.py validate

• python <package>/scripts/pipeline.py cleanup

• python <package>/scripts/pipeline.py upgrade

• python <package>/scripts/pipeline.py purge

• python <package>/scripts/pipeline.py finish

• python <package>/scripts/pipeline.py fail --error "原因"

• python <package>/scripts/pipeline.py status

• python <package>/scripts/pipeline.py fixed-prompt

• python <package>/scripts/pipeline.py probe

• python <package>/scripts/pipeline.py pipeline

这些文件会被工具自动读取和更新：

• .ai/：运行时信息、状态、日志和快照
• AGENTS.md：项目里的运行规则

如果你愿意进一步定制，优先改当前目录里的 prompt 和规则文件。第一次接手项目时，先用 ./prompts/start.md 的结构化提问把上下文问清楚，再继续后面的步骤。