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.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 样例
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。
  • 采用环境变量引用敏感信息。
  • 文件编辑需确保字符转义正常。