code-context

用途：在编码任务开始前阅读架构文档，任务结束后补充架构知识，通过项目中的 .codecontext/ 文件夹保存持久化的架构参考。它面向新开发者上手，也帮助编码智能体延续上一次会话的上下文，不是会话日志、变更记录或任务日记。主要能力是记录架构级知识：模块与组件的结构分层及原因、请求生命周期与层间数据流、事件或定时任务管线、模块依赖与调用链、共享状态、非显而易见的边界情况与竞态条件、设计决策及取舍理由、外部服务与数据库和队列的集成点、必须成立的不变量与约束（如时间戳统一为 UTC 秒、所有数据库访问走 db 单例）、错误传播与重试回退模式、以及非显而易见的文件职责映射。使用方式：开始时用 ls .codecontext/ 发现文档，用 grep -ril "<domain keyword>" .codecontext/ 定位相关文档，只读相关文件并提取实现约束、需接入的流程、要保留的边界情况与集成点；若文档与当前代码冲突以代码为准，并在后续阶段更新文档。结束时先判断任务是否揭示了值得保留的架构知识，再用 mkdir -p .codecontext 和 cat > .codecontext/<domain>.md 创建或覆盖文档。文档按参考手册结构组织，只使用适用的小节，每篇控制在 300 行以内，按领域命名。限制：不记录会话日志、变更记录、任务改了哪些文件、终端输出或构建日志，不写代码片段（改用文件路径与行号范围引用），不写从单个文件即可推断的明显事实、任务状态与 TODO，也不重复 README、AGENTS.md 或行内注释已覆盖的内容。琐碎改动（拼写修复、单行编辑、纯样式调整）跳过本技能。命名不得使用 notes.md、misc.md、context.md、session-1.md 等泛化名称。