项目与 Context Pack
把项目事实、规则、历史经验和当前权限组织成 Agent 可用的上下文。
适用范围AIBoard Server + Client · 持续更新
Context Pack 不是资料打包
Context Pack 是围绕当前意图生成的、带来源和权限边界的上下文快照。它可以包含项目卡片、文档片段、代码对象、规则、历史执行、可用能力与工具,但每一项都必须回答三个问题:为什么与当前任务相关、来自哪里、当前用户是否有权使用。
上下文构建的四层来源
- 结构化项目事实:项目、工程、需求卡、任务卡、成员、状态和验收标准。
- 知识与证据:文档片段、来源文件、规则、决策、测试记录和历史产物。
- 能力与工具:当前项目允许使用的 Skill、MCP、Workflow、Process 和客户端工具。
- 运行时约束:用户权限、组织策略、令牌预算、当前环境与审批规则。
检索与裁剪
AIBoard 将明确术语和精确对象优先交给关键词检索,把对象关系、来源链和历史关联交给图谱或结构化查询,再根据项目范围与用户权限裁剪。召回结果多不代表上下文好;与任务无关的内容会占用预算,也可能增加错误行动的概率。
来源引用
进入 Context Pack 的结论应保留来源对象、版本和引用位置。Agent 输出事实判断时,应能回到相应文档片段、代码提交、卡片版本或执行记录。无法验证来源的内容只能作为假设,不能直接写成项目事实。
常见错误
- 把整个知识库无差别加入任务。
- 使用已经被新版本替代的项目规则。
- 只引用总结,不保留原始证据。
- 忽略当前用户和 Agent 的资源权限差异。
- 将临时执行输出直接当成长期知识,没有经过人工确认和版本登记。
