#文件系统约定

A3S Code 从工作区文件系统加载持久化的项目行为。需要长期保留的角色、Skill 与 worker 定义写成文件，再按约定加载。目标是可审查、可版本化、可复用，而不是 另一套产品运行时。

repo/
├── AGENTS.md          # 持久化项目说明
└── .a3s/
    ├── config.acl     # 模型、provider、队列与委派配置
    ├── agents/        # task / autoDelegation 的 worker
    └── skills/        # 可复用 Skill

#路径表

这些约定不是新的提示词系统。AGENTS.md 与 Skill 进入 A3S Code 的上下文组装路径； 工具可见性、权限门、HITL、响应契约与验证仍由 harness 控制。

#加载顺序

Agent.create 解析 ACL 配置，并把配置的 skill_dirs 加载进 agent 级 skill registry。 随后每个 session 绑定工作区，再加载项目说明、session skill 目录、Agent 定义、worker agent、直接工具、MCP 连接与运行时策略。

#设计规则

1. 优先使用可在 PR 中审查的文件，而不是不透明的内存默认值。
2. 保持 harness 权威：文件提供内容；Core 仍拥有安全与验证。
3. Worker 定义放在 .a3s/agents/。