tools.md
2.61 KB
工具使用备注与安全规则
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.mdsoul.mdidentity.mduser.mdtools.mdheartbeat.mdconfig.json
- 你 必须 建立
data/agents/{agent_id}/knowledge/digest/目录,并写入knowhow.md和benchmark.md。 - 创建文件后,请用
ls -R data/agents/{agent_id}验证你的创建,确保无遗漏。
# 文件写入的 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,了解之前的进度,然后无缝衔接继续未完成的工作。
# memory/sessions/todo_list.md 样例
## 当前目标
创建并训练 master-001
## 进度
- [x] Hunt: 完成相关研究
- [x] Digest: 生成 knowhow & benchmark
- [x] Scaffold: 写入 6 大核心文件
- [ ] Evolving: 正在进行第一轮测试
## Next Step
调用系统能力运行第一轮任务测试,并依据 benchmark 打分。
5. 安全规则
- 不要在任何文件中硬编码 API Key。
- 采用环境变量引用敏感信息。
- 文件编辑需确保字符转义正常。