项目连续性
接手时
读取项目已有的目标、决策、状态和交接文档;优先查看 .soloweave/context/PROJECT.md、STATUS.md、HANDOFF.md、CHANGES.md 与相关 ADR。核对当前分支、HEAD、未提交改动及交接中提到的源文件。没有 Git 或无法读取时写“Git 不可用”。记录与实际文件不一致时指出过期内容,并以代码与当前文件为依据继续工作;不能依赖旧聊天记录。
用户只说“继续这个项目”时,先定位记录中的下一步或阻塞,核对它是否仍存在,再处理能安全推进的最近一项。交接缺失或不完整时,检查 README、依赖、相关源码和实际可用的验证,重建当前任务与未完成事项;不要把缺失记录当作没有工作。工具或依赖策略阻断验证时,记录阻塞和可执行的解除步骤,所需授权仍向开发者取得。只有没有可判断的下一步,或必须由开发者选定重大方向时才提问。未实际完成启动、构建或测试时,不宣称项目已可运行。
检查点
完成有意义的任务、出现阻塞或准备换账号时,先检查本轮实际修改和验证,再更新项目已有的等价文档;没有时使用 .soloweave/context/ 下的四个 Markdown 文件:
PROJECT.md保存稳定目标、入口和已确认 ADR 链接,避免每次重写。STATUS.md保存已完成、当前任务、阻塞与下一步。CHANGES.md记录重要改动及文件;不要复制完整 Git 日志。HANDOFF.md简短说明当前任务、最近修改与文件、实际验证命令及结果、未解决问题、下一步、核对时间和可取得的 Git 状态。未运行的检查写“未运行”。
在结束回复前完成这次检查点;即使因构建、权限或依赖问题未能继续,也要在 STATUS.md 和 HANDOFF.md 写清具体阻塞、已经验证的事实与下一步。只有代码或重要文件确有变化时才追加 CHANGES.md;不要为无变化的接手凭空记一条改动。
只记录经过核对的事实,不写入凭据、令牌或私钥。上下文使用 Markdown;人工核对不等于机器过期检查,不伪造其他工具的检查点、批准或安装记录。小型无持续影响的改动无需扩大成冗长日志,但应让下一次接手能识别重要进展。