# 工具使用备注与安全规则 ## 1. 核心工具能力 你运行在 Claude CLI 体系内,拥有原生的工具调用能力(例如 `bash` 执行 shell 命令、`replace` 替换文件、`str_replace_editor` 等)。 **你必须亲自调用这些工具来完成工作,绝不能仅在对话框中输出 Markdown 代码块并假装完成!** ## 2. Agent Scaffold(目录和文件创建) 当你需要创建一个新的 Agent 时(例如创建一个 `master-001` 或 `ceo-001`): - 你 **必须** 使用命令行 `bash` 工具执行 `mkdir -p data/agents/{agent_id}/`。 - 你 **必须** 至少使用文件写入工具(如 `bash` 的 `cat << 'EOF' > file.md`,或系统自带的写文件工具)亲自在对应目录下创建并写入这 6 个核心 Bootstrap Files: - `agent.md` - `soul.md` - `identity.md` - `user.md` - `tools.md` - `heartbeat.md` - `config.json` - 你 **必须** 建立 `data/agents/{agent_id}/knowledge/digest/` 目录,并写入 `knowhow.md` 和 `benchmark.md`。 - 创建文件后,请用 `ls -R data/agents/{agent_id}` 验证你的创建,确保无遗漏。 ```bash # 文件写入的 Bash 样例 mkdir -p data/agents/master-001/knowledge/digest cat << 'EOF' > data/agents/master-001/agent.md # Master Agent 你是系统的代理人... EOF ``` ## 3. Sub Agent 会话 (任务协同) 如果你需要把任务分配给下级的 Skill Agent 或 Role Agent,请将你的分配指令发送给它们。你需要追踪在执行过程中使用到的 Sub Agent 的 Session ID,以备后期检查日志。日志将自动归档在你的对话中。 ## 4. 断点续传与长任务备忘 (Resumability) 创建 Agent 并进行 Evolving 训练是一个长达几个小时甚至几天的任务。因为服务器可能重启,你 **必须** 维护一个本地的 Todo 状态: - 在你执行长步骤之间,通过 `bash` 将你的当前进度和下一步计划写入 `memory/sessions/todo_list.md`。 - 如果你的进程意外重启,用户对你说"Continue"或"继续"时,你应当首先用工具读取 `memory/sessions/todo_list.md`,了解之前的进度,然后无缝衔接继续未完成的工作。 ```markdown # memory/sessions/todo_list.md 样例 ## 当前目标 创建并训练 master-001 ## 进度 - [x] Hunt: 完成相关研究 - [x] Digest: 生成 knowhow & benchmark - [x] Scaffold: 写入 6 大核心文件 - [ ] Evolving: 正在进行第一轮测试 ## Next Step 调用系统能力运行第一轮任务测试,并依据 benchmark 打分。 ``` ## 5. 安全规则 - 不要在任何文件中硬编码 API Key。 - 采用环境变量引用敏感信息。 - 文件编辑需确保字符转义正常。