智能体会读取你的代码。上下文上下文用于存放代码无法体现的内容——即代码之外的决策、约束和约定。
关于此处内容的设定缘由,可阅读项目上下文相关内容可在《概念说明》中查看。本页主要介绍其管理方法。
添加上下文
打开项目的上下文板块并新增条目。每个条目包含标题和内容,后续也可编辑或删除。
优质的条目应简短、具体且具备持久性。架构决策、编码规范、API 合约、所有权边界以及明确的禁止性规定都属于此类;而入职引导说明及代码库中已明确体现的内容则无需纳入。
保持条目独立且命名清晰
每个主题对应一个条目,标题需明确反映其所涵盖的内容。“错误处理规范”和“冻结模块”这类条目易于检索;若合并为名为“备注”的单个条目来包含两者,则难以查找。
这一点至关重要,因为上下文会根据当前工作内容选择性加载——详见进阶技能。划分清晰的条目能让正确的内容匹配对应的任务。
参考资料
除了书面条目外,还可附加参考资料——即指向外部材料的链接和文档。当权威内容存储在 Wiki 或设计工具中,且你不想维护两份易过时的副本时,便可利用此项功能。
任务专属上下文
项目级别的上下文适用于项目内的所有内容。若某份资料仅与特定工作相关——比如工单、客户报告或设计文档——则应将其附加到该任务中。若把这类任务专属备注存入项目上下文,会对后续所有任务造成干扰。
确保上下文实时准确
过时的上下文比缺失的上下文危害更大,因为智能体会将其视为权威依据。一旦约定发生变更,需在修改代码的同一批次中更新对应的条目。
查看现有上下文内容
偶尔以新人的视角浏览上下文内容。条目会不断累积,一年前迁移过程中撰写的条目如今可能已造成误导。