WorkBuddy 四层文件架构配置手册
🔍 背景：当下绝大多数通用大模型产品以对话交互为核心，能力局限于问答、文案生成等轻量场景，难以深度嵌入企业日常办公全流程，无法独立闭环完成周报撰写、PPT制作、资料整合、网页搭建、远程业务交付等完整业务任务。
✍️
💡 能力简述：WorkBuddy 提出一套分层闭环式AI Agent能力架构，彻底跳出单纯对话工具的定位，以真实业务任务为驱动核心，构建可落地、可验收、可复用的企业级智能工作助手体系。
完整目录树
代码块
Plain Text
project-root/ # 项目根目录（WorkBuddy 工作目录入口）
├── AGENTS.md # 【核心】Agent 工作规则总纲（所有项目必选）
├── PROJECT.md # 项目全局说明：目标、术语、约定
├── index.md # 全局文件索引：Agent 快速定位导航
├── CHANGELOG.md # 变更日志：所有操作记录（只追加）
│
├── 01_../assets/ # 原始资产层（只读区，Agent 禁止修改）
│ ├── docs/ # 参考文档、原始资料、需求文件
│ ├── media/ # 图片、音频、视频等多媒体素材
│ ├── data/ # 原始数据集、表格、配置文件
│ └── reference/ # 外部参考资料、标准规范
│
├── 02_workspace/ # 工作执行层（Agent 可读写，核心操作区）
│ ├── drafts/ # 草稿文件、待完善内容
│ ├── tasks/ # 按任务拆分的临时工作文件
│ └── temp/ # 临时缓存、中间处理产物
│
├── 03_output/ # 成品输出层（Agent 写入、人工验收）
│ ├── latest/ # 最新正式版本
│ ├── versions/ # 历史版本归档（按版本号命名）
│ └── reports/ # 生成的报告、清单、统计结果
│
├── 04_archive/ # 历史归档层（只读，废弃/历史文件留存）
│ ├── deprecated/ # 废弃文件与旧版本
│ └── history/ # 阶段性项目快照
│
└── .workbuddy/ # WorkBuddy 专属配置目录（可选，隐藏）
├── prompts/ # 常用提示词模板
├── rules/ # 细分专项规则文件
└── cache/ # Agent 运行临时缓存
根目录核心配置文件
根目录的 4 个文件是整套架构的规则中枢，WorkBuddy 执行任何任务前必须优先读取，优先级高于单次临时指令。
AGENTS.md — Agent 工作规则总纲
✍️
定位：项目级最高规则文件，等同于 Agent 的「工作说明书」，所有操作的唯一权威依据。
•
必填配置内容：
a.
规则优先级声明：本文件优先级高于临时指令，冲突时立即暂停并向人工确认
b.
全目录权限边界：各层目录的读写删权限约定
c.
文件操作规范：增量更新原则、命名规范、格式要求
d.
日志记录规则：变更日志的必填字段与写入要求
e.
异常处理机制：信息不足、规则冲突、风险操作时的暂停与反馈流程
更新权限：仅人工可修改，Agent 禁止自行编辑、新增规则。
PROJECT.md — 项目全局说明
✍️
定位：项目背景与约定说明书，帮助 Agent 快速理解项目上下文，减少理解偏差。
核心作用：统一项目认知，避免因上下文缺失导致的输出偏离需求。
•
必填配置内容：
a.
项目基础信息：项目名称、核心目标、适用范围、当前版本
b.
术语表：项目专属名词、缩写、别名的统一定义
c.
命名约定：文件、版本、目录的统一命名规则
d.
特殊约束：合规要求、格式标准、交付规范等专项限制
更新权限：人工维护，Agent 仅可读。
index.md — 全局文件索引
✍️
定位：项目「站点地图」，核心文件的导航目录。
核心作用：帮助 Agent 快速定位目标文件，避免全目录遍历消耗上下文，提升检索与执行效率。
•
必填配置内容：
a.
按四大分层列出核心目录与关键文件
b.
高频核心文件标注优先级
更新权限：Agent 可增量追加索引条目，禁止删除已有索引；人工可整体优化结构。
CHANGELOG.md — 操作变更日志
✍️
定位：全项目操作的唯一追溯依据，采用只追加模式。
核心作用：完整记录每一次文件变更，支持版本回溯、问题排查与操作审计。
•
标准记录格式（每条日志按时间倒序排列）：
代码块
Plain Text
## YYYY-MM-DD HH:MM
- 操作类型：[新增/修改/删除/移动/批量整理]
- 触发指令：任务核心指令简述
- 影响范围：涉及的目录/文件列表
- 变更详情：核心修改内容说明
- 执行人：WorkBuddy
- 备注：待确认事项/异常说明
更新权限：Agent 仅可在末尾追加新记录，绝对禁止修改、删除历史日志。
四层文件架构配置
01_assets — 原始资产层
✍️
整体属性：Agent 仅拥有读取权限，无任何写入、修改、删除、移动权限，是项目的唯一事实基准。
核心价值：将原始资料与加工产物物理隔离，确保原始素材永远不会被 AI 意外篡改，所有加工都基于原始副本展开。
•
子目录配置说明：
| | | |
| | | |
| | | |
| | | |
| | | |
02_workspace — 工作执行层
✍️
整体属性：Agent 完整可读写区域，是日常任务的核心操作区，可新建、修改、重命名文件。
核心价值：作为 Agent 的「工作台」，所有草稿、中间加工、任务拆解都在此完成，不污染原始资产层，也不直接混入正式成品。
•
子目录配置说明：
| | | |
| | | |
| | | |
| | | |
03_output — 成品输出层
✍️
整体属性：Agent 可新建、写入，禁止随意删除、覆盖历史版本，是项目正式交付物的唯一存放目录。
核心价值：集中管理所有正式版本，区分最新版与历史版，便于人工验收与对外输出。
•
子目录配置说明：
| | | |
| | | |
| | | |
| | | |
04_archive — 历史归档层
✍️
整体属性：Agent 仅可移入文件，不可修改、删除已归档内容，属于冷存储区域。
核心价值：留存废弃文件与阶段性快照，既不干扰主工作区，又避免历史信息丢失，支持完整回溯。
•
子目录配置说明：
| | |
| | |
| | |
底层最小闭环
✅
架构底部定义标准化最小运行闭环，是保障任务质量、降低业务风险的核心机制，完整链路：
输入真实材料 → Ask信息校验确认 → Plan方案人工审查 → Craft工具执行 → 人工验收交付
闭环全程保留人工干预节点：缺信息可补、方案不合格可修改、执行结果可验收驳回，实现“AI为主、人工把关”的人机协同模式，杜绝AI自主输出不可控内容，适配企业合规、审核类业务场景。
架构三大核心设计思想
WorkBuddy架构差异化设计理念：
✍️
场景驱动，锚定真实工作流
所有分层、工具、模型、角色均围绕企业实际办公任务设计，不做无落地价值的闲聊功能，产品价值集中于提升任务完成效率。
✍️
生态协同，打通全链路资源
通过多层架构串联大模型、本地文件、云端办公工具、第三方服务、专业执行技能，构建一体化智能工作生态，而非孤立的对话工具。
✍️
价值核心：完成完整任务，而非单纯对话
区别于市面通用对话AI，WorkBuddy的核心目标不是问答聊天，而是独立走完一整套业务任务流程，输出可直接使用、可验收的业务成果，真正承担员工辅助工作。
落地价值与行业意义
✍️
企业降本增效
标准化周报、PPT、资料整理等重复办公任务可交由WorkBuddy闭环完成，员工仅需完成人工审核环节，释放人力投入高价值创造性工作；
✍️
降低AI使用门槛
三段式拆解、自动模型调度、封装技能与办公连接器，无需使用者掌握提示词工程、API对接、模型配置等专业技术，小白也可完成复杂任务；
✍️
适配私有化企业需求
✍️
标准化AI任务流程，可规模化复制
分层架构+最小闭环流程为标准化可复用体系，企业可基于该架构批量搭建行业专属办公Agent，覆盖财务、运营、产品、设计、开发全岗位。