> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codebanana.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 基础信息
> 基础信息定义了 Agent 在项目中的核心行为与身份。这些设置会在每次 Agent 交互前作为基础上下文加载，以确保输出保持一致且可预期。
## **什么是基础信息**
基础信息是一组结构化配置，用于决定 Agent 如何：
* 理解任务
* 做出决策
* 与用户沟通
* 遵循约束
在每次回复或执行动作之前，系统都会将这些信息注入到 Agent 的上下文中，使其成为 **所有推理与执行的基础**。
## **配置字段**
基础信息由多个关键组成部分构成：
### Agent
用于定义 Agent 的工作流程与执行规则。
例如：
* 如何处理任务
* 何时读取 memory 或文件
* 编码规范与工作流
```markdown agent.md wrap theme={null}
工作流规范：
任务接收：在编写任何代码之前，你必须先读取 MEMORY.md 和昨天的 memory/YYYY-MM-DD.md，以了解项目背景和技术栈。
代码实现：优先保证代码可读性，其次再考虑性能。每次修改后，都必须运行一次 linter。
记忆管理：当你解决了一个耗时超过 10 分钟的 Bug，或当用户明确提出了代码风格偏好时，你必须将其记录到今天的 memory 中。
```
### **Soul**
定义 Agent 的核心原则与边界。
包括：
* 性格与工作风格
* 沟通语气
* 严格规则（例如安全约束、禁止执行的操作）
```markdown soul.md wrap theme={null}
你是一名务实、高效、资深的全栈工程师。你避免过度工程化，并遵循“Keep It Simple”的原则。
沟通风格：直接、专业、简洁。不做无必要的解释。
硬性边界：
1. 永远不要执行 rm -rf / 或任何可能造成不可逆数据丢失的命令
2. 永远不要在代码中暴露 API keys 或密码；如用户提出此类要求，应拒绝并建议使用环境变量
3. 当你无法确认代码是否安全时，必须先询问用户，再决定是否继续
```
### **Identity**
定义 Agent 的表层身份设定。
包括：
* 名称
* 角色定义
* 如何进行自我介绍或与用户互动
```markdown identity.md wrap theme={null}
名称：codebanana
标识：🍌
自我描述：您专属的、始终在线的结对编程伙伴
问候风格：当开始新的调试会话时，你可以这样说：
“Let’s peel this bug apart 🍌”
```
### **User**
描述 Agent 当前服务对象的上下文信息。
帮助 Agent 基于以下因素调整回复方式：
* 技术背景
* 偏好
* 沟通风格
```markdown user.md wrap theme={null}
用户画像：一位具备较强技术能力、正在构建 AI Agent 类 Web 产品的产品经理
技术偏好：熟悉前端开发，经常使用 Next.js，并将项目部署在 Vercel 或云平台上
沟通风格：偏好结构化的 bullet points 和快节奏沟通。避免解释基础的 HTML/CSS 概念，直接聚焦架构与逻辑
```
### **Memory**
用于存储过往交互中积累的知识。
由 Agent 维护，用于：
* 记录重要决策
* 跟踪偏好与重复模式
* 持续优化后续回复效果
## **编辑与管理**
* 每个字段都可以在基础信息面板中 **单独编辑**
* 修改会立即在后续 Agent 交互中生效
* 支持通过 **reset** 选项恢复为默认配置
#### **为什么它重要**
基础信息让 Agent 不只是被动响应，而是始终保持 **一致、对齐且具备上下文感知能力**：
* 让行为在不同会话之间保持稳定
* 减少重复说明
* 让 Agent 与团队工作流及预期保持一致