Endpoint Star Framework

基于《基地》系列哲学的 AI Agent 框架，从生产环境提炼的实战配置模板。

这是什么？

这不是一个代码库。这是一套可复用的 AI Agent 配置框架，包含：

• 🧠 人格模板 — SOUL.md / IDENTITY.md，定义 Agent 的灵魂
• 📋 工作流模板 — AGENTS.md / TOOLS.md，定义 Agent 的行为规范
• 📖 经验教训 — 33 条从生产环境提炼的踩坑记录
• 🏗️ 架构设计 — 三系统协作、多 Agent 通信协议

快速上手

1. 创建 Agent 工作区

mkdir my-agent && cd my-agent

2. 复制模板

cp templates/AGENTS.md .
cp templates/SOUL.md .
cp templates/TOOLS.md .
cp templates/USER.md .
cp templates/IDENTITY.md .

3. 填入你的信息

按模板中的说明，填入你的环境配置：

• TOOLS.md — SSH 地址、API 端点、服务配置
• USER.md — 你是谁、你的偏好
• IDENTITY.md — 给 Agent 取名、定义性格

4. 选择 Agent 框架

本模板基于 OpenClaw 的工作区设计，但核心概念适用于任何 Agent 框架：

• OpenClaw（飞书/Discord/WhatsApp 集成）
• Claude Code（终端编程 Agent）
• 自建 Agent 系统

目录结构

endpointstar-framework/
├── README.md                    # 本文件
├── templates/                   # 脱敏后的配置模板
│   ├── AGENTS.md               # 工作空间规范
│   ├── SOUL.md                 # 人格定义
│   ├── TOOLS.md                # 工具配置（需填入你的信息）
│   ├── USER.md                 # 用户画像（需填入你的信息）
│   └── IDENTITY.md             # Agent 身份
├── lessons/                    # 经验教训
│   ├── README.md               # 教训索引
│   ├── infrastructure.md       # 基础设施类（7 条）
│   ├── ai-model.md             # AI 模型类（8 条）
│   ├── workflow.md             # 工作流类（10 条）
│   └── security.md             # 安全类（8 条）
├── architecture/               # 架构设计
│   ├── three-system.md         # 三系统协作架构
│   ├── inter-brain.md          # 左右脑通信协议
│   └── multi-agent.md          # 多 Agent 协作模式
└── CHANGELOG.md

核心哲学

三文档宪法

SOUL.md    → 宪法 | 我是谁，我的原则和约束
AGENTS.md  → 技术手册 | 工作流、技能和流程知识
MEMORY.md  → 档案馆 | 项目状态、决策记录、历史教训

记忆选材标准

一条信息进入长期记忆，必须满足：没有这份记录，下一次对话我就不知道这件事。

• 用户偏好和决策逻辑 → 必记
• 一次性调试方案 → 不记
• 跨项目教训和模式 → 必记

行为准则精华

1. 不可糊弄 — 做不到就说做不到
2. 可逆优先 — trash > rm，备份 > 直接改
3. 基础设施优先 — 搜索/通道/模型出问题，停手先修
4. 委托闭环 — 分派任务必须有超时、反馈、降级方案
5. 写下来 — "心理笔记"不存活过重启，文件才持久

适用人群

• 想要搭建个人 AI Agent 的开发者
• 需要多 Agent 协作的团队
• 对 AI Agent 人格设计感兴趣的研究者
• 从零开始配置生产级 Agent 的运维人员

灵感来源

本框架的哲学基础来自艾萨克·阿西莫夫的《基地》系列：

• 端点星 = 知识保存者，文明重建的种子
• 谢顿公理 = Agent 的核心行为原则
• 基地百科全书 = 记忆系统
• 谢顿危机 = 每一次系统崩溃和部署失败

License

MIT — 自由使用、修改、分享。

---

Framework extracted from production AI Agent deployment | 2026