{"id":1933,"date":"2026-08-04T15:48:18","date_gmt":"2026-08-04T07:48:18","guid":{"rendered":"http:\/\/charlottezhiend.cn:8080\/?p=1933"},"modified":"2026-08-17T10:36:32","modified_gmt":"2026-08-17T02:36:32","slug":"1-12","status":"publish","type":"post","link":"http:\/\/charlottezhiend.cn:8080\/index.php\/2026\/08\/04\/1-12\/","title":{"rendered":"Agent\u5f00\u53d1"},"content":{"rendered":"\n

Agent loop<\/h1>\n\n\n\n

Agent Loop \uff08\u667a\u80fd\u4f53\u5faa\u73af\uff09\u6307AI Agent\u4e3a\u5b8c\u6210\u76ee\u6807\u800c\u53cd\u590d\u6267\u884c\u7684\u4e00\u5957\u95ed\u73af\u8fc7\u7a0b\uff1a\u7406\u89e3\u76ee\u6807 -> \u83b7\u53d6\u4fe1\u606f -> \u5236\u5b9a\u4e0b\u4e00\u6b65 -> \u8c03\u7528\u5de5\u5177\u6267\u884c -> \u68c0\u67e5\u7ed3\u679c -> \u51b3\u5b9a\u7ee7\u7eed\u3001\u8c03\u6574\u6216\u7ed3\u675f<\/p>\n\n\n\n

\u666e\u901a\u804a\u5929\u901a\u5e38\u662f\u4e00\u95ee\u4e00\u7b54\uff0cAgent Loop\u5219\u5141\u8bb8\u6a21\u578b\u6839\u636e\u6267\u884c\u7ed3\u679c\u6301\u7eed\u91c7\u53d6\u884c\u52a8\uff0c\u76f4\u5230\u4efb\u52a1\u5b8c\u6210\u3001\u8fbe\u5230\u6b21\u6570\/\u65f6\u95f4\u9650\u5236\uff0c\u6216\u8005\u9047\u5230\u5fc5\u987b\u7531\u7528\u6237\u5904\u7406\u7684\u963b\u585e\u3002<\/p>\n\n\n\n

One loop & Bash is all you need \u4e00\u4e2a\u5de5\u5177 + \u4e00\u4e2a\u5faa\u73af = \u4e00\u4e2aAgent<\/strong><\/p>\n\n\n\n

\u5f53\u63d0\u51fa\u4e00\u4e2a\u95ee\u9898\u7ed9\u5927\u6a21\u578b\uff1a”\u5e2e\u6211\u8bfb\u53d6\u4e0b\u6211\u7684\u76ee\u5f55\u4e0b\u6709\u54ea\u4e9b\u6587\u4ef6\u5e76\u4e14\u6267\u884cXXX.py”\uff0c\u8fd9\u4e2a\u65f6\u5019\u6a21\u578b\u80fd\u8f93\u51fa\u4e00\u6761bash\u547d\u4ee4\uff0c\u8f93\u51fa\u5b8c\u5c31\u505c\u6b62\uff0c\u4e0d\u4f1a\u81ea\u5df1\u8dd1\u56e0\u6b64\u4e0d\u4f1a\u6709\u7ed3\u679c\u4e5f\u4e0d\u4f1a\u6709\u540e\u7eed\u7684\u63a8\u7406\u3002\u4e3a\u4e86\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff0c\u5fc5\u987b\u81ea\u5df1\u624b\u52a8\u8dd1\u4e00\u904dbash\u547d\u4ee4\u7136\u540e\u628a\u8f93\u51fa\u7c98\u8d34\u56de\u53bb\uff0c\u5927\u6a21\u578b\u624d\u80fd\u63a5\u7740\u5206\u6790\u8f93\u51fa\u4e0b\u4e00\u4e2abash\u547d\u4ee4\u7136\u540e\u518d\u624b\u52a8\u6267\u884cbash\u547d\u4ee4\u7c98\u8d34\u8f93\u51fa\u7ed3\u679c\u5faa\u73af\u5f80\u590d\u3002<\/p>\n\n\n\n

\u8fd9\u4e2a\u8fc7\u7a0b\u4eba\u53bb\u624b\u52a8\u6267\u884c\u90fd\u662f\u5728\u505a\u4e2d\u95f4\u5c42\uff0c\u4e3a\u4e86\u5b9e\u73b0Agent Loop\u5c31\u662f\u8981\u5c06\u5176\u81ea\u52a8\u5316\uff1aHarness\u5c42\uff1a\u5faa\u73af-\u6a21\u578b\u4e0e\u771f\u5b9e\u4e16\u754c\u7684\u7b2c\u4e00\u9053\u8fde\u63a5<\/strong><\/p>\n\n\n\n

\"Agent<\/div><\/figure>\n\n\n\n

\u4e00\u4e2awhile True\u5faa\u73af\uff0c\u6a21\u578b\u8c03\u7528\u5de5\u5177\u5c31\u7ee7\u7eed\uff0c\u4e0d\u8c03\u7528\u5c31\u505c\u6b62\uff0c\u6574\u4e2a\u8fc7\u7a0b\u53ea\u6709\u4e24\u4e2a\u4fe1\u53f7\uff1a<\/p>\n\n\n\n

\u4fe1\u53f7<\/th>\u542b\u4e49<\/th>\u5faa\u73af\u52a8\u4f5c<\/th><\/tr><\/thead>
stop_reason == \"tool_use\"<\/code><\/td>\u6a21\u578b\u4e3e\u624b\u8bf4”\u6211\u8981\u7528\u5de5\u5177”<\/td>\u6267\u884c \u2192 \u7ed3\u679c\u5582\u56de\u53bb \u2192 \u7ee7\u7eed<\/td><\/tr>
stop_reason != \"tool_use\"<\/code><\/td>\u6a21\u578b\u8bf4”\u6211\u505a\u5b8c\u4e86”<\/td>\u9000\u51fa\u5faa\u73af<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

\u5de5\u4f5c\u539f\u7406<\/h2>\n\n\n\n

\u7b2c\u4e00\u6b65\uff1a\u628a\u7528\u6237\u7684\u95ee\u9898\u4f5c\u4e3a\u7b2c\u4e00\u6761\u6d88\u606f<\/strong><\/p>\n\n\n\n

message = [{\"role\":\"user\",\"content\": query}]<\/code><\/pre>\n\n\n\n
\u7b2c\u4e8c\u6b65\uff1a\u5c06\u6d88\u606f\u548c\u5de5\u5177\u5b9a\u4e49\u4e00\u8d77\u53d1\u7ed9LLM<\/strong><\/p>\n\n\n\n
response = client.messages.create(\n    model=MODEL, system=SYSTEM , message=messages,\n    tools=TOOLS, max_tokens=8000,\n)<\/code><\/pre>\n\n\n\n
\u7b2c\u4e09\u6b65\uff1a\u8ffd\u52a0\u6a21\u578b\u56de\u7b54\uff0c\u68c0\u67e5\u5b83\u662f\u5426\u8c03\u7528\u4e86\u5de5\u5177\u3002\u6ca1\u6709\u8c03\u7528\u5c31\u7ed3\u675f<\/strong><\/p>\n\n\n\n
messages.append({\"role\":\"assistant\",\"content\":response.content})\nif response.stop_reason != \"tool_use\":\n    return<\/code><\/pre>\n\n\n\n
\u7b2c\u56db\u6b65\uff1a\u6267\u884c\u6a21\u578b\u8981\u6c42\u7684\u5de5\u5177\uff0c\u6536\u96c6\u7ed3\u679c<\/strong><\/p>\n\n\n\n
results = []\nfor block in response.content:\n    if block.type == \"tool_use\":\n        output = run_bash(block.input[\"command\"])\n        results.append({\n            \"type\": \"tool_result\",\n            \"tool_use_id\": block.id,\n            \"content\": output,\n        })<\/code><\/pre>\n\n\n\n
\u7b2c\u4e94\u6b65\uff1a\u628a\u5de5\u5177\u7ed3\u679c\u4f5c\u4e3a\u65b0\u6d88\u606f\u8ffd\u52a0\u56de\u5230\u7b2c\u4e8c\u6b65\u5f00\u59cb\u5faa\u73af<\/strong><\/p>\n\n\n\n
messages.append({\"role\": \"user\", \"content\": results})<\/code><\/pre>\n\n\n\n
\u7ec4\u6210\u4e00\u4e2a\u5b8c\u6210\u51fd\u6570\uff1a<\/p>\n\n\n\n
def agent_loop(messages):\n    while True:\n        response = client.messages.create(\n            model=MODEL, system=SYSTEM, messages=messages,\n            tools=TOOLS, max_tokens=8000,\n        )\n        messages.append({\"role\":\"assistant\",\"content\": response.content})\n\n        if response.stop_reason != \"tool_use\":\n            return False\n        results = []\n        for block in response.content:\n            if block.type == \"tool_use\":\n                output = run_bash(block.input[\"command\"])\n                results.append({\n                    \"type\":\"tool_result\",\n                    \"tool_use_id\":block.id,\n                    \"content\":output,\n                })\n        messages.append({\"role\":\"user\",\"content\": results})\n<\/code><\/pre>\n\n\n\n
\u4e0d\u523030\u884c\uff0c\u8fd9\u5c31\u662f\u6700\u5c0f\u53ef\u8fd0\u884c\u7684agent harness\u5185\u6838\u3002\u5b83\u4e0d\u662f\u667a\u80fd\u4f53\u672c\u8eab\uff0c\u800c\u662f\u8ba9\u6a21\u578b\u80fd\u6301\u7eed\u884c\u52a8\u7684\u6700\u5c0f\u8fd0\u884c\u6846\u67b6\uff0c\u6a21\u578b\u8d1f\u8d23\u51b3\u7b56\uff0charness\u8d1f\u8d23\u6267\u884c\u3002<\/p>\n\n\n\n
\"\"<\/div><\/figure>\n\n\n\n
Tool Use<\/h2>\n\n\n\n
\u524d\u9762\u5b8c\u6210\u4e86Agent loop\uff0c\u8fd9\u4e2aAgent\u4e2d\u53ea\u6709\u4e00\u4e2abash\u5de5\u5177\u3002\u8fd9\u4e2a\u65f6\u5019\u5982\u679c\u8981\u8bfb\u53d6\u4e00\u4e2a\u6587\u4ef6\/path\/to\/file<\/p>\n\n\n\n
\u5982\u679c\u6709\u4e13\u95e8\u8bfb\u53d6\u5de5\u5177\u5c31\u53ef\u4ee5\u76f4\u63a5\u751f\u6210<\/p>\n\n\n\n
{\n  \"name\": \"read_file\",\n  \"input\": {\n    \"path\": \"\/path\/to\/file\"\n  }\n}<\/code><\/pre>\n\n\n\n
\u53ea\u6709Bash\u5de5\u5177\u65f6\uff0c\u5219\u8981\u8f6c\u6362\u6210<\/p>\n\n\n\n
{\n  \"name\": \"bash\",\n  \"input\": {\n    \"command\": \"cat \/path\/to\/file\"\n  }\n}<\/code><\/pre>\n\n\n\n
\u5f88\u660e\u663e\u7684\u5982\u679c\u6709\u4e13\u7528\u7684read_file\u5de5\u5177\uff0c\u6a21\u578b\u601d\u8003\u548c\u751f\u6210shell\u547d\u4ee4\u6240\u9700\u7684token\u5c31\u4f1a\u660e\u663e\u51cf\u5c11\u4e5f\u80fd\u591f\u907f\u514d\u6a21\u578b\u9009\u62e9cat\u3001head\u7b49\u547d\u4ee4\u7684\u8ba4\u77e5\u8d1f\u62c5\u3002\u4e3e\u4e2a\u4f8b\u5b50\uff0c\u8fd9\u91cc\u7528\u6237\u8ba9\u8bfb\u53d610w\u4e2a\u6587\u4ef6\uff0c\u90a3\u4e48\u7eafbash\u5de5\u5177\u76f8\u6bd4\u6709read_file+bash\u5de5\u5177\u7684Agent\u5c31\u4f1a\u591a\u6d88\u8017\u5927\u91cf\u7684token\u3002\u540c\u65f6\u6709read_file\u5de5\u5177\u8fd8\u80fd\u591f\u907f\u514d\u8def\u5f84\u5f15\u7528\u3001\u7a7a\u683c\u548c\u7279\u6b8a\u5b57\u7b26\u7684\u8f6c\u4e49\u9519\u8bef\u3002<\/p>\n\n\n\n
\"Tool<\/div><\/figure>\n\n\n\n
\u5bf9\u6bd4\u524d\u9762\u7684Agent\u552f\u4e00\u7684\u53d8\u52a8\u5728\u5de5\u5177\u6267\u884c\uff0crun_bash()\u66ff\u6362\u4e3aTOOL_HANDLERS[block.name]()\u67e5\u8868\u5206\u53d1\u3002<\/p>\n\n\n\n
\u7ed9Agent\u52a0\u4e00\u4e2a\u5de5\u5177\u53ea\u9700\u8981\u505a\u4e24\u4ef6\u4e8b\uff1a<\/strong>
1.\u5b9a\u4e49\u5de5\u5177\uff1a\u5728TOOLS\u6570\u7ec4\u91cc\u52a0\u4e00\u6761\u63cf\u8ff0<\/strong>
2.\u6ce8\u518c\u5904\u7406\u51fd\u6570\uff1a\u5728TOOL_HANDLERS\u5b57\u5178\u91cc\u52a0\u4e00\u4e2a\u6620\u5c04<\/strong><\/p>\n\n\n\n
\u4ece\u4e00\u4e2a\u5de5\u5177\u5230\u4e94\u4e2a\u5de5\u5177<\/p>\n\n\n\n
\u524d\u9762\u53ea\u6709\u4e00\u4e2a\u5de5\u5177bash<\/p>\n\n\n\n
TOOLS = [{\"name\":\"bash\",...}]\ndef run_bash(command):...<\/code><\/pre>\n\n\n\n
\u73b0\u5728\u8ffd\u52a0\u5230\u4e94\u4e2a\u5de5\u5177\uff0c\u6bcf\u4e2a\u5de5\u5177\u90fd\u662f\u72ec\u7acb\u5b9a\u4e49<\/p>\n\n\n\n
TOOLS = [\n    {\"name\": \"bash\",       \"description\": \"Run a shell command.\", ...},\n    {\"name\": \"read_file\",  \"description\": \"Read file contents.\",  ...},\n    {\"name\": \"write_file\", \"description\": \"Write content to file.\", ...},\n    {\"name\": \"edit_file\",  \"description\": \"Replace text in file once.\", ...},\n    {\"name\": \"glob\",       \"description\": \"Find files by pattern.\", ...},\n]<\/code><\/pre>\n\n\n\n
\u6bcf\u4e2a\u5de5\u5177\u90fd\u6709\u81ea\u5df1\u7684\u5b9e\u73b0\u51fd\u6570<\/p>\n\n\n\n
def run_read(path, limit=None):\n    lines = safe_path(path).read_text().splitlines()\n    if limit:\n        lines = lines[:limit]\n    return \"\\n\".join(lines)\n\ndef run_write(path, content):\n    safe_path(path).write_text(content)\n    return f\"Wrote {len(content)} bytes to {path}\"\n\ndef run_edit(path, old_text, new_text):\n    text = safe_path(path).read_text()\n    if old_text not in text:\n        return \"Error: text not found\"\n    safe_path(path).write_text(text.replace(old_text, new_text, 1))\n    return f\"Edited {path}\"\n\ndef run_glob(pattern):\n    import glob as g\n    return \"\\n\".join(g.glob(pattern, root_dir=WORKDIR))<\/code><\/pre>\n\n\n\n
\u5de5\u5177\u5206\u53d1<\/p>\n\n\n\n
TOOL_HANDLERS = {\n    \"bash\":       run_bash,\n    \"read_file\":  run_read,\n    \"write_file\": run_write,\n    \"edit_file\":  run_edit,\n    \"glob\":       run_glob,\n}\n\n# \u5faa\u73af\u91cc\u53ea\u6539\u4e86\u4e00\u884c\u2014\u2014\u4ece\u786c\u7f16\u7801 run_bash \u53d8\u6210\u67e5\u8868\uff1a\nfor block in response.content:\n    if block.type == \"tool_use\":\n        handler = TOOL_HANDLERS[block.name]    # \u67e5\u8868\n        output = handler(**block.input)         # \u8c03\u7528\n        results.append(...)<\/code><\/pre>\n\n\n\n
\u52a0\u4e00\u4e2a\u5de5\u5177 = \u5728TOOLS\u6570\u7ec4\u52a0\u4e00\u6761 + \u5728TOOL_HANDLERS\u5b57\u5178\u52a0\u4e00\u884c\u3002\u5faa\u73af\u4e0d\u53d8<\/strong><\/p>\n\n\n\n
\"\"<\/div><\/figure>\n\n\n\n
\u6267\u884c\u524d\u505a\u6743\u9650\u5224\u65ad<\/h1>\n\n\n\n
\u524d\u9762\u7684Agent\u6709\u4e94\u4e2a\u5de5\u5177\u3002file tools\u53d7safe_path\u4fdd\u62a4\uff0c\u4f46bash\u4e0d\u53d7\u9650\u5236\u3002\u8ba9\u5b83\u6e05\u7406\u4e00\u4e0b\u9879\u76ee\uff0c\u53ef\u80fd\u4f1a\u6267\u884crm -rf \/\uff0c\u5b89\u5168\u4e0d\u80fd\u9760\u4fe1\u4efb\u6a21\u578b\uff0c\u8981\u9760\u4ee3\u7801-\u5728\u5de5\u5177\u6267\u884c\u4e4b\u524d\u505a\u5224\u65ad\u3002<\/p>\n\n\n\n
\"Permission<\/div><\/figure>\n\n\n\n
\u6838\u5fc3\u903b\u8f91\u5b8c\u6574\u4fdd\u7559\uff0c\u552f\u4e00\u7684\u53d8\u52a8\u5728\u5de5\u5177\u6267\u884c\u524d\u63d2\u5165check_permission()\u6bcf\u4e2a\u5de5\u5177\u8c03\u7528\u7ecf\u8fc7\u4e09\u9053\u95f8\u95e8\uff0c\u987a\u5e8f\u56fa\u5b9a\uff1a\u786c\u62d2\u7edd\u4f18\u5148\uff0c\u8f6f\u8be2\u95ee\u6b21\u4e4b\uff0c\u90fd\u6ca1\u547d\u4e2d\u5c31\u653e\u884c\u3002<\/p>\n\n\n\n
\u4e09\u9053\u95f8\u95e8\u5bf9\u5e94\u4e09\u79cd\u7b56\u7565<\/p>\n\n\n\n
\u95f8\u95e8<\/th>\u4f5c\u7528<\/th>\u547d\u4e2d\u540e<\/th><\/tr><\/thead>
1. \u62d2\u7edd\u5217\u8868<\/td>\u6c38\u8fdc\u7981\u6b62\u7684\u64cd\u4f5c\uff08rm -rf \/<\/code>\u3001sudo<\/code>\uff09<\/td>\u76f4\u63a5\u62d2\u7edd\uff0c\u4e0d\u6267\u884c<\/td><\/tr>
2. \u89c4\u5219\u5339\u914d<\/td>\u53d6\u51b3\u4e8e\u4e0a\u4e0b\u6587\u7684\u64cd\u4f5c\uff08\u8bfb\/\u5199\u5de5\u4f5c\u533a\u5916\u3001rm<\/code> \u6587\u4ef6\uff09<\/td>\u4ea4\u7ed9\u95f8\u95e8 3<\/td><\/tr>
3. \u7528\u6237\u5ba1\u6279<\/td>\u95f8\u95e8 2 \u547d\u4e2d\u540e\uff0c\u6682\u505c\u7b49\u7528\u6237\u786e\u8ba4<\/td>\u7528\u6237\u51b3\u5b9a\u5141\u8bb8\u6216\u62d2\u7edd<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\u4e09\u9053\u90fd\u6ca1\u547d\u4e2d\u5c31\u76f4\u63a5\u6267\u884c<\/p>\n\n\n\n
\"Permission<\/div><\/figure>\n\n\n\n
\u95f8\u95e81\uff1a<\/strong>\u4e00\u5f20\u786c\u62d2\u7edd\u8868\uff0c\u5148\u67e5\uff0c\u547d\u4e2d\u5c31\u8fd4\u56de\u963b\u6b62\u4fe1\u606f<\/p>\n\n\n\n
DENY_LIST = [\n    \"rm -rf \/\", \"sudo\", \"shutdown\", \"reboot\",\n    \"mkfs\", \"dd if=\", \"> \/dev\/sda\",\n]\n\ndef check_deny_list(command: str) -> str | None:\n    for pattern in DENY_LIST:\n        if pattern in command:\n            return f\"Blocked: '{pattern}' is on the deny list\"\n    return None<\/code><\/pre>\n\n\n\n
\u95f8\u95e82\uff1a<\/strong>\u89c4\u5219\u5339\u914d\uff0c\u63cf\u8ff0\u4ec0\u4e48\u65f6\u5019\u9700\u8981\u95ee\u7528\u6237\u3002\u6bcf\u6761\u89c4\u5219\u6307\u5b9a\u5de5\u5177\u548c\u68c0\u67e5\u6761\u4ef6<\/p>\n\n\n\n
PERMISSION_RULES = [\n    {\n        \"tools\": [\"read_file\", \"write_file\", \"edit_file\"],\n        \"check\": lambda args: not (WORKDIR \/ args.get(\"path\", \"\")).resolve().is_relative_to(WORKDIR),\n        \"message\": \"Access outside workspace\",\n    },\n    {\n        \"tools\": [\"bash\"],\n        \"check\": lambda args: any(kw in args.get(\"command\", \"\") for kw in [\"rm \", \"> \/etc\/\", \"chmod 777\"]),\n        \"message\": \"Potentially destructive command\",\n    },\n]\n\ndef check_rules(tool_name: str, args: dict) -> str | None:\n    for rule in PERMISSION_RULES:\n        if tool_name in rule[\"tools\"] and rule[\"check\"](args):\n            return rule[\"message\"]\n    return None<\/code><\/pre>\n\n\n\n
\u95f8\u95e83\uff1a<\/strong>\u89c4\u5219\u547d\u4e2d\u540e\uff0c\u6682\u505c\u7b49\u7528\u6237\u8f93\u5165<\/p>\n\n\n\n
def ask_user(tool_name: str, args: dict, reason: str) -> str:\n    print(f\"\\n\u26a0  {reason}\")\n    print(f\"   Tool: {tool_name}({args})\")\n    choice = input(\"   Allow? [y\/N] \").strip().lower()\n    return \"allow\" if choice in (\"y\", \"yes\") else \"deny\"<\/code><\/pre>\n\n\n\n
\u4e09\u4e2a\u95f8\u95e8\u4e32\u5728\u4e00\u8d77\uff0c\u63d2\u5728\u5de5\u5177\u6267\u884c\u4e4b\u524d<\/p>\n\n\n\n
def check_permission(block) -> bool:\n    # \u95f8\u95e8 1: \u786c\u62d2\u7edd\n    if block.name == \"bash\":\n        reason = check_deny_list(block.input.get(\"command\", \"\"))\n        if reason:\n            print(f\"\\n\u26d4 {reason}\")\n            return False\n\n    # \u95f8\u95e8 2 + 3: \u89c4\u5219\u5339\u914d \u2192 \u7528\u6237\u5ba1\u6279\n    reason = check_rules(block.name, block.input)\n    if reason:\n        decision = ask_user(block.name, block.input, reason)\n        if decision == \"deny\":\n            return False\n\n    return True\n\n# \u5728 agent_loop \u4e2d\u2014\u2014s02 \u7684\u5faa\u73af\u53ea\u52a0\u4e86\u4e00\u884c\uff1a\nfor block in response.content:\n    if block.type == \"tool_use\":\n        if not check_permission(block):           # \u2190 \u65b0\u589e\n            results.append({... \"content\": \"Permission denied.\"})\n            continue\n        output = TOOL_HANDLERS[block.name](**block.input)  # s02 \u539f\u6709\n        results.append(...)<\/code><\/pre>\n\n\n\n
\u8fd9\u91cc\u5220\u9664\u6210\u529f\u662f\u56e0\u4e3a\u73af\u5883\u95ee\u9898\u6e90\u7801\u4e2d\u5199\u7684\u662fbash + rm\u800cWindows\u4e0b\u7684\u5220\u9664\u5e94\u8be5\u662f\u5bf9\u5e94Remove-Item test.txt   <\/p>\n\n\n\n
\"\"<\/div><\/figure>\n\n\n\n
\u6269\u5c55\u68c0\u67e5<\/h1>\n\n\n\n
\u524d\u9762\u5df2\u7ecf\u6dfb\u52a0\u4e86\u6743\u9650\u7684\u68c0\u67e5\u3002\u4f46\u662f\u6bcf\u6b21\u52a0\u4e00\u4e2a\u65b0\u7684\u68c0\u67e5\uff0c\u90fd\u8981\u4fee\u6539agent_loop\u51fd\u6570\uff0c\u5c31\u4f1a\u5bfc\u81f4\u5faa\u73af\u5185\u90e8\u6324\u538b<\/p>\n\n\n\n
def agent_loop(messages):\n    while True:\n        # ... LLM call ...\n        for block in response.content:\n            if block.type != \"tool_use\":\n                continue\n            log_to_file(block)          # \u52a0\u4e00\u884c\n            check_permission(block)     # \u52a0\u4e00\u884c\n            notify_slack(block)         # \u53c8\u52a0\u4e00\u884c\n            output = execute(block)\n            auto_git_add(block)         # \u518d\u52a0\u4e00\u884c\n            # ... \u5f88\u5feb\u5faa\u73af\u5c31\u8ba4\u4e0d\u51fa\u6765\u4e86<\/code><\/pre>\n\n\n\n
\u60f3\u8981\u6269\u5c55\u7684\u662fAgent\u7684\u884c\u4e3a\uff0c\u4f46\u662f\u5374\u6539\u4e86\u5faa\u73af\u672c\u8eab\uff0c\u5faa\u73af\u5e94\u8be5\u662f\u4e00\u4e2a\u7a33\u5b9a\u7684\u6838\u5fc3\uff0c\u6269\u5c55\u5e94\u8be5\u6302\u5728\u5916\u9762<\/p>\n\n\n\n
\u201c\u6302\u5728\u5faa\u73af\u4e0a\uff0c\u4e0d\u5199\u8fdb\u5faa\u73af\u91cc\u201dhook\u5728\u5de5\u5177\u6267\u884c\u524d\u540e\u6ce8\u5165\u6269\u5c55\u903b\u8f91<\/strong><\/p>\n\n\n\n
\"Hooks<\/div><\/figure>\n\n\n\n
\u4e4b\u524d\u7684\u5faa\u73af\u903b\u8f91\u5b8c\u5168\u4fdd\u7559\u3002\u552f\u4e00\u7684\u53d8\u52a8\u662f\u628acheck_permission()\u4ece\u5faa\u73af\u4f53\u5185\u8f6c\u79fb\u5230\u4e86hook\u4e0a \uff0c\u5faa\u73af\u4e0d\u518d\u76f4\u63a5\u8c03\u7528\u4efb\u4f55\u68c0\u67e5\u51fd\u6570\uff0c\u6539\u4e3atrigger_hooks(“PreToolUse”,block)\uff0c\u7531\u6ce8\u518c\u8868\u51b3\u5b9a\u8dd1\u4ec0\u4e48<\/p>\n\n\n\n
\u56db\u4e2a\u4e8b\u4ef6\u8986\u76d6\u4e00\u4e2a\u5b8c\u6574\u7684agent cycle<\/p>\n\n\n\n
\u4e8b\u4ef6<\/th>\u89e6\u53d1\u65f6\u673a<\/th>\u5178\u578b\u7528\u9014<\/th><\/tr><\/thead>
UserPromptSubmit<\/td>\u7528\u6237\u8f93\u5165\u63d0\u4ea4\u540e\u3001\u8fdb\u5165 LLM \u524d<\/td>\u8f93\u5165\u9a8c\u8bc1\u3001\u6ce8\u5165\u4e0a\u4e0b\u6587<\/td><\/tr>
PreToolUse<\/td>\u5de5\u5177\u6267\u884c\u524d<\/td>\u6743\u9650\u68c0\u67e5\u3001\u65e5\u5fd7\u8bb0\u5f55<\/td><\/tr>
PostToolUse<\/td>\u5de5\u5177\u6267\u884c\u540e<\/td>\u526f\u4f5c\u7528\uff08\u81ea\u52a8 git add \u7b49\uff09\u3001\u8f93\u51fa\u68c0\u67e5<\/td><\/tr>
Stop<\/td>\u5faa\u73af\u5373\u5c06\u9000\u51fa\u65f6<\/td>\u6536\u5c3e\u6e05\u7406\uff08CC \u8fd8\u652f\u6301\u5f3a\u5236\u7eed\u8dd1\uff09<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\u6269\u5c55\u901a\u8fc7register_hook()\u6dfb\u52a0\uff0c\u5faa\u73af\u53ea\u8c03\u7528trigger_hooks()<\/p>\n\n\n\n
hook\u6ce8\u518c\u8868\uff1a\u4e00\u4e2a\u5b57\u5178\uff0c\u4e8b\u4ef6\u540d\u6620\u5c04\u5230\u56de\u8c03\u5217\u8868<\/p>\n\n\n\n
HOOKS = {\n    \"UserPromptSubmit\": [],\n    \"PreToolUse\": [],\n    \"PostToolUse\": [],\n    \"Stop\": [],\n}\n\ndef register_hook(event: str, callback):\n    HOOKS[event].append(callback)\n\ndef trigger_hooks(event: str, *args):\n    for callback in HOOKS[event]:\n        result = callback(*args)\n        if result is not None:   # \u8fd4\u56de\u503c \u2260 None \u2192 hook \u8bf4\"\u505c\"\n            return result\n    return None<\/code><\/pre>\n\n\n\n
PreToolUse\u7684\u975eNone\u8fd4\u56de\u503c\u4f1a\u963b\u6b62\u672c\u6b21\u5de5\u5177\u6267\u884c\uff0cStop\u7684\u975eNone\u8fd4\u56de\u503c\u4f1a\u5f3a\u5236\u7ee7\u7eed\u8dd1\u3002UserPromptSubmit\u548cPostToolUse\u7684\u8fd4\u56de\u503c\u672a\u88ab\u4f7f\u7528<\/p>\n\n\n\n
UserPromptSubmit\uff0c\u7528\u6237\u8f93\u5165\u63d0\u4ea4\u540e\u3001\u8fdb\u5165LLM\u524d\u89e6\u53d1<\/p>\n\n\n\n
def context_inject_hook(query: str) -> str | None:\n    \"\"\"Inject current working directory info into every prompt.\"\"\"\n    print(f\"\\033[90m[HOOK] UserPromptSubmit: working in {WORKDIR}\\033[0m\")\n    return None   # return None = no modification, let prompt through\n\nregister_hook(\"UserPromptSubmit\", context_inject_hook)<\/code><\/pre>\n\n\n\n
\u5728\u4e3b\u5faa\u73af\u4e2d\uff0c\u7528\u6237\u8f93\u5165\u540e\u7acb\u5373\u89e6\u53d1<\/p>\n\n\n\n
query = input(\"s04 >> \")\ntrigger_hooks(\"UserPromptSubmit\", query)   # \u2190 \u8fdb\u5165 LLM \u4e4b\u524d\nhistory.append({\"role\": \"user\", \"content\": query})\nagent_loop(history)<\/code><\/pre>\n\n\n\n
PreToolUse\/PostToolUse\uff0c\u5de5\u5177\u6267\u884c\u524d\u540e\u7684hook\u3002\u5c06\u524d\u9762\u7684\u6743\u9650\u68c0\u67e5\u903b\u8f91\u73b0\u5728\u5305\u88c5\u6210PreToolUse hook\uff0c\u518d\u52a0\u4e00\u4e2a\u65e5\u5fd7hook\u548c\u4e00\u4e2a\u8f93\u51fa\u63d0\u9192<\/p>\n\n\n\n
# PreToolUse: \u6743\u9650\u68c0\u67e5\uff08s03 \u7684\u903b\u8f91\uff0c\u4ece\u5faa\u73af\u79fb\u5230 hook\uff09\ndef permission_hook(block):\n    if block.name == \"bash\":\n        for pattern in DENY_LIST:\n            if pattern in block.input.get(\"command\", \"\"):\n                return \"Permission denied by deny list\"\n    if block.name in (\"read_file\", \"write_file\", \"edit_file\"):\n        path = block.input.get(\"path\", \"\")\n        if not (WORKDIR \/ path).resolve().is_relative_to(WORKDIR):\n            choice = input(\"   Allow? [y\/N] \").strip().lower()\n            if choice not in (\"y\", \"yes\"):\n                return \"Permission denied by user\"\n    return None\n\n# PreToolUse: \u65e5\u5fd7\ndef log_hook(block):\n    print(f\"[HOOK] {block.name}(...)\")\n\n# PostToolUse: \u5927\u6587\u4ef6\u63d0\u9192\ndef large_output_hook(block, output):\n    if len(str(output)) > 100000:\n        print(f\"[HOOK] \u26a0 Large output from {block.name}\")\n\nregister_hook(\"PreToolUse\", permission_hook)\nregister_hook(\"PreToolUse\", log_hook)\nregister_hook(\"PostToolUse\", large_output_hook)<\/code><\/pre>\n\n\n\n
stop\uff0c\u5faa\u73af\u5373\u5c06\u9000\u51fa\u65f6\u89e6\u53d1\uff08stop_reason != “tool_use”\uff09<\/p>\n\n\n\n
def summary_hook(messages: list) -> str | None:\n    \"\"\"Print a summary when the loop is about to stop.\"\"\"\n    tool_count = sum(1 for m in messages\n                     for b in (m.get(\"content\") if isinstance(m.get(\"content\"), list) else [])\n                     if isinstance(b, dict) and b.get(\"type\") == \"tool_result\")\n    print(f\"\\033[90m[HOOK] Stop: session used {tool_count} tool calls\\033[0m\")\n    return None   # return None = allow stop, return string = force continuation\n\nregister_hook(\"Stop\", summary_hook)<\/code><\/pre>\n\n\n\n
\u5728agent_loop\u4e2d\u9000\u51fa\u524d\u89e6\u53d1<\/p>\n\n\n\n
if response.stop_reason != \"tool_use\":\n    force = trigger_hooks(\"Stop\", messages)   # \u2190 \u9000\u51fa\u4e4b\u524d\n    if force:\n        # hook returned a message \u2192 inject it and continue\n        messages.append({\"role\": \"user\", \"content\": force})\n        continue\n    return<\/code><\/pre>\n\n\n\n
\u5faa\u73af\u91cc\u53ea\u6539\u4e86\u4e00\u5904\uff0c\u4ece\u76f4\u63a5\u8c03\u7528check_permission(block)\u6539\u4e3atrigger_hooks(“PreToolUse”,block)\uff1a<\/p>\n\n\n\n
for block in response.content:\n    if block.type != \"tool_use\":\n        continue\n\n    # s03: if not check_permission(block): ...\n    # s04: hook \u66ff\u4ee3\u786c\u7f16\u7801\n    blocked = trigger_hooks(\"PreToolUse\", block)\n    if blocked:\n        results.append({\"type\": \"tool_result\", \"tool_use_id\": block.id,\n                        \"content\": str(blocked)})\n        continue\n\n    handler = TOOL_HANDLERS.get(block.name)\n    output = handler(**block.input) if handler else f\"Unknown: {block.name}\"\n\n    trigger_hooks(\"PostToolUse\", block, output)\n\n    results.append({\"type\": \"tool_result\", \"tool_use_id\": block.id,\n                    \"content\": output})<\/code><\/pre>\n\n\n\n
\u56db\u4e2ahook\u8986\u76d6\u4e86agent cycle\u7684\u5173\u952e\u8282\u70b9\uff1a\u8f93\u5165 –> \u6267\u884c\u524d –> \u6267\u884c\u540e –> \u9000\u51fa\u3002\u5faa\u73af\u53ea\u8d1f\u8d23\u8c03\u7528trigger_hooks()\uff0c\u5177\u4f53\u903b\u8f91\u5168\u5728hook\u56de\u8c03\u91cc\u3002<\/p>\n\n\n\n
Agent Loop \u662f\u667a\u80fd\u4f53\u7684\u6838\u5fc3\u6267\u884c\u9aa8\u67b6\uff0c\u8d1f\u8d23\u7ef4\u6301\u201c\u6a21\u578b\u51b3\u7b56\u2014\u5de5\u5177\u6267\u884c\u2014\u7ed3\u679c\u53cd\u9988\u201d\u7684\u57fa\u672c\u6d41\u7a0b\uff0c\u56e0\u6b64\u4e0d\u5e94\u56e0\u9644\u52a0\u529f\u80fd\u800c\u9891\u7e41\u4fee\u6539\u3002\u6743\u9650\u63a7\u5236\u3001\u65e5\u5fd7\u3001\u76d1\u63a7\u3001\u7f13\u5b58\u7b49\u6269\u5c55\u80fd\u529b\uff0c\u5e94\u901a\u8fc7 Hook\u3001Middleware \u6216\u63d2\u4ef6\u63a5\u53e3\u4ee5\u53ef\u63d2\u62d4\u65b9\u5f0f\u63a5\u5165\uff0c\u4ece\u800c\u964d\u4f4e\u8026\u5408\uff0c\u5e76\u4fdd\u8bc1\u6838\u5fc3\u5faa\u73af\u7684\u7a33\u5b9a\u6027\u3002<\/strong><\/p>\n\n\n\n
\"\"<\/div><\/figure>\n\n\n\n
TodoWrite<\/h1>\n\n\n\n
\u7ed9Agent\u4e00\u4e2a\u590d\u6742\u4efb\u52a1\uff1a”\u628a\u6240\u6709Python\u6587\u4ef6\u6539\u6210snake_case\u547d\u540d\uff0c\u7136\u540e\u8dd1\u6d4b\u8bd5\uff0c\u4fee\u597d\u5931\u8d25”\u3002Agent\u5f00\u59cb\u5e72\u6d3b\uff0c\u6539\u4e863\u4e2a\u6587\u4ef6\uff0c\u8dd1\u4e86\u4e2a\u6d4b\u8bd5\uff0c\u53d1\u73b02\u4e2a\u5931\u8d25\uff0c\u5f00\u59cb\u4fee\u3002\u4fee\u7740\u4fee\u7740\u5c31\u5fd8\u4e86\u6700\u521d\u662f”\u6539\u6210snake_case”\uff0c\u6d4b\u8bd5\u5931\u8d25\u628a\u6ce8\u610f\u529b\u5168\u5438\u8d70\u4e86\u3002\u5bf9\u8bdd\u8d8a\u957f\u8d8a\u4e25\u91cd\uff1a\u5de5\u5177\u7ed3\u679c\u4e0d\u65ad\u586b\u6ee1\u4e0a\u4e0b\u6587\uff0c\u7cfb\u7edf\u63d0\u793a\u7684\u5f71\u54cd\u529b\u88ab\u7a00\u91ca\u3002\u4e00\u4e2a10\u6b65\u91cd\u6784\uff0c\u505a\u5b8c1-3\u6b65\u5c31\u5f00\u59cb\u5373\u5174\u53d1\u6325\uff0c\u56e0\u4e3a4-10\u6b65\u5df2\u7ecf\u88ab\u6324\u51fa\u6ce8\u610f\u529b\u4e86\u3002<\/p>\n\n\n\n
\"Todo<\/div><\/figure>\n\n\n\n
\u4fdd\u7559\u4e0a\u4e00\u7ae0\u7684\u6700\u5c0fhook\u7ed3\u6784\uff0c\u91cd\u70b9\u770b\u65b0\u589e\u7684todo_write\u5de5\u5177\u548creminder\u673a\u5236\u3002todo_write\u672c\u8eab\u4e0d\u505a\u4efb\u4f55\u5b9e\u9645\u5de5\u4f5c\uff0c\u4e0d\u80fd\u8bfb\u6587\u4ef6\u3001\u4e0d\u80fd\u8dd1\u547d\u4ee4\uff0c\u53ea\u662f\u8ba9Agent\u5728\u52a8\u624b\u4e4b\u524d\u5148\u7406\u6e05\u601d\u8def\u3002<\/p>\n\n\n\n
dispatch\u673a\u5236\uff08\u5de5\u5177\u8c03\u7528\u7684\u5206\u53d1\u673a\u5236\uff09\u4e0d\u53d8\uff0c\u65b0\u5de5\u5177\u4ecd\u7136\u8d70TOOL_HANDLERS[block.name]\u5206\u53d1\u3002\u4e3a\u4e86\u6f14\u793atodo reminder\uff0c\u5faa\u73af\u91cc\u52a0\u4e86\u4e00\u4e2a\u8ba1\u6570\u5668\uff1a\u8fde\u7eed3\u8f6e\u6ca1\u8c03todo_write\u5c31\u6ce8\u5165\u4e00\u6761\u63d0\u9192<\/p>\n\n\n\n
todo_write\u5de5\u5177\uff0c\u63a5\u6536\u4e00\u4e2a\u5e26\u72b6\u6001\u7684\u5217\u8868\uff0c\u4fdd\u5b58\u5728\u5f53\u524d\u8fdb\u7a0b\u5185\u5b58\u4e2d\uff0c\u540c\u65f6\u5728\u7ec8\u7aef\u663e\u793a\u8fdb\u5ea6<\/p>\n\n\n\n
CURRENT_TODOS: list[dict] = []\n\ndef run_todo_write(todos: list) -> str:\n    global CURRENT_TODOS\n    CURRENT_TODOS = todos\n\n    lines = [\"\\n## Current Tasks\"]\n    for t in CURRENT_TODOS:\n        icon = {\"pending\": \" \", \"in_progress\": \"\u25b8\", \"completed\": \"\u2713\"}[t[\"status\"]]\n        lines.append(f\"  [{icon}] {t['content']}\")\n    print(\"\\n\".join(lines))\n    return f\"Updated {len(CURRENT_TODOS)} tasks\"<\/code><\/pre>\n\n\n\n
\u5de5\u5177\u5b9a\u4e49\u548c\u5176\u4ed65\u4e2a\u5de5\u5177\u4e00\u8d77\u52a0\u5165dispatch map<\/p>\n\n\n\n
TOOLS = [\n    {\"name\": \"bash\",       ...},\n    {\"name\": \"read_file\",  ...},\n    {\"name\": \"write_file\", ...},\n    {\"name\": \"edit_file\",  ...},\n    {\"name\": \"glob\",       ...},\n    # s05: \u65b0\u589e\u4e00\u6761\n    {\"name\": \"todo_write\", \"description\": \"Create and manage a task list ...\",\n     \"input_schema\": {\n         \"type\": \"object\",\n         \"properties\": {\n             \"todos\": {\n                 \"type\": \"array\",\n                 \"items\": {\n                     \"type\": \"object\",\n                     \"properties\": {\n                         \"content\": {\"type\": \"string\"},\n                         \"status\": {\"type\": \"string\", \"enum\": [\"pending\", \"in_progress\", \"completed\"]},\n                     },\n                 },\n             },\n         },\n     },\n    },\n]\n\nTOOL_HANDLERS[\"todo_write\"] = run_todo_write<\/code><\/pre>\n\n\n\n
Nag reminder\uff0c\u6a21\u578b\u8fde\u7eed3\u8f6e\u6ca1\u8c03todo_write\u65f6\uff0c\u81ea\u52a8\u6ce8\u5165\u4e00\u6761\u63d0\u9192<\/p>\n\n\n\n
if rounds_since_todo >= 3 and messages:\n    messages.append({\n        \"role\": \"user\",\n        \"content\": \"<reminder>Update your todos.<\/reminder>\",\n    })\n    rounds_since_todo = 0<\/code><\/pre>\n\n\n\n
Agent\u6536\u5230\u4efb\u52a1\u540e\u7684\u5178\u578b\u6d41\u7a0b\uff1a\u5148\u8c03todo_write\u5217\u51fa\u6240\u6709\u6b65\u9aa4 -> \u505a\u4e00\u4e2a\u6b65\u9aa4\uff0c\u6539\u6210in_progress -> \u505a\u5b8c\u6539\u6210completed -> \u770b\u4e0b\u4e00\u4e2apending -> \u7ee7\u7eed\u3002\u8fde\u7eed3\u8f6e\u6ca1\u6709\u8c03\u7528todo_write\u65f6\uff0c\u5faa\u73af\u4f1a\u5728\u4e0b\u4e00\u6b21LLM\u8c03\u7528\u524d\u8ffd\u52a0\u4e00\u6761reminder\u3002<\/p>\n\n\n\n
todo_write\u4e0d\u7ed9Agent\u589e\u52a0\u4efb\u4f55\u6267\u884c\u80fd\u529b\uff0c\u5b83\u589e\u52a0\u7684\u65f6\u89c4\u5212\u80fd\u529b<\/strong><\/p>\n\n\n\n
\"\"<\/div><\/figure>\n\n\n\n
Subagent<\/h1>\n\n\n\n
Agent\u5728\u4fee\u4e00\u4e2abug\u3002\u5b83\u8bfb\u4e8630\u4e2a\u6587\u4ef6\u6765\u8ffd\u8e2a\u8c03\u7528\u94fe\uff0c\u4e2d\u95f4\u804a\u4e8660\u8f6e\u3002messages\u5217\u8868\u6da8\u5230\u4e86120\u6761\uff0c\u5176\u4e2d\u5927\u90e8\u5206\u662f”\u8ffd\u8e2a\u8c03\u7528\u94fe”\u7684\u4e2d\u95f4\u8fc7\u7a0b\uff0c\u548c”\u4feebug”\u8fd9\u4e2a\u6700\u7ec8\u76ee\u6807\u65e0\u5173\uff0c\u800c\u8fd9\u4e9b\u4e2d\u95f4\u8fc7\u7a0b\u5360\u7740\u4e0a\u4e0b\u6587\u4f4d\u7f6e\uff0c\u8ba9Agent\u8d8a\u6765\u8d8a\u5065\u5fd8\uff0c\u8bb0\u4e0d\u4f4f\u6700\u521d\u7684\u95ee\u9898\u662f\u4ec0\u4e48\u4e86<\/p>\n\n\n\n
\u56e0\u6b64Agent\u9700\u8981\u4e00\u4e2a\u80fd\u529b\uff1a\u5f00\u4e00\u4e2a\u72ec\u7acb\u7684\u5b50\u8fdb\u7a0b\uff0c\u7ed9\u5b83\u4e00\u4e2a\u72ec\u7acb\u7684\u6d88\u606f\u5217\u8868\uff0c\u8ba9\u5b83\u4e13\u5fc3\u505a\u4e00\u4ef6\u4e8b<\/strong><\/p>\n\n\n\n
\"Subagent<\/div><\/figure>\n\n\n\n
\u65b0\u589e\u4e00\u4e2atask\u5de5\u5177\uff0c\u8c03\u7528\u5b83\u65f6\uff0cspawn\u4e00\u4e2a\u5b50Agent\uff0c\u62e5\u6709\u5168\u65b0\u7684messages[]\uff0c\u8dd1\u81ea\u5df1\u7684\u5faa\u73af\uff0c\u7ed3\u675f\u540e\u53ea\u628a\u6458\u8981\u6587\u672c\u4f20\u56de\u7ed9\u4e3bAgent\u3002\u5bf9\u8bdd\u4e0a\u4e0b\u6587\u88ab\u4e22\u5f03\uff0c\u4f46\u6587\u4ef6\u7cfb\u7edf\u7684\u526f\u4f5c\u7528\u4fdd\u7559\u5728\u5de5\u4f5c\u76ee\u5f55\u4e2d<\/p>\n\n\n\n
\u5b50Agent\u7684\u5de5\u5177\u53d7\u9650\uff1a\u6709bash\/read\/write\/edit\/glob\uff0c\u4f46\u6ca1\u6709task\uff0c\u4e0d\u80fd\u9012\u5f52spawn\u65b0\u7684\u5b50Agent\u3002\u5b50Agent\u7684\u5de5\u5177\u8c03\u7528\u4ecd\u7ecf\u8fc7\u6743\u9650hook\uff0c\u5b89\u5168\u7b56\u7565\u4e0d\u56e0\u4e0a\u4e0b\u6587\u9694\u79bb\u800c\u8df3\u8fc7<\/p>\n\n\n\n
spawn_subagent\uff0c\u7ed9\u5b50Agent\u4e00\u4e2a\u5168\u65b0\u7684messages\u5217\u8868\uff0c\u8dd1\u81ea\u5df1\u7684\u5faa\u73af\uff0c\u53ea\u56de\u4f20\u7ed3\u8bba\u3002\u8fd9\u91cc\u4e0eagent_loop\u660e\u663e\u7684\u533a\u522b\u662f\u6ca1\u6709\u91c7\u7528while true\u7684\u6a21\u5f0f\u800c\u662f\u8bbe\u7f6e\u4e86\u8f6e\u6b21\u9632\u6b62subagent\u65e0\u9650\u81ea\u4e3b\u8fd0\u884c<\/strong><\/p>\n\n\n\n
def spawn_subagent(description: str) -> str:\n    # \u5b50 Agent \u7684\u5de5\u5177\uff1a\u57fa\u7840\u5de5\u5177\uff0c\u4f46\u6ca1\u6709 task\uff08\u7981\u6b62\u9012\u5f52\uff09\n    sub_tools = [\n        {\"name\": \"bash\", ...}, {\"name\": \"read_file\", ...},\n        {\"name\": \"write_file\", ...}, {\"name\": \"edit_file\", ...},\n        {\"name\": \"glob\", ...},\n    ]\n    messages = [{\"role\": \"user\", \"content\": description}]  # \u5168\u65b0 messages[]\n\n    for _ in range(30):  # safety limit\n        response = client.messages.create(\n            model=MODEL, system=SUB_SYSTEM,\n            messages=messages, tools=sub_tools, max_tokens=8000,\n        )\n        messages.append({\"role\": \"assistant\", \"content\": response.content})\n        if response.stop_reason != \"tool_use\":\n            break\n        results = []\n        for block in response.content:\n            if block.type == \"tool_use\":\n                blocked = trigger_hooks(\"PreToolUse\", block)\n                if blocked:\n                    results.append({... \"content\": str(blocked)})\n                    continue\n                handler = SUB_HANDLERS.get(block.name)\n                output = handler(**block.input) if handler else f\"Unknown\"\n                trigger_hooks(\"PostToolUse\", block, output)\n                results.append({... \"content\": output})\n        messages.append({\"role\": \"user\", \"content\": results})\n\n    # \u53ea\u8fd4\u56de\u6700\u540e\u7684\u6587\u672c\u7ed3\u8bba\uff0c\u4e2d\u95f4\u8fc7\u7a0b\u5168\u90e8\u4e22\u5f03\n    return extract_text(messages[-1][\"content\"])<\/code><\/pre>\n\n\n\n
\u4e3bAgent\u8c03\u7528\u65f6\uff0c\u8ddf\u8c03\u7528\u5176\u4ed6\u5de5\u5177\u4e00\u6837<\/p>\n\n\n\n
TOOLS = [\n    {\"name\": \"bash\", ...},\n    {\"name\": \"read_file\", ...},\n    {\"name\": \"write_file\", ...},\n    {\"name\": \"edit_file\", ...},\n    {\"name\": \"glob\", ...},\n    {\"name\": \"todo_write\", ...},\n    # s06: \u65b0\u589e task \u5de5\u5177\n    {\"name\": \"task\",\n     \"description\": \"Launch a subagent to handle a complex subtask. Returns only the final conclusion.\",\n     \"input_schema\": {\"type\": \"object\", \"properties\": {\"description\": {\"type\": \"string\"}}, \"required\": [\"description\"]}},\n]\n\nTOOL_HANDLERS[\"task\"] = spawn_subagent<\/code><\/pre>\n\n\n\n
dispatch\u673a\u5236\u4e0d\u53d8\uff0ctask\u5de5\u5177\u901a\u8fc7TOOL_HANDLERS[block.name]\u5206\u53d1\u3002\u5b50Agent\u6709\u72ec\u7acb\u7684SUB_SYSTEM\u63d0\u793a\uff0c\u660e\u786e\u8981\u6c42\u76f4\u63a5\u5b8c\u6210\u4efb\u52a1\u4e0d\u8981\u518d\u59d4\u6d3e<\/p>\n\n\n\n
\"\"<\/div><\/figure>\n\n\n\n
Skill Loading<\/h1>\n\n\n\n
\u9879\u76ee\u6709\u4e00\u5957React\u7ec4\u4ef6\u89c4\u8303\u3001\u4e00\u4efdSQL\u98ce\u683c\u6307\u5357\u3001\u4e00\u4efdAPI\u8bbe\u8ba1\u6587\u6863\u3002\u5e0c\u671bAgent\u81ea\u52a8\u9075\u5b88\u8fd9\u4e9b\u89c4\u8303\u3002\u6700\u76f4\u63a5\u7684\u60f3\u6cd5\u662f\u5168\u585e\u8fdbsystem prompt<\/p>\n\n\n\n
SYSTEM = (\n    f\"You are a coding agent. \"\n    + open(\"docs\/react-style.md\").read()       # 2000 \u884c\n    + open(\"docs\/sql-style.md\").read()         # 1500 \u884c\n    + open(\"docs\/api-design.md\").read()        # 3000 \u884c\n)<\/code><\/pre>\n\n\n\n
6500\u884csystem prompt\u3002Agent\u6bcf\u6b21\u8c03\u7528LLM\u90fd\u5e26\u7740\u8fd9\u4e9b\u6587\u6863\u4e0d\u7ba1\u662f\u5728\u6539CSS\u989c\u8272\u8fd8\u662f\u4feeSQL\u67e5\u8be2\u300299%\u7684\u5185\u5bb9\u548c\u5f53\u524d\u4efb\u52a1\u65e0\u5173\uff0c\u767d\u767d\u6d88\u8017token<\/p>\n\n\n\n
\"Skill<\/div><\/figure>\n\n\n\n
\u65b0\u589eload_skill\u5de5\u5177\uff0c\u542f\u52a8\u65f6\u628a\u6280\u80fd\u76ee\u5f55\u6ce8\u5165SYSTEM prompt\uff0c\u8fd0\u884c\u65f6\u591a\u6ce8\u518c\u4e00\u4e2a\u5de5\u5177\u52a0\u8f7d\u5b8c\u6574\u5185\u5bb9\uff0c\u7528\u5230\u624d\u82b1token<\/p>\n\n\n\n
\u4e24\u5c42\u8bbe\u8ba1<\/strong><\/p>\n\n\n\n
\u5c42<\/th>\u4f4d\u7f6e<\/th>\u65f6\u673a<\/th>\u4ee3\u4ef7<\/th><\/tr><\/thead>
1. \u76ee\u5f55<\/td>system prompt<\/td>\u542f\u52a8\u65f6\u6ce8\u5165\uff08harness \u626b\u63cf skills\/\uff09<\/td>~100 tokens\/skill\uff0c\u6bcf\u8f6e\u90fd\u5e26<\/td><\/tr>
2. \u5185\u5bb9<\/td>tool_result<\/td>Agent \u8c03\u7528 load_skill \u65f6\uff1bSKILL.md \u53ef\u6307\u5f15\u540e\u7eed\u7684 read_file\/bash \u8c03\u7528\uff0c\u7528\u4e8e\u6309\u9700\u8bbf\u95ee\u989d\u5916\u8d44\u6e90<\/td>~2000 tokens\/skill\uff0c\u6309\u9700<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
skills\/\u76ee\u5f55\uff0c\u6bcf\u4e2a\u6280\u80fd\u4e00\u4e2a\u5b50\u76ee\u5f55\uff0c\u5305\u542bSKILL.md\u6587\u4ef6<\/p>\n\n\n\n
skills\/\n  agent-builder\/SKILL.md\n  code-review\/SKILL.md\n  mcp-builder\/SKILL.md\n  pdf\/SKILL.md<\/code><\/pre>\n\n\n\n
\u7b2c\u4e00\u7ea7\uff1a\u542f\u52a8\u65f6\u6ce8\u5165\u76ee\u5f55\uff1aharness\u542f\u52a8\u65f6\u8c03\u7528_scan_skills()\u626b\u63cfskills\/\u76ee\u5f55\uff0c\u89e3\u6790\u6bcf\u4e2aSKILL.md\u7684YAML frontmatter(name\u3001description)\uff0c\u5b58\u5165SKILL_REGISTRY\u5b57\u5178\u3002list_skills()\u4ece\u6ce8\u518c\u8868\u751f\u6210\u76ee\u5f55\uff0c\u6ce8\u5165SYSTEM prompt\u3002Agent\u6bcf\u8f6e\u90fd\u80fd\u770b\u5230\u6709\u54ea\u4e9b\u6280\u80fd\u53ef\u7528\uff0c\u4e0d\u82b1\u989d\u5916\u7684API\u8c03\u7528<\/p>\n\n\n\n
SKILL_REGISTRY: dict[str, dict] = {}\n\ndef _scan_skills():\n    if not SKILLS_DIR.exists():\n        return\n    for d in sorted(SKILLS_DIR.iterdir()):\n        if not d.is_dir():\n            continue\n        manifest = d \/ \"SKILL.md\"\n        if manifest.exists():\n            raw = manifest.read_text()\n            meta, body = _parse_frontmatter(raw)\n            name = meta.get(\"name\", d.name)\n            desc = meta.get(\"description\", raw.split(\"\\n\")[0].lstrip(\"#\").strip())\n            SKILL_REGISTRY[name] = {\"name\": name, \"description\": desc, \"content\": raw}\n\n_scan_skills()  # runs once at startup\n\ndef list_skills() -> str:\n    return \"\\n\".join(f\"- **{s['name']}**: {s['description']}\" for s in SKILL_REGISTRY.values())\n\ndef build_system() -> str:\n    catalog = list_skills()\n    return (\n        f\"You are a coding agent at {WORKDIR}. \"\n        f\"Skills available:\\n{catalog}\\n\"\n        \"Use load_skill to get full details when needed.\"\n    )\n\nSYSTEM = build_system()<\/code><\/pre>\n\n\n\n
\u7b2c\u4e8c\u7ea7\uff1aload_skill\uff1aAgent\u51b3\u5b9a”\u6211\u9700\u8981SQL\u98ce\u683c\u6307\u5357”\uff0c\u8c03\u7528load_skill(“sql-style”)\u901a\u8fc7\u6ce8\u518c\u8868\u67e5\u627e\uff0c\u4e0d\u8d70\u6587\u4ef6\u8def\u5f84\uff0c\u6ca1\u6709\u8def\u5f84\u904d\u5386\u98ce\u9669\u3002SKILL.md\u5185\u5bb9\u901a\u8fc7tool_result\u6ce8\u5165\uff0c\u5e76\u53ef\u901a\u8fc7\u73b0\u6709\u7684file\u548cbash\u5de5\u5177\u8fdb\u4e00\u6b65\u8bbf\u95ee\u5f15\u7528\u7684reference\/\u3001scripts\/\u6216assets\/<\/p>\n\n\n\n
def load_skill(name: str) -> str:\n    skill = SKILL_REGISTRY.get(name)\n    if not skill:\n        return f\"Skill not found: {name}\"\n    return skill[\"content\"]<\/code><\/pre>\n\n\n\n
SKILL\u548cSystem<\/strong> Prompt\uff0cSKILL\u4e0d\u662fSystem<\/strong> Prompt\u7684\u4e00\u90e8\u5206\u3002System Prompt\u662f\u6c38\u4e45\u6027\u7684\u89c4\u5219\u800cSKILL\u6309\u5f53\u524d\u4efb\u52a1\u4e34\u65f6\u52a0\u8f7d\u7684\u4e13\u9879\u8bf4\u660e\u3002SKILL\u4f1a\u4f5c\u4e3a\u4e00\u6b21\u5de5\u5177\u7ed3\u679c\u8fdb\u5165\u5f53\u524d\u7684message\u540e\u7eed\u8c03\u7528\u4f1a\u968f\u5386\u53f2\u4e00\u8d77\u643a\u5e26\uff0c\u76f4\u5230\u4e0a\u4e0b\u6587\u538b\u7f29\u3001\u622a\u65ad\u6216\u8005\u4f1a\u8bdd\u7ed3\u675f<\/strong><\/p>\n\n\n\n
\"\"<\/div><\/figure>\n\n\n\n
Context Compact\u4e0a\u4e0b\u6587\u538b\u7f29<\/h1>\n\n\n\n
Agent\u8dd1\u7740\u8dd1\u7740\u5c31\u4e0d\u52a8\u4e86\uff0c\u6709bash\u3001\u6709read\u3001\u6709write\u80fd\u529b\u662f\u591f\u7684\uff0c\u4f46\u662f\u5b83\u8bfb\u4e86\u4e00\u4e2a1000\u884c\u7684\u6587\u4ef6\uff0c\u53c8\u8bfb\u4e8630\u4e2a\u6587\u4ef6\uff0c\u8dd1\u4e8620\u6761\u547d\u4ee4\u3002\u6bcf\u6761\u547d\u4ee4\u7684\u8f93\u51fa\u3001\u6bcf\u4e2a\u6587\u4ef6\u7684\u5185\u5bb9\uff0c\u5168\u90e8\u5806\u5728messages\u5217\u8868\u91cc\u3002\u4e0a\u4e0b\u6587\u7a97\u53e3\u662f\u6709\u9650\u7684\uff0c\u6ee1\u4e86\u4e4b\u540eAPI\u76f4\u63a5\u62d2\u7edd\uff1aprompt_too_long\uff0c\u4e0d\u538b\u7f29\u4e0a\u4e0b\u6587\uff0cAgent\u6839\u672c\u6ca1\u6cd5\u5728\u5927\u9879\u76ee\u91cc\u5e72\u6d3b<\/p>\n\n\n\n
\"Compact<\/div><\/figure>\n\n\n\n
\u6838\u5fc3\u8bbe\u8ba1\u903b\u8f91\uff1a\u4fbf\u5b9c\u7684\u5148\u8dd1\uff0c\u8d35\u7684\u540e\u8dd1<\/strong><\/p>\n\n\n\n
\u6bcf\u8f6eLLM\u8c03\u7528\u524d\u63d2\u5165\u4e09\u5c42\u9884\u5904\u7406\u5668\uff080 API\uff09\uff0ctoken\u4ecd\u8d85\u8fc7\u9608\u503c\u65f6\u89e6\u53d1LLM\u6458\u8981\uff081 API\uff09\uff0cAPI\u62a5\u9519\u65f6\u5e94\u6025\u88c1\u526a<\/p>\n\n\n\n
\"\u56db\u5c42\u538b\u7f29\u7ba1\u7ebf\"\/<\/div><\/figure>\n\n\n\n
L1\uff1asnip_compact-\u88c1\u6389\u65e0\u5173\u7684\u65e7\u5bf9\u8bdd<\/strong><\/p>\n\n\n\n
Agent\u8dd1\u4e8680\u8f6e\u5bf9\u8bdd\uff0cmessage\u6512\u4e86160\u6761\u3002\u6700\u524d\u9762\u7684”\u5e2e\u6211\u521b\u5efahello.py”\u548c\u5f53\u524d\u5de5\u4f5c\u51e0\u4e4e\u65e0\u5173\u4e86\uff0c\u4f46\u5168\u5360\u7740\u4f4d\u7f6e\u3002<\/p>\n\n\n\n
\u6d88\u606f\u6811\u8d85\u8fc750\u6761 –> \u4fdd\u7559\u5934\u90e83\u6761\uff08\u521d\u59cb\u4e0a\u4e0b\u6587\uff09\u548c\u5c3e\u90e847\u6761\uff08\u5f53\u524d\u5de5\u4f5c\uff09\uff0c\u4e2d\u95f4\u88c1\u6389\uff1b\u552f\u4e00\u989d\u5916\u8fb9\u754c\u6761\u4ef6\u662f\uff0c\u4e0d\u80fd\u628aassistant(tool_use)\u548c\u540e\u9762\u7684user(tool_result)\u62c6\u5f00<\/p>\n\n\n\n
def snip_compact(messages, max_messages=50):\n    if len(messages) <= max_messages:\n        return messages\n    head_end, tail_start = 3, len(messages) - (max_messages - 3)\n    if head_end > 0 and _message_has_tool_use(messages[head_end - 1]):\n        while head_end < len(messages) and _is_tool_result_message(messages[head_end]):\n            head_end += 1\n    if (tail_start > 0 and tail_start < len(messages)\n            and _is_tool_result_message(messages[tail_start])\n            and _message_has_tool_use(messages[tail_start - 1])):\n        tail_start -= 1\n    snipped = tail_start - head_end\n    placeholder = {\"role\": \"user\", \"content\": f\"[snipped {snipped} messages from conversation middle]\"}\n    return messages[:head_end] + [placeholder] + messages[tail_start:]<\/code><\/pre>\n\n\n\n
\u8fd9\u91cc\u8fd8\u7279\u522b\u5904\u7406\u4e86\u5de5\u5177\u7684\u8c03\u7528
Agent\uff1a\u6211\u8981\u8bfb\u53d6\u6587\u4ef6 <– tool_use
\u5de5\u5177\uff1a\u8fd9\u662f\u6587\u4ef6\u5185\u5bb9 <– tool_result
\u8fd9\u4e24\u6761\u5fc5\u987b\u4e00\u8d77\u4fdd\u7559\uff0c\u4e0d\u80fd\u53ea\u4fdd\u7559\u5176\u4e2d\u4e00\u6761\uff0c\u5982\u679c\u622a\u65ad\u4f4d\u7f6e\u521a\u597d\u843d\u5728\u5b83\u4eec\u4e2d\u95f4\uff0c\u51fd\u6570\u4f1a\u79fb\u52a8\u622a\u65ad\u4f4d\u7f6e\u3002\u9632\u6b62\u62c6\u5f00\u5934\u90e8\u9644\u8fd1\u7684\u5de5\u5177\u8c03\u7528\u914d\u5bf9\u548c\u9632\u6b62\u5c3e\u90e8\u4ece\u5b64\u7acb\u7684\u5de5\u5177\u7ed3\u679c\u5f00\u59cb\u6709\u4e86\u4e00\u4e0b\u64cd\u4f5c\u3002<\/strong><\/p>\n\n\n\n
if head_end > 0 and _message_has_tool_use(messages[head_end - 1]):\n        while head_end < len(messages) and _is_tool_result_message(messages[head_end]):\n            head_end += 1<\/code><\/pre>\n\n\n\n
\u5934\u90e8\u4ee5\u5de5\u5177\u8c03\u7528\u4e3a\u8d77\u70b9\u8865\u5de5\u5177\u7ed3\u679c<\/strong>\u8fd9\u91cc\u5c31\u662f\u5934\u90e8\u5224\u65ad\u5982\u679c\u524d\u9762\u4e00\u6761\u662f\u5de5\u5177\u8c03\u7528\u5e76\u4e14\u8fd9\u4e00\u6761\u662f\u8c03\u7528\u7ed3\u679c\u90a3\u4e48\u4e24\u8005\u8981\u5728\u4e00\u8d77\u8fdb\u884c\u4fdd\u7559\u3002\u8fd9\u91cc\u5047\u8bbe\u540e\u9762\u7684\u6d88\u606f\u5168\u90e8\u662f tool_result<\/code>\uff0chead_end<\/code> \u53ef\u80fd\u4e00\u76f4\u589e\u52a0\u8fd9\u4f1a\u8d85\u51fa\u5217\u8868\u8303\u56f4\u5bfc\u81f4\u5f02\u5e38\u6240\u4ee5\u4e3a\u4e86\u4fdd\u62a4\u5faa\u73af\u540e\u7eed\u7684\u6bcf\u6b21\u5224\u65ad\u8bbe\u7f6e\u4e86head_end < len(messages)<\/p>\n\n\n\n
if (tail_start > 0 and tail_start < len(messages)\n            and _is_tool_result_message(messages[tail_start])\n            and _message_has_tool_use(messages[tail_start - 1])):\n        tail_start -= 1<\/code><\/pre>\n\n\n\n
\u5c3e\u90e8\u662f\u4ee5\u5de5\u5177\u7ed3\u679c\u4e3a\u5c3e\u70b9\u8865\u5de5\u5177\u8c03\u7528<\/strong>\u56e0\u6b64\u53ea\u9700\u8981\u5224\u65ad\u524d\u4f4d\u6709\u4e00\u4e2a\u662f\u5de5\u5177\u8c03\u7528\u5373\u53ef<\/p>\n\n\n\n
\u88c1\u6389\u7684\u662f\u6d88\u606f\u672c\u8eab\uff0c\u4f46\u662f\u6d88\u606f\u6570\u91cf\u53d8\u5c11\uff0c\u4e0d\u4e00\u5b9a\u4ee3\u8868\u4e0a\u4e0b\u6587\u771f\u6b63\u53d8\u5c0f\u5f88\u591a<\/p>\n\n\n\n
L2\uff1amicro_compact-\u65e7\u5de5\u5177\u7ed3\u679c\u5360\u4f4d<\/strong><\/p>\n\n\n\n
\"\u65e7\u7ed3\u679c\u5360\u4f4d\"\/<\/div><\/figure>\n\n\n\n
Agent\u8fde\u7eed\u8bfb\u4e8610\u4e2a\u6587\u4ef6\u3002\u7b2c1-7\u6b21\u7684\u5b8c\u6574\u5185\u5bb9\u8fd8\u8eba\u5728\u4e0a\u4e0b\u6587\u91cc\uff0c\u65e9\u5c31\u4e0d\u9700\u8981\u4e86\uff0c\u4f46\u5360\u7740\u5927\u91cf\u7a7a\u95f4<\/p>\n\n\n\n
\u53ea\u4fdd\u7559\u6700\u8fd13\u6761tool_result\u7684\u5b8c\u6574\u5185\u5bb9\uff0c\u66f4\u65e7\u7684\u66ff\u6362\u4e3a\u4e00\u884c\u5360\u4f4d\u7b26<\/p>\n\n\n\n
KEEP_RECENT_TOOL_RESULTS = 3\n\ndef micro_compact(messages):\n    tool_results = collect_tool_result_blocks(messages)\n    if len(tool_results) <= KEEP_RECENT_TOOL_RESULTS:\n        return messages\n    for _, _, block in tool_results[:-KEEP_RECENT_TOOL_RESULTS]:\n        if len(block.get(\"content\", \"\")) > 120:\n            block[\"content\"] = \"[Earlier tool result compacted. Re-run if needed.]\"\n    return messages<\/code><\/pre>\n\n\n\n
\u65e7\u7ed3\u679c\u6e05\u6389\u4e86\uff0c\u4f46\u5355\u6761\u65b0\u7ed3\u679c\u53ef\u80fd\u5c31\u6709500KB\uff0c\u4e00\u4e2acat\u5927\u6587\u4ef6\u7684\u8f93\u51fa\u5c31\u80fd\u6253\u6ee1\u4e0a\u4e0b\u6587<\/p>\n\n\n\n
L3\uff1atool_result_budget-\u5927\u7ed3\u679c\u843d\u76d8<\/strong><\/p>\n\n\n\n
\"\u5927\u7ed3\u679c\u843d\u76d8\"\/<\/div><\/figure>\n\n\n\n
\u6a21\u578b\u4e00\u6b21\u8bfb\u4e865\u4e2a\u5927\u6587\u4ef6\uff0c\u5355\u6761user\u6d88\u606f\u91cc\u6240\u6709tool_result\u52a0\u8d77\u6765500KB\u3002\u7edf\u8ba1\u6700\u540e\u4e00\u6761user\u6d88\u606f\u91cc\u6240\u6709tool_result\u7684\u603b\u5927\u5c0f\u3002\u8d85\u8fc7200KB -> \u6309\u5927\u5c0f\u6392\u5e8f\uff0c\u4ece\u6700\u5927\u7684\u5f00\u59cb\u843d\u76d8\u5230.task_outputs\/tool-results\/\uff0c\u4e0a\u4e0b\u6587\u53ea\u7559<persisted-output>\u6807\u8bb0 + \u524d2000\u5b57\u7b26\u9884\u89c8\u3002\u6a21\u578b\u770b\u5230\u6807\u8bb0\u540e\u77e5\u9053\u5b8c\u6574\u5185\u5bb9\u5728\u78c1\u76d8\u4e0a\uff0c\u9700\u8981\u65f6\u53ef\u4ee5\u91cd\u65b0\u8bfb\u3002<\/p>\n\n\n\n
def tool_result_budget(messages, max_bytes=200_000):\n    last = messages[-1]\n    blocks = [(i, b) for i, b in enumerate(last[\"content\"])\n              if b.get(\"type\") == \"tool_result\"]\n    total = sum(len(str(b.get(\"content\", \"\"))) for _, b in blocks)\n    if total <= max_bytes:\n        return messages\n    ranked = sorted(blocks, key=lambda p: len(str(p[1].get(\"content\", \"\"))), reverse=True)\n    for idx, block in ranked:\n        if total <= max_bytes:\n            break\n        block[\"content\"] = persist_large_output(block[\"tool_use_id\"], str(block[\"content\"]))\n        total = recalculate_total(blocks)\n    return messages<\/code><\/pre>\n\n\n\n
L4\uff1acompact_history-LLM\u5168\u91cf\u6458\u8981<\/strong><\/p>\n\n\n\n
\u524d\u4e09\u5c42\u90fd\u662f\u7eaf\u6587\u4ef6\/\u7ed3\u6784\u64cd\u4f5c\uff0c0 API\u8c03\u7528\uff0c\u4f46\u4e5f\u65e0\u6cd5\u7406\u89e3\u5bf9\u8bdd\u5185\u5bb9\uff0c\u4e0a\u4e0b\u6587\u53ef\u80fd\u4ecd\u7136\u592a\u5927<\/p>\n\n\n\n
\"LLM<\/div><\/figure>\n\n\n\n
\u524d\u4e09\u5c42\u5168\u8dd1\u5b8c\u4e86\uff0c\u4f46\u5728\u8d85\u5927\u9879\u76ee\u4e2d\u8fde\u7eed\u5de5\u4f5c30min\u540e\uff0ctoken\u4ecd\u7136\u8d85\u8fc7\u9608\u503c<\/p>\n\n\n\n
\u4e09\u6b65\u6d41\u7a0b\uff1a<\/p>\n\n\n\n
1.\u4fdd\u5b58transcript\uff1a\u5b8c\u6574\u5bf9\u8bdd\u5199\u5165.transcripts\/\uff0cJSONL\u683c\u5f0f\u3002transcript\u4fdd\u7559\u4e86\u53ef\u6062\u590d\u8bb0\u5f55\uff0c\u4f46\u6a21\u578b\u7684\u6d3b\u8dc3\u4e0a\u4e0b\u6587\u91cc\u53ea\u5269\u6458\u8981\u3002\u5bf9\u6a21\u578b\u5f53\u4e0b\u63a8\u7406\u6765\u8bf4\uff0c\u7ec6\u8282\u5df2\u7ecf\u4e0d\u5728\u4e0a\u4e0b\u6587\u4e2d\u4e86\u3002<\/p>\n\n\n\n
2.LLM\u751f\u6210\u6458\u8981\uff1a\u628a\u5bf9\u8bdd\u5386\u53f2\u53d1\u7ed9LLM\uff0c\u8981\u6c42\u4fdd\u7559\u5f53\u524d\u76ee\u6807\u3001\u91cd\u8981\u53d1\u73b0\u3001\u5df2\u6539\u6587\u4ef6\u3001\u5269\u4f59\u5de5\u4f5c\u3001\u7528\u6237\u7ea6\u675f\u7b49\u5173\u952e\u4fe1\u606f\u3002<\/p>\n\n\n\n
3.\u66ff\u6362\u6d88\u606f\u5217\u8868\uff1a\u6240\u6709\u65e7\u6d88\u606f\u88ab\u66ff\u6362\u4e3a\u4e00\u6761\u6458\u8981\u3002<\/p>\n\n\n\n
def compact_history(messages):\n    transcript_path = write_transcript(messages)  # \u5148\u4fdd\u5b58\u5b8c\u6574\u5bf9\u8bdd\n    summary = summarize_history(messages)          # LLM \u751f\u6210\u6458\u8981\n    return [{\"role\": \"user\",\n             \"content\": f\"[Compacted]\\n\\n{summary}\"}]<\/code><\/pre>\n\n\n\n
\u5e94\u6025\uff1areactive_compact<\/strong><\/p>\n\n\n\n
\u6709\u65f6\u5019API\u8fd8\u662f\u8fd4\u56deprompt_too_long(413)\uff0c\u4e0a\u4e0b\u6587\u589e\u957f\u901f\u5ea6\u5feb\u4e8e\u538b\u7f29\u89e6\u53d1\u901f\u5ea6\u65f6\u3002<\/p>\n\n\n\n
\u8fd9\u65f6\u89e6\u53d1reactive_compact\u89e6\u53d1\u65b9\u5f0f\u6bd4compact_history\u66f4\u6fc0\u8fdb\uff0c\u4f46\u538b\u7f29\u7b56\u7565\u66f4\u6e29\u548c\uff0c\u4fdd\u7559\u6700\u8fd1\u7ea65\u6761\u539f\u59cb\u6d88\u606f\uff0c\u53ea\u603b\u7ed3\u8f83\u65e9\u5386\u53f2\u3002\u540c\u6837\u907f\u514d\u7559\u4e0b\u5b64\u7acbtool_result<\/p>\n\n\n\n
def reactive_compact(messages):\n    transcript = write_transcript(messages)\n    tail_start = max(0, len(messages) - 5)\n    if (tail_start > 0 and tail_start < len(messages)\n            and _is_tool_result_message(messages[tail_start])\n            and _message_has_tool_use(messages[tail_start - 1])):\n        tail_start -= 1\n    summary = summarize_history(messages[:tail_start])\n    return [{\"role\": \"user\",\n             \"content\": f\"[Reactive compact]\\n\\n{summary}\"}, *messages[tail_start:]]<\/code><\/pre>\n\n\n\n
reactive compact\u6709\u91cd\u8bd5\u4e0a\u9650\u3002\u518d\u5931\u8d25\u5c31\u629b\u51fa\u5f02\u5e38\uff0c\u4e0d\u65e0\u9650\u5faa\u73af<\/p>\n\n\n\n
def agent_loop(messages):\n    reactive_retries = 0\n    while True:\n        # \u4e09\u4e2a\u9884\u5904\u7406\u5668\uff080 API \u8c03\u7528\uff09\n        # \u987a\u5e8f\uff1abudget \u5148\u8dd1\uff0c\u786e\u4fdd\u5927\u5185\u5bb9\u843d\u76d8\u540e\u518d\u505a\u5360\u4f4d\u548c\u88c1\u526a\n        messages[:] = tool_result_budget(messages)    # L3: \u5927\u7ed3\u679c\u843d\u76d8\n        messages[:] = snip_compact(messages)          # L1: \u88c1\u4e2d\u95f4\n        messages[:] = micro_compact(messages)         # L2: \u65e7\u7ed3\u679c\u5360\u4f4d\n\n        # \u8fd8\u4e0d\u591f\uff1fLLM \u6458\u8981\uff081 API \u8c03\u7528\uff09\n        if estimate_token_count(messages) > THRESHOLD:\n            messages[:] = compact_history(messages)\n\n        try:\n            response = client.messages.create(...)\n        except PromptTooLongError:\n            if reactive_retries < MAX_REACTIVE_RETRIES:\n                messages[:] = reactive_compact(messages)  # \u5e94\u6025\n                reactive_retries += 1\n                continue\n            raise  # \u8d85\u8fc7\u91cd\u8bd5\u4e0a\u9650\uff0c\u629b\u51fa\u5f02\u5e38\n        # ... \u5de5\u5177\u6267\u884c ...\n\n        # compact \u5de5\u5177\uff1a\u6a21\u578b\u4e3b\u52a8\u8c03\u7528\u65f6\u89e6\u53d1 compact_history\n        if block.name == \"compact\":\n            messages[:] = compact_history(messages)\n            results.append({..., \"content\": \"[Compacted. History summarized.]\"})\n            messages.append({\"role\": \"user\", \"content\": results})\n            break  # \u7ed3\u675f\u5f53\u524d turn\uff0c\u7528\u538b\u7f29\u540e\u7684\u4e0a\u4e0b\u6587\u5f00\u59cb\u65b0\u4e00\u8f6e<\/code><\/pre>\n\n\n\n
\u843d\u5730\u4e0b\u6765L3\u5728L2\u524d\u9762\uff0c\u56e0\u4e3amicro\u4f1a\u628a\u65e7\u7684\u5927tool_result\u66ff\u6362\u6210\u4e00\u884c\u5360\u4f4d\u7b26\uff0cbudget\u5fc5\u987b\u5728\u90a3\u4e4b\u524d\u628a\u5b8c\u6574\u5185\u5bb9\u843d\u76d8\u3002<\/strong><\/p>\n\n\n\n
\"\"<\/div><\/figure>\n\n\n\n
Memory<\/h1>\n\n\n\n
\u524d\u9762\u7684autoCompact\uff08L4\uff09\u4f1a\u628a\u5f53\u524d\u76ee\u6807\u3001\u5269\u4f59\u5de5\u4f5c\u3001\u7528\u6237\u7ea6\u675f\u5199\u8fdb\u6458\u8981\uff0c\u4f46\u7ec6\u8282\u4f1a\u4e22\u5931\uff1a”\u7528tab\u7f29\u8fdb\u4e0d\u8981\u7528\u7a7a\u683c”\u53ef\u80fd\u88ab\u7b80\u5316\u6210”\u7528\u6237\u6709\u4ee3\u7801\u98ce\u683c\u504f\u597d”\u3002\u65b0\u5f00\u4e00\u4e2a\u4f1a\u8bdd\uff0c\u8fde\u6458\u8981\u4e5f\u6ca1\u4e86\u3002<\/p>\n\n\n\n
LLM\u6ca1\u6709\u6301\u4e45\u72b6\u6001\uff0c\u6240\u6709\u4fe1\u606f\u90fd\u5728\u4e0a\u4e0b\u6587\u7a97\u53e3\u91cc\u3002\u4e0a\u4e0b\u6587\u6ee1\u4e86\u8981\u538b\u7f29\uff0c\u538b\u7f29\u5c31\u6709\u635f\u3002\u9700\u8981\u4e00\u5c42\u4e0d\u53c2\u4e0e\u538b\u7f29\u3001\u8de8\u4f1a\u8bdd\u4fdd\u7559\u7684\u5b58\u50a8\u3002<\/p>\n\n\n\n
\"Memory<\/div><\/figure>\n\n\n\n
\u524d\u9762\u7684\u538b\u7f29\u7ba1\u7ebf\u4fdd\u7559\uff0c\u5b58\u50a8\u9009\u6587\u4ef6\u7cfb\u7edf\uff1a.memory\/\u76ee\u5f55\u4e0b\uff0c\u6bcf\u4e2a\u8bb0\u5fc6\u4e00\u4e2a.md\u6587\u4ef6\uff0c\u5e26YAML frontmatter\uff08name \/ description \/ type\uff09\u6587\u4ef6\u591a\u4e86\u9700\u8981\u7d22\u5f15\uff1aMEMORY.md\u4e00\u884c\u4e00\u4e2a\u94fe\u63a5\u6ce8\u5165SYSTEM<\/p>\n\n\n\n
\u5173\u952e\u8bbe\u8ba1\uff1a\u7d22\u5f15\u5e38\u9a7bSYSTEM prompt\uff08\u53ef\u88ab prompt cache\u7f13\u5b58\uff09\uff0c\u6587\u4ef6\u5185\u5bb9\u6309\u9700\u6ce8\u5165\u5230\u5f53\u524duser turn\uff08\u6309filename\/description\u5339\u914d\u5f53\u524d\u5bf9\u8bdd\uff0c\u4e0d\u7834\u574fcache\uff09\u3002\u5199\u5165\u7531\u6bcf\u8f6e\u7ed3\u675f\u540e\u7684\u63d0\u53d6\u5668\u5b8c\u6210\uff1a\u7528\u6237\u663e\u793a\u8bf4”\u8bb0\u4f4f”\u6216\u8868\u8fbe\u7a33\u5b9a\u504f\u597d\u65f6\uff0c\u63d0\u53d6\u5668\u4f1a\u4fdd\u5b58\u4e3a\u8bb0\u5fc6\u3002\u6587\u4ef6\u79ef\u7d2f\u591a\u4e86\uff0c\u5b9a\u671f\u6574\u7406\u53bb\u91cd\u3002<\/strong><\/p>\n\n\n\n
\u56db\u7c7b\u8bb0\u5fc6\uff0c\u5404\u6709\u7528\u9014<\/p>\n\n\n\n
\u7c7b\u578b<\/th>\u56de\u7b54\u4ec0\u4e48<\/th>\u793a\u4f8b<\/th><\/tr><\/thead>
user<\/td>\u4f60\u662f\u8c01<\/td>“\u7528 tab \u4e0d\u7528\u7a7a\u683c”<\/td><\/tr>
feedback<\/td>\u600e\u4e48\u505a\u4e8b<\/td>“\u522b mock \u6570\u636e\u5e93”<\/td><\/tr>
project<\/td>\u6b63\u5728\u53d1\u751f\u4ec0\u4e48<\/td>“auth \u91cd\u5199\u662f\u5408\u89c4\u9a71\u52a8”<\/td><\/tr>
reference<\/td>\u4e1c\u897f\u5728\u54ea\u627e<\/td>“pipeline bug \u5728 Linear INGEST”<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\"Memory<\/div><\/figure>\n\n\n\n
\u5b58\u50a8md\u6587\u4ef6+\u7d22\u5f15<\/p>\n\n\n\n
\u6bcf\u4e2a\u8bb0\u5fc6\u662f\u4e00\u4e2a.md\u6587\u4ef6\uff0cYAML frontmatter\u8bb0\u5f55\u5143\u6570\u636e<\/p>\n\n\n\n
---\nname: user-preference-tabs\ndescription: User prefers tabs for indentation\ntype: user\n---\n\nUser prefers using tabs, not spaces, for indentation.\n**Why:** Consistency with existing codebase conventions.\n**How to apply:** Always use tabs when writing or editing files.<\/code><\/pre>\n\n\n\n
MEMORY.md\u662f\u7d22\u5f15\uff0c\u4e00\u884c\u4e00\u4e2a\u94fe\u63a5<\/p>\n\n\n\n
- [user-preference-tabs](user-preference-tabs.md) \u2014 User prefers tabs for indentation<\/code><\/pre>\n\n\n\n
\u5199\u5165\u65b0\u8bb0\u5fc6\u65f6\u81ea\u52a8\u91cd\u5efa\u7d22\u5f15<\/p>\n\n\n\n
def write_memory_file(name, mem_type, description, body):\n    slug = name.lower().replace(\" \", \"-\")\n    filepath = MEMORY_DIR \/ f\"{slug}.md\"\n    filepath.write_text(\n        f\"---\\nname: {name}\\ndescription: {description}\\ntype: {mem_type}\\n---\\n\\n{body}\\n\"\n    )\n    _rebuild_index()<\/code><\/pre>\n\n\n\n
\u4e24\u6761\u8def\u5f84\u52a0\u8f7d<\/strong><\/p>\n\n\n\n
\u8def\u5f84\u4e00\uff1a\u7d22\u5f15\u5e38\u9a7bSYSTEM\u3002<\/strong>build_system()\u5728\u6bcf\u6b21\u7528\u6237\u8bf7\u6c42\u5f00\u59cb\u65f6\u8bfb\u53d6MEMORY.md\uff0c\u628a\u8bb0\u5fc6\u6e05\u5355\u6ce8\u5165\u3002\u8bb0\u5fc6\u63d0\u53d6\u548c\u6574\u7406\u53ea\u5728\u672c\u8f6e\u7ed3\u675f\u65f6\u89e6\u53d1\uff0c\u56e0\u6b64\u540c\u4e00\u8f6e\u7528\u6237\u8bf7\u6c42\u4e2d\u4e0d\u9700\u8981\u91cd\u590d\u91cd\u5efaSYSTEM<\/p>\n\n\n\n
\u8def\u5f84\u4e8c\uff1a\u76f8\u5173\u8bb0\u5fc6\u6309\u9700\u6ce8\u5165\u3002<\/strong>\u6bcf\u6b21\u7528\u6237\u8bf7\u6c42\u5f00\u59cb\u65f6\uff0cload_memories()\u628a\u6700\u8fd1\u5bf9\u8bdd\u548c\u8bb0\u5fc6\u76ee\u5f55\uff08name + description\uff09\u4e00\u8d77\u53d1\u7ed9LLM\u505a\u4e00\u6b21\u8f7b\u91cfside-query\uff0c\u9009\u51fa\u76f8\u5173\u7684\u6587\u4ef6\u540d\uff0c\u518d\u8bfb\u6587\u4ef6\u5185\u5bb9\u4e34\u65f6\u6ce8\u5165\u5230\u5f53\u524duser turn\u3002\u6700\u591a\u4e94\u6761\u63a7\u5236\u5f00\u9500\u3002<\/p>\n\n\n\n
def select_relevant_memories(messages, max_items=5):\n    files = list_memory_files()\n    if not files:\n        return []\n\n    # Build catalog: \"0: user-preference-tabs \u2014 User prefers tabs...\"\n    catalog = \"\\n\".join(f\"{i}: {f['name']} \u2014 {f['description']}\" for i, f in enumerate(files))\n\n    response = client.messages.create(model=MODEL, messages=[{\"role\": \"user\",\n        \"content\": f\"Select relevant memory indices. Return JSON array.\\n\\n\"\n                   f\"Recent conversation:\\n{recent}\\n\\nMemory catalog:\\n{catalog}\"}],\n        max_tokens=200)\n    text = extract_text(response.content).strip()\n    indices = json.loads(re.search(r'\\[.*?\\]', text).group())\n    return [files[i][\"filename\"] for i in indices if 0 <= i < len(files)]<\/code><\/pre>\n\n\n\n
\u5982\u679cside-query\u5931\u8d25\uff08\u5728\u6b63\u5f0f\u56de\u7b54\u7528\u6237\u4e4b\u524d\uff0charness \u989d\u5916\u5411 LLM \u53d1\u8d77\u7684\u4e00\u6b21\u5185\u90e8\u5c0f\u67e5\u8be2\u3002\u8ba9LLM\u9009\u62e9\u76f8\u5173\u8bb0\u5fc6\uff09\uff0c\u964d\u7ea7\u5230\u5173\u952e\u8bcd\u5339\u914dname + description<\/p>\n\n\n\n
\u5199\u5165\uff1a\u6bcf\u8f6e\u7ed3\u675f\u540e\u63d0\u53d6<\/strong><\/p>\n\n\n\n
\u7528\u6237\u4e0d\u4f1a\u6bcf\u6b21\u90fd\u8bf4”\u8bb0\u4f4f\u8fd9\u4e2a”\u3002\u504f\u597d\u901a\u5e38\u6563\u843d\u5728\u6b63\u5e38\u5bf9\u8bdd\u4e2d\uff1a”\u7528tab\u6bd4\u7a7a\u683c\u597d”\u3001”\u4ee5\u540e\u90fd\u7528\u5355\u5f15\u53f7”\u3002<\/p>\n\n\n\n
extract_memories()\u5728\u6bcf\u8f6e\u7ed3\u675f\u65f6\u8fd0\u884c\uff0c\u6761\u4ef6\u662f\u6a21\u578b\u505c\u6b62\u4e14\u6ca1\u6709tool_use(\u8bf4\u660e\u5bf9\u8bdd\u544a\u4e00\u6bb5\u843d)<\/p>\n\n\n\n
# In agent_loop:\nif response.stop_reason != \"tool_use\":\n    extract_memories(pre_compress)   # \u4ece\u538b\u7f29\u524d\u5feb\u7167\u63d0\u53d6\u65b0\u8bb0\u5fc6\n    consolidate_memories()       # \u68c0\u67e5\u662f\u5426\u9700\u8981\u6574\u7406\n    return<\/code><\/pre>\n\n\n\n
\u63d0\u53d6\u524d\u5148\u68c0\u67e5\u5df2\u6709\u8bb0\u5fc6\uff0c\u907f\u514d\u91cd\u590d\u3002\u63d0\u53d6prompt\u8981\u6c42LLM\u8fd4\u56de{name,type,description,body}\u7684JSON\u6570\u7ec4\uff0c\u53ea\u6709\u786e\u5b9e\u7531\u65b0\u4fe1\u606f\u65f6\u624d\u5199\u6587\u4ef6<\/p>\n\n\n\n
def extract_memories(messages):\n    dialogue = format_recent_messages(messages[-10:])\n    existing = \"\\n\".join(f\"- {m['name']}: {m['description']}\" for m in list_memory_files())\n\n    prompt = (\n        \"Extract user preferences, constraints, or project facts.\\n\"\n        \"Return JSON array: [{name, type, description, body}].\\n\"\n        \"If nothing new or already covered, return [].\\n\\n\"\n        f\"Existing memories:\\n{existing}\\n\\nDialogue:\\n{dialogue[:4000]}\"\n    )\n    # ... parse response, write files ...<\/code><\/pre>\n\n\n\n
\u6574\u7406\uff1a\u4f4e\u9891\u5408\u5e76\u53bb\u91cd<\/strong><\/p>\n\n\n\n
\u8bb0\u5fc6\u6587\u4ef6\u4f1a\u79ef\u7d2f\u3002consolidate_memories()\u5728\u6587\u4ef6\u6570\u8fbe\u5230\u9608\u503c\u65f6\u89e6\u53d1\uff0c\u8ba9LLM\u53bb\u91cd\u3001\u5408\u5e76\u77db\u76fe\u3001\u6dd8\u6c70\u8fc7\u65f6\u8bb0\u5fc6\uff1a<\/p>\n\n\n\n
CONSOLIDATE_THRESHOLD = 10\n\ndef consolidate_memories():\n    files = list_memory_files()\n    if len(files) < CONSOLIDATE_THRESHOLD:\n        return  # \u592a\u5c11\uff0c\u4e0d\u503c\u5f97\u6574\u7406\n    # Send all memories to LLM, get back deduplicated list\n    # Replace all files with consolidated results<\/code><\/pre>\n\n\n\n
CC\u628a\u8fd9\u4e2a\u8fc7\u7a0b\u53ebDream\uff0c\u5b9e\u9645\u6709\u56db\u95e8\u95e8\u63a7\uff1a\u65f6\u95f4\u95f4\u9694\u3001\u626b\u63cf\u8282\u6d41\u3001\u4f1a\u8bdd\u6570\u3001\u6587\u4ef6\u9501\u3002\u8fd9\u91cc\u7b80\u5316\u4e3a\u6587\u4ef6\u6570\u9608\u503c<\/p>\n\n\n\n
Memory\u9002\u5408\u4fdd\u5b58\u4ec0\u4e48<\/strong><\/p>\n\n\n\n
Memory\u4fdd\u5b58\u8de8\u4f1a\u8bdd\u4ecd\u6709\u7528\u7684\u4fe1\u606f\uff1a\u7528\u6237\u504f\u597d\u3001\u53cd\u590d\u51fa\u73b0\u7684\u53cd\u9988\u3001\u9879\u76ee\u80cc\u666f\u3001\u5e38\u7528\u5165\u53e3\u548c\u6392\u67e5\u7ebf\u7d22\u3002\u5b83\u5173\u6ce8”\u4ee5\u540e\u8fd8\u4f1a\u7528\u5230\u4ec0\u4e48”\uff0c\u5e76\u901a\u8fc7\u7d22\u5f15+\u6309\u9700\u52a0\u8f7d\u628a\u8fd9\u4e9b\u4fe1\u606f\u5e26\u56de\u5f53\u524d\u5bf9\u8bdd\u3002<\/p>\n\n\n\n
session memory\u5173\u6ce8\u540c\u4e00\u4f1a\u8bdd\u5185\u7684\u8fde\u7eed\u6027\uff1acompact\u4e4b\u540e\uff0c\u5f53\u524d\u4f1a\u8bdd\u8fd8\u9700\u8981\u4fdd\u7559\u54ea\u4e9b\u4e0a\u4e0b\u6587\u3002\u4e24\u8005\u914d\u5408\u4f7f\u7528\uff1aMemory\u7ba1\u957f\u671f\u77e5\u8bc6\uff0csession memory\u7ba1\u5f53\u524d\u4f1a\u8bdd\u7684\u538b\u7f29\u8fde\u7eed\u3002<\/p>\n\n\n\n
\"\"<\/div><\/figure>\n\n\n\n
System Prompt\u8fd0\u884c\u65f6\u7ec4\u88c5<\/h1>\n\n\n\n
\u524d\u9762system prompt\u90fd\u662f\u4e00\u884c\u786c\u7f16\u7801\uff0c\u5f53\u53ea\u6709bash\u3001read\u3001write\u4e09\u4e2a\u5de5\u5177\u3002\u4f46\u5230\u540e\u9762Agent\u5df2\u7ecf\u6709\u8bb0\u5fc6\u3001\u6709\u538b\u7f29\u3001\u6709\u6280\u80fd\u52a0\u8f7d\u3002prompt\u8be5\u63d0\u7684\u80fd\u529b\u8d8a\u6765\u8d8a\u591a\uff0c\u5c31\u4f1a\u9762\u4e34\u4e09\u4e2a\u95ee\u9898<\/p>\n\n\n\n
1.\u6362\u9879\u76ee\u8981\u91cd\u5199\u6574\u4e2aprompt\uff0c\u4e0d\u77e5\u9053\u54ea\u4e9b\u8be5\u6539\u3001\u54ea\u4e9b\u8be5\u7559
2.\u4fee\u6539\u4e00\u5904\u53ef\u80fd\u5f71\u54cd\u5168\u5c40\uff0c\u52a0\u4e00\u6bb5\u5de5\u5177\u63cf\u8ff0\u53ef\u80fd\u8ddf\u524d\u9762\u7684\u6307\u4ee4\u51b2\u7a81
3.\u6bcf\u6b21\u8bf7\u6c42\u90fd\u5e26\u5168\u90e8\u5185\u5bb9\uff0c\u5373\u4f7f\u5f53\u524d\u5bf9\u8bdd\u7528\u4e0d\u5230\u67d0\u4e9b\u6bb5\u843d\u4e5f\u6d6a\u8d39token<\/p>\n\n\n\n
System prompt\u5e94\u8be5\u662f\u8fd0\u884c\u65f6\u6839\u636e\u5f53\u524d\u72b6\u6001\u7ec4\u88c5\u7684\u914d\u7f6e\uff1a\u54ea\u4e9b\u5de5\u5177\u542f\u7528\u3001\u54ea\u4e9b\u4e0a\u4e0b\u6587\u53ef\u89c1\u3001\u54ea\u4e9b\u8bb0\u5fc6\u76f8\u5173\u3001\u54ea\u4e9b\u5185\u5bb9\u5fc5\u987b\u4fdd\u6301\u7a33\u5b9a\u4ee5\u547d\u4e2dprompt cache\u3002 <\/p>\n\n\n\n
\"System<\/div><\/figure>\n\n\n\n
\u628a\u786c\u7f16\u7801\u7684SYSTEM\u62c6\u6210\u72ec\u7acb\u6bb5\u843d\uff08section\uff09\uff0c\u8fd0\u884c\u65f6\u6839\u636e\u771f\u5b9e\u72b6\u6001\u6309\u9700\u62fc\u63a5\uff0c\u7f13\u5b58\u7ed3\u679c\u907f\u514d\u91cd\u590d\u7ec4\u88c5\u3002<\/p>\n\n\n\n
\u56db\u4e2asection\uff0c\u4e24\u79cd\u52a0\u8f7d\u7b56\u7565<\/strong><\/p>\n\n\n\n
Section<\/th>\u52a0\u8f7d\u7b56\u7565<\/th>\u5185\u5bb9<\/th>\u5224\u65ad\u4f9d\u636e<\/th><\/tr><\/thead>
identity<\/td>\u59cb\u7ec8<\/td>\u4f60\u662f\u8c01\u3001\u600e\u4e48\u505a\u4e8b<\/td>\u59cb\u7ec8\u5b58\u5728<\/td><\/tr>
tools<\/td>\u59cb\u7ec8<\/td>\u53ef\u7528\u5de5\u5177\u5217\u8868<\/td>enabled_tools<\/code><\/td><\/tr>
workspace<\/td>\u59cb\u7ec8<\/td>\u5de5\u4f5c\u76ee\u5f55<\/td>\u59cb\u7ec8\u5b58\u5728<\/td><\/tr>
memory<\/td>\u6309\u9700<\/td>\u76f8\u5173\u8bb0\u5fc6\u5185\u5bb9<\/td>.memory\/MEMORY.md<\/code> \u662f\u5426\u5b58\u5728<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\u5173\u952e\u8bbe\u8ba1\uff1asection\u662f\u5426\u52a0\u8f7d\u53d6\u51b3\u4e8e\u771f\u5b9e\u72b6\u6001\uff08\u5de5\u5177\u662f\u5426\u5b58\u5728\u3001\u6587\u4ef6\u662f\u5426\u5b58\u5728\uff09\uff0c\u4e0d\u662f\u6d88\u606f\u91cc\u7684\u5173\u952e\u8bcd\u3002<\/strong><\/p>\n\n\n\n
PROMPT_SECTIONS\uff1a\u5206\u6bb5\u5b9a\u4e49<\/strong><\/p>\n\n\n\n
\u628a\u4e00\u5927\u6bb5\u5b57\u7b26\u4e32\u62c6\u6210\u5b57\u5178\uff0c\u6bcf\u4e2akey\u662f\u4e00\u4e2a\u4e3b\u9898<\/p>\n\n\n\n
PROMPT_SECTIONS = {\n    \"identity\": \"You are a coding agent. Act, don't explain.\",\n}<\/code><\/pre>\n\n\n\n
\u6bcf\u4e2asection\u72ec\u7acb\u7ef4\u62a4\u3002\u4fee\u6539tools\u4e0d\u5f71\u54cdidentity\uff0c\u65b0\u589ememory\u4e0d\u52a8workspace\u3002<\/p>\n\n\n\n
assemble_system_prompt\uff1a\u6309\u9700\u62fc\u63a5<\/strong><\/p>\n\n\n\n
\u4e0d\u662f\u6240\u6709section\u6bcf\u6b21\u90fd\u9700\u8981\u3002\u5f53\u524d\u6ca1\u6709\u8bb0\u5fc6\u6587\u4ef6\uff0c\u52a0\u8f7dmemory section\u53ea\u662f\u6d6a\u8d39token\u3002\u6839\u636econtext\u7684\u771f\u5b9e\u72b6\u6001\u51b3\u5b9a\u52a0\u8f7d\u54ea\u4e9b<\/p>\n\n\n\n
def assemble_system_prompt(context: dict) -> str:\n    sections = []\n\n    # \u59cb\u7ec8\u52a0\u8f7d\n    sections.append(PROMPT_SECTIONS[\"identity\"])\n\n    # \u4ece context \u52a8\u6001\u83b7\u53d6 tools \u548c workspace\n    tools = \", \".join(context.get(\"enabled_tools\", []))\n    if tools:\n        sections.append(f\"Available tools: {tools}.\")\n    sections.append(f\"Working directory: {context.get(\"workspace\", WORKDIR)}\")\n\n    # \u6309\u9700\u52a0\u8f7d \u2014 \u57fa\u4e8e\u771f\u5b9e\u72b6\u6001\uff0c\u4e0d\u662f\u5173\u952e\u8bcd\n    memories = context.get(\"memories\", \"\")\n    if memories:\n        sections.append(f\"Relevant memories:\\n{memories}\")\n\n    return \"\\n\\n\".join(sections)<\/code><\/pre>\n\n\n\n
“\u59cb\u7ec8\u52a0\u8f7d”<\/strong>\u7684\u662f\u6bcf\u8f6e\u90fd\u9700\u8981\u7684\uff1a\u8eab\u4efd\u3001\u5de5\u5177\u3001\u5de5\u4f5c\u76ee\u5f55\u3002“\u6309\u9700\u52a0\u8f7d”<\/strong>\u7684\u53ea\u662f\u5728\u7279\u5b9a\u6761\u4ef6\u4e0b\u624d\u6709\u7528\uff08\u4e3a\u4ec0\u4e48\u4e0d\u5168\u52a0\u8f7d\uff1ftoken\u6709\u6210\u672c\uff0c\u4fe1\u606f\u8d8a\u5c11LLM\u8d8a\u4e13\u6ce8\uff0c\u4e00\u4e9b\u65e0\u5173\u6307\u4ee4\u662f\u566a\u97f3\uff09<\/p>\n\n\n\n
get_system_prompt\uff1a\u7f13\u5b58\u907f\u514d\u91cd\u590d\u62fc\u63a5<\/strong><\/p>\n\n\n\n
\u4e0a\u4e0b\u6587\u6ca1\u53d8\u65f6\uff0c\u91cd\u65b0\u62fc\u63a5\u662f\u6d6a\u8d39\u3002\u7528\u786e\u5b9a\u6027\u5e8f\u5217\u5316\u68c0\u6d4b\u53d8\u5316\uff0c\u547d\u4e2d\u7f13\u5b58\u76f4\u63a5\u8fd4\u56de<\/p>\n\n\n\n
def get_system_prompt(context: dict) -> str:\n    global _last_context_key, _last_prompt\n    key = json.dumps(context, sort_keys=True, ensure_ascii=False, default=str)\n    if key == _last_context_key and _last_prompt:\n        return _last_prompt\n    _last_context_key = key\n    _last_prompt = assemble_system_prompt(context)\n    return _last_prompt<\/code><\/pre>\n\n\n\n
\u901a\u8fc7\u628acontext\u8fd9\u4e2a\u5b57\u5178\uff0c\u8f6c\u6362\u6210\u4e00\u4e2a\u5c3d\u91cf\u7a33\u5b9a\u3001\u53ef\u6bd4\u8f83\u7684\u5b57\u7b26\u4e32\uff0c\u7136\u540e\u7528\u8fd9\u4e2a\u5b57\u7b26\u4e32\u5224\u65ad\uff0c\u8fd9\u6b21\u7684context\u548c\u4e0a\u4e00\u6b21\u662f\u4e0d\u662f\u4e00\u6837<\/p>\n\n\n\n
context = {\n    \"tools\": [\"read\", \"write\"],\n    \"workspace\": \"\/project\"\n}\n\u5e8f\u5217\u5316\u540e\n{\"tools\": [\"read\", \"write\"], \"workspace\": \"\/project\"}\n\u8bbe\u7f6e\u4e86sort_keys=True\na = {\n    \"tools\": [\"read\"],\n    \"workspace\": \"\/project\"\n}\n\nb = {\n    \"workspace\": \"\/project\",\n    \"tools\": [\"read\"]\n}\n\u5e8f\u5217\u5316\u540ea=b\n<\/code><\/pre>\n\n\n\n
\u7528json.dumps\u800c\u4e0d\u662fhash()\uff1aPython\u5185\u7f6ehash()\u6709\u8fdb\u7a0b\u968f\u673a\u5316\uff0c\u4e0d\u9002\u5408\u505a\u7a33\u5b9acache key\uff0c\u800c\u4e14\u9047\u5230list\/dict\u4f1a\u62a5\u9519<\/p>\n\n\n\n
context\uff1a\u771f\u5b9e\u72b6\u6001\uff0c\u4e0d\u662f\u5173\u952e\u8bcd\u731c\u6d4b<\/strong><\/p>\n\n\n\n
context\u53cd\u6620\u5f53\u524d\u8fd0\u884c\u6001\u7684\u771f\u5b9e\u72b6\u6001<\/p>\n\n\n\n
def update_context(context: dict, messages: list) -> dict:\n    memories = \"\"\n    if MEMORY_INDEX.exists():\n        content = MEMORY_INDEX.read_text().strip()\n        if content:\n            memories = content\n    return {\n        \"enabled_tools\": list(TOOL_HANDLERS.keys()),\n        \"workspace\": str(WORKDIR),\n        \"memories\": memories,\n    }<\/code><\/pre>\n\n\n\n
enabled_tools\u5217\u51fa\u5b9e\u9645\u6ce8\u518c\u7684\u5de5\u5177\u3002memories\u68c0\u67e5.memory\/MEMORY.md\u662f\u5426\u5b58\u5728\u3002section\u52a0\u8f7d\u57fa\u4e8e\u8fd9\u4e9b\u771f\u5b9e\u72b6\u6001\uff0c\u4e0d\u5728\u6d88\u606f\u91cc\u641c\u5173\u952e\u8bcd\u3002<\/p>\n\n\n\n
def agent_loop(messages: list, context: dict):\n    system = get_system_prompt(context)\n    while True:\n        response = client.messages.create(\n            model=MODEL, system=system, messages=messages,\n            tools=TOOLS, max_tokens=8000)\n        # ... \u5de5\u5177\u6267\u884c ...\n        context = update_context(context, messages)\n        system = get_system_prompt(context)<\/code><\/pre>\n\n\n\n
\u6bcf\u8f6e\u5faa\u73af\u5f00\u5934\u62ff\u4e00\u6b21system prompt\u3002context\u53d8\u4e86\u5c31\u91cd\u65b0\u7ec4\u88c5\uff0c\u6ca1\u53d8\u5c31\u8fd4\u56de\u7f13\u5b58\u3002<\/p>\n\n\n\n
\"\"<\/div><\/figure>\n\n\n\n
Error Recovery<\/h1>\n\n\n\n
Agent\u8dd1\u7740\u8dd1\u7740\u62a5\u9519\u4e86\u3002Agent\u5d29\u6e83\u4e86\uff0c\u5b83\u6ca1\u6709\u91cd\u8bd5\uff0c\u6ca1\u6709\u6362\u6a21\u578b\uff0c\u6ca1\u6709\u51cf\u5c11\u4e0a\u4e0b\u6587-\u76f4\u63a5\u5d29\u6e83<\/p>\n\n\n\n
\u751f\u4ea7\u73af\u5883\u4e2dAPI\u9519\u8bef\u662f\u5e38\u6001\u3002\u4e09\u79cd\u6700\u5e38\u89c1\u7684\u6545\u969c\u6a21\u5f0f\uff1a\u8f93\u51fa\u88ab\u622a\u65ad\uff08\u6a21\u578b\u8bdd\u8bf4\u4e00\u534atoken\u7528\u5b8c\u4e86\uff09\u3001\u4e0a\u4e0b\u6587\u8d85\u9650\uff08\u538b\u7f29\u540e\u8fd8\u662f\u592a\u957f\uff09\u3001\u4e34\u65f6\u6545\u969c\uff08429\u9650\u6d41\/529\u8fc7\u8f7d\uff09\u3002\u4e00\u4e2a\u4e0d\u5904\u7406\u9519\u8bef\u7684Agent\u5c31\u50cf\u4e00\u4e2a\u4e00\u78b0\u5c31\u7184\u706b\u7684\u8f66\u3002<\/p>\n\n\n\n
\"Error<\/div><\/figure>\n\n\n\n
\u5c06LLM\u8c03\u7528\u5305\u88f9\u5728try\/except\u91cc\uff0c\u6839\u636e\u9519\u8bef\u7c7b\u578b\u8d70\u4e0d\u540c\u7684\u6062\u590d\u8def\u5f84\u3002\u6062\u590d\u540econtinue\u56de\u5230\u5faa\u73af\u5f00\u5934\u91cd\u65b0\u8c03\u7528LLM<\/p>\n\n\n\n
\u4e09\u79cd\u6700\u5e38\u89c1\u7684\u6062\u590d\u6a21\u5f0f<\/p>\n\n\n\n
\u6a21\u5f0f<\/th>\u89e6\u53d1<\/th>\u6062\u590d\u52a8\u4f5c<\/th><\/tr><\/thead>
\u8f93\u51fa\u622a\u65ad<\/td>max_tokens<\/code><\/td>\u5347\u7ea7 8K\u219264K \/ \u7eed\u5199\u63d0\u793a<\/td><\/tr>
\u4e0a\u4e0b\u6587\u8d85\u9650<\/td>prompt_too_long<\/code><\/td>reactive compact \u2192 \u91cd\u8bd5<\/td><\/tr>
\u4e34\u65f6\u6545\u969c<\/td>429 \/ 529<\/td>\u6307\u6570\u9000\u907f + \u6296\u52a8\uff0c\u8fde\u7eed 529 \u53ef\u5207\u6362\u5907\u7528\u6a21\u578b<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\u8def\u5f841\uff1a\u8f93\u51fa\u88ab\u622a\u65ad<\/strong><\/p>\n\n\n\n
\u6a21\u578b\u8bdd\u8bf4\u4e00\u534a\uff0cmax_tokens\u7528\u5b8c\u4e86\u3002\u9ed8\u8ba48000 token\u4e0d\u591f\u5b83\u8f93\u51fa\u5b8c\u6574\u56de\u7b54\u3002\u7b2c\u4e00\u6b21\u53d1\u751f\u65f6\uff0c\u76f4\u63a5\u628amax_tokens\u4ece8K\u5347\u7ea7\u523064K\uff0c\u91cd\u8bd5\u540c\u4e00 \u8bf7\u6c42-\u6b64\u65f6\u4e0d\u8ffd\u52a0\u622a\u65ad\u8f93\u51fa\u5230messages\uff0c\u4fdd\u6301\u539f\u59cb\u8bf7\u6c42\u4e0d\u53d8\u3002\u5982\u679c64K\u8fd8\u662f\u4e0d\u591f\uff0c\u624d\u4fdd\u5b58\u622a\u65ad\u8f93\u51fa\u5e76\u6ce8\u5165\u7eed\u5199\u63d0\u793a\u8ba9\u6a21\u578b\u63a5\u7740\u521a\u624d\u7684\u8bdd\u7ee7\u7eed\u8bf4\u6700\u591a3\u6b21<\/p>\n\n\n\n
if response.stop_reason == \"max_tokens\":\n    # First escalation: don't append truncated output, retry same request\n    if not state.has_escalated:\n        max_tokens = ESCALATED_MAX_TOKENS\n        state.has_escalated = True\n        continue  # messages unchanged, same request with more tokens\n    # 64K still truncated: save output + continuation prompt\n    messages.append({\"role\": \"assistant\", \"content\": response.content})\n    if state.recovery_count < MAX_RECOVERY_RETRIES:\n        messages.append({\"role\": \"user\", \"content\":\n            \"Output token limit hit. Resume directly \u2014 \"\n            \"no apology, no recap. Pick up mid-thought.\"})\n        state.recovery_count += 1\n        continue\n    return  # still truncated after 3 continuations\n# Normal: append after max_tokens check\nmessages.append({\"role\": \"assistant\", \"content\": response.content})<\/code><\/pre>\n\n\n\n
\u8def\u5f842\uff1a\u4e0a\u4e0b\u6587\u8d85\u9650<\/strong><\/p>\n\n\n\n
LLM\u8bf4”\u4f60\u7684\u4e0a\u4e0b\u6587\u592a\u957f\u4e86”\uff0c\u867d\u7136\u901a\u8fc7\u524d\u9762\u7684\u538b\u7f29\u6280\u672f\u5168\u8dd1\u8fc7\u4e86\uff0c\u8fd8\u662f\u8d85\u4e86\u3002<\/p>\n\n\n\n
\u89e6\u53d1reactive compact-\u6bd4auto compact\u66f4\u6fc0\u8fdb\u3002\u53ea\u4fdd\u7559\u6700\u540e5\u6761\u6d88\u606f\u6a21\u62df\u538b\u7f29\u6548\u679c\u3002\u4f46\u5982\u679c\u538b\u7f29\u8fc7\u4e00\u6b21\u8fd8\u662f\u8d85\u9650\uff0c\u53ea\u80fd\u9000\u51fa-\u518d\u538b\u7f29\u4e5f\u4e0d\u4f1a\u53d8\u5c0f<\/p>\n\n\n\n
except PromptTooLongError:\n    if not state.has_attempted_reactive_compact:\n        messages[:] = reactive_compact(messages)\n        state.has_attempted_reactive_compact = True\n        continue\n    return  # \u538b\u7f29\u8fc7\u4e86\u8fd8\u662f\u8d85\u9650\uff0c\u53ea\u80fd\u9000\u51fa<\/code><\/pre>\n\n\n\n
\u8def\u5f843\uff1a\u4e34\u65f6\u6545\u969c<\/strong><\/p>\n\n\n\n
\u7f51\u7edc\u6296\u52a8\u3001429\u9650\u6d41\u3001529\u8fc7\u8f7d-\u8fd9\u4e9b\u4e0d\u662fbug\uff0c\u662f\u5206\u5e03\u5f0f\u7cfb\u7edf\u7684\u5e38\u6001\u3002<\/p>\n\n\n\n
429\u548c529\u7edf\u4e00\u8d70\u6307\u6570\u9000\u907f+\u6296\u52a8\uff1a\u7b2c\u4e00\u6b21\u7b490.5\u79d2\uff0c\u7b2c\u4e8c\u6b21\u7b491\u79d2\uff0c\u7b2c\u4e09\u6b21\u7b492\u79d2\uff0c\u6700\u591a10\u6b21\u3002\u52a0\u968f\u673a\u6296\u52a8\u8ba9\u5e76\u53d1\u8bf7\u6c42\u4e0d\u5728\u540c\u4e00\u65f6\u523b\u91cd\u8bd5\u3002\u8fde\u7eed3\u6b21529\u8fc7\u8f7d->\u5207\u6362\u5230\u5907\u7528\u6a21\u578b<\/p>\n\n\n\n
def retry_delay(attempt, retry_after=None):\n    if retry_after:\n        return retry_after\n    base = min(500 * (2 ** attempt), 32000) \/ 1000\n    return base + random.uniform(0, base * 0.25)\n\ndef with_retry(fn, state, max_retries=10):\n    for attempt in range(max_retries):\n        try:\n            return fn()\n        except (RateLimitError, OverloadedError):\n            delay = retry_delay(attempt)\n            time.sleep(delay)\n            if is_overloaded:\n                state.consecutive_529 += 1\n                if state.consecutive_529 >= 3 and FALLBACK_MODEL:\n                    state.current_model = FALLBACK_MODEL\n    raise MaxRetriesExceeded()<\/code><\/pre>\n\n\n\n
\u9000\u907f\u516c\u5f0f\uff1amin(500 * 2 ** attempt,32000) + random(0~25%)\u3002\u5982\u679c\u670d\u52a1\u5668\u8fd4\u56deRetry-After header\uff0c\u4f18\u5148\u7528\u90a3\u4e2a\u503c\u3002<\/strong><\/p>\n\n\n\n
def agent_loop(messages, context):\n    system = get_system_prompt(context)\n    state = RecoveryState()\n    max_tokens = 8000\n\n    while True:\n        try:\n            response = with_retry(\n                lambda: client.messages.create(\n                    model=state.current_model, system=system,\n                    messages=messages, tools=TOOLS,\n                    max_tokens=max_tokens),\n                state)\n        except Exception as e:\n            if is_prompt_too_long_error(e):\n                if not state.has_attempted_reactive_compact:\n                    messages[:] = reactive_compact(messages)\n                    state.has_attempted_reactive_compact = True\n                    continue\n                return\n            log_error(e)\n            return\n\n        # max_tokens check BEFORE appending to messages\n        if response.stop_reason == \"max_tokens\":\n            if not state.has_escalated:\n                max_tokens = 64000\n                state.has_escalated = True\n                continue  # retry same request, messages unchanged\n            # save truncated output + continuation prompt\n            messages.append({\"role\": \"assistant\", \"content\": response.content})\n            messages.append({\"role\": \"user\", \"content\": CONTINUATION_PROMPT})\n            continue\n        # Normal completion\n        messages.append({\"role\": \"assistant\", \"content\": response.content})\n\n        if response.stop_reason != \"tool_use\":\n            return\n        # ... tool execution ...<\/code><\/pre>\n\n\n\n
\u5916\u5c42try\/except\u6355\u83b7API\u5f02\u5e38\uff08prompt_too_long\u7b49\uff09\uff0cwith_retry\u5904\u7406\u77ac\u6001\u9519\u8bef\uff08429\/529\uff09\uff0cstop_reason\u68c0\u67e5\u5904\u7406\u622a\u65ad\u3002\u4e09\u79cd\u6062\u590d\u673a\u5236\u5404\u7ba1\u5404\u7684\u9519\u8bef\u7c7b\u578b\u3002<\/p>\n\n\n\n
Task System<\/h1>\n\n\n\n
Agent\u63a5\u5230\u4e00\u4e2a\u9879\u76ee\uff1a\u642d\u5efa\u6570\u636e\u5e93\u3001\u5199API\u3001\u52a0\u6d4b\u8bd5\uff0c\u7528TodoWrite\u5217\u4e86\u4e00\u5f20\u6e05\u5355\uff0c\u7136\u540e\u5f00\u59cb\u5199API\uff0c\u5199\u5230\u4e00\u534a\u53d1\u73b0\u6ca1\u6570\u636e\u5e93\u8868\uff0c\u56de\u5934\u8865\uff1b\u52a0\u6d4b\u8bd5\u65f6\u53d1\u73b0API\u63a5\u53e3\u7b7e\u540d\u53c8\u53d8\u4e86<\/p>\n\n\n\n
\u76d6\u623f\u5b50\u4e0d\u80fd\u5148\u76d6\u5c4b\u9876\u518d\u6253\u5730\u57fa\u3002\u4efb\u52a1\u4e4b\u95f4\u6709\u5148\u540e\u3002\u4efb\u52a1\u4f9d\u8d56\u5e94\u8be5\u5f62\u6210\u6709\u5411\u65e0\u73af\u56fe\u3002\u524d\u9762\u7684TodoWrite\u662f\u5f53\u524d\u4efb\u52a1\u7684\u6267\u884c\u6e05\u5355\uff0c\u4fdd\u5b58\u5728\u4f1a\u8bdd\u5185\u5b58\u4e2d\u3002\u8fd9\u91cc\u9700\u8981\u7684\u662f\u4efb\u52a1\u7cfb\u7edf\uff1a\u6bcf\u4e2a\u4efb\u52a1\u662f\u4e00\u4e2aJSON\u6587\u4ef6\uff0c\u4efb\u52a1\u4e4b\u95f4\u6709blockedBy\u4f9d\u8d56\uff0c\u8de8\u4f1a\u8bdd\u6301\u4e45\u5316\u5728\u78c1\u76d8\u4e0a\u3002<\/p>\n\n\n\n
\u8fd9\u91cc\u7684\u4f9d\u8d56\u6307\u7684\u662f\u5728\u8fd0\u884c\u5f53\u524d\u4efb\u52a1\u4e4b\u524d\uff0c\u8be5\u4efb\u52a1\u88ab\u54ea\u4e9b\u4efb\u52a1\u963b\u585e<\/p>\n\n\n\n
Task(\n    id=\"T4\",\n    subject=\"\u90e8\u7f72\",\n    description=\"\u90e8\u7f72\u6700\u7ec8\u9879\u76ee\",\n    status=\"pending\",\n    owner=\"agent_deploy\",\n    blockedBy=[\"T2\", \"T3\"]\n)\n      T2 \u2500\u2500\u2510\n           \u251c\u2500\u2500\u2192 T4\n      T3 \u2500\u2500\u2518\n\u53ea\u6709\u5f53T2\u3001T3\u90fd\u5b8c\u6210T4\u624d\u4f1a\u5f00\u59cb<\/code><\/pre>\n\n\n\n
\"Task<\/div><\/figure>\n\n\n\n
\u5de5\u4f5c\u539f\u7406<\/p>\n\n\n\n
\"Task<\/div><\/figure>\n\n\n\n
Task\uff1a\u6570\u636e\u7ed3\u6784<\/strong><\/p>\n\n\n\n
\u6bcf\u4e2a\u4efb\u52a1\u662f\u4e00\u4e2aJSON\u6587\u4ef6\uff0c\u5b58\u4e8e.tasks\/\u76ee\u5f55<\/p>\n\n\n\n
@dataclass\nclass Task:\n    id: str\n    subject: str\n    description: str\n    status: str          # pending | in_progress | completed\n    owner: str | None    # Agent \u540d\uff08\u591a Agent \u573a\u666f\uff09\n    blockedBy: list[str] # \u4f9d\u8d56\u7684\u4efb\u52a1 ID \u5217\u8868<\/code><\/pre>\n\n\n\n
\u4f9d\u8d56\u7684\u4efb\u52a1ID \u7528 timestamp + random hex\u751f\u6210\uff0c\u7b80\u5355\u591f\u7528\u3002<\/p>\n\n\n\n
create_task\uff1a\u521b\u5efa\u4efb\u52a1<\/strong><\/p>\n\n\n\n
def create_task(subject: str, description: str = \"\",\n                blockedBy: list[str] | None = None) -> Task:\n    task = Task(\n        id=f\"task_{int(time.time())}_{random_hex(4)}\",\n        subject=subject, description=description,\n        status=\"pending\", owner=None,\n        blockedBy=blockedBy or [],\n    )\n    save_task(task)\n    return task<\/code><\/pre>\n\n\n\n
\u521b\u5efa\u65f6\u81ea\u52a8save_task\u5230.tasks\/{id}.json\u3002blockedBy\u58f0\u660e\u4f9d\u8d56\uff0c\u6bd4\u5982”\u5199API”\u7684blockedBy\u662f[“task_schema”]<\/p>\n\n\n\n
can_start\uff1a\u4f9d\u8d56\u68c0\u67e5<\/strong><\/p>\n\n\n\n
\u4e00\u4e2a\u4efb\u52a1\u53ea\u80fd\u5728\u5b83\u7684blockedBy\u5168\u90e8completed\u4e4b\u540e\u624d\u80fd\u5f00\u59cb<\/p>\n\n\n\n
def can_start(task_id: str) -> bool:\n    task = load_task(task_id)\n    for dep_id in task.blockedBy:\n        if not _task_path(dep_id).exists():\n            return False  # missing dependency = blocked\n        dep = load_task(dep_id)\n        if dep.status != \"completed\":\n            return False\n    return True<\/code><\/pre>\n\n\n\n
can_start\u662fclaim_task\u7684\u524d\u7f6e\u68c0\u67e5\uff1ablockedBy\u91cc\u6709\u4efb\u4f55\u4e00\u4e2a\u4e0d\u662fcompleted\uff0c\u5c31\u4e0d\u80fd\u8ba4\u9886\u3002\u4e0d\u5b58\u5728\u7684\u4f9d\u8d56\u89c6\u4e3ablocked\uff0c\u907f\u514d\u5f15\u7528\u9519\u8befID\u65f6\u5d29\u6e83<\/p>\n\n\n\n
claim_task\uff1a\u8ba4\u9886\u4efb\u52a1<\/strong><\/p>\n\n\n\n
Agent\u5f00\u59cb\u505a\u4e00\u4e2a\u4efb\u52a1\u65f6\uff0c\u8c03\u7528claim_task\uff1a\u8bbe\u7f6eowner\uff0c\u72b6\u6001\u4ecepending -> in_progress\u3002owner\u5b57\u6bb5\u8bb0\u5f55\u8c01\u5728\u505a\u4e2a\u4efb\u52a1\uff0c\u591aAgent\u573a\u666f\u4e0b\u9632\u6b62\u91cd\u590d\u8ba4\u9886<\/p>\n\n\n\n
def claim_task(task_id: str, owner: str = \"agent\") -> str:\n    task = load_task(task_id)\n    if task.status != \"pending\":\n        return f\"Task {task_id} is {task.status}, cannot claim\"\n    if not can_start(task_id):\n        deps = [d for d in task.blockedBy\n                if load_task(d).status != \"completed\"]\n        return f\"Blocked by: {deps}\"\n    task.owner = owner\n    task.status = \"in_progress\"\n    save_task(task)\n    return f\"Claimed {task_id} ({task.subject})\"<\/code><\/pre>\n\n\n\n
\u5982\u679c\u4efb\u52a1\u5df2\u88ab\u522b\u4eba\u8ba4\u9886\uff08status != “pending”\uff09\uff0c\u6216\u8005\u4f9d\u8d56\u6ca1\u5b8c\u6210\uff08can_start\u8fd4\u56deFalse\uff09\uff0c\u62d2\u7edd\u8ba4\u9886\u3002<\/p>\n\n\n\n
complete_task\uff1a\u5b8c\u6210\u4e0e\u89e3\u9501<\/strong><\/p>\n\n\n\n
\u4efb\u52a1\u505a\u5b8c\u540e\uff0c\u8bbe\u4e3acompleted\u3002\u540c\u65f6\u626b\u63cf\u6240\u6709\u5176\u4ed6\u4efb\u52a1\uff0c\u627e\u51fa\u521a\u521a\u88ab\u89e3\u9501\u7684\u4e0b\u6e38\u4efb\u52a1\uff1a<\/p>\n\n\n\n
def complete_task(task_id: str) -> str:\n    task = load_task(task_id)\n    task.status = \"completed\"\n    save_task(task)\n    # \u627e\u51fa\u88ab\u89e3\u9501\u7684\u4e0b\u6e38\u4efb\u52a1\n    unblocked = [t.subject for t in list_tasks()\n                 if t.status == \"pending\" and t.blockedBy\n                 and can_start(t.id)]\n    msg = f\"Completed {task_id} ({task.subject})\"\n    if unblocked:\n        msg += f\"\\nUnblocked: {', '.join(unblocked)}\"\n    return msg<\/code><\/pre>\n\n\n\n
\u5b8c\u6210”schema”\u540e\uff0c”endpoints”\u548c”docs”\u7684can_start\u8fd4\u56deTrue\uff0c\u5b83\u4eec\u53ef\u4ee5\u5f00\u59cb\u3002<\/p>\n\n\n\n
get_task\uff1a\u67e5\u770b\u5b8c\u6574\u7ec6\u8282<\/strong><\/p>\n\n\n\n
list_tasks\u53ea\u663e\u793a\u4e00\u884c\u6458\u8981\u3002get_task\u8fd4\u56de\u5b8c\u6574\u7684\u4efb\u52a1JSON\uff0c\u5305\u62ecdescription\u548c\u4f9d\u8d56\u7ec6\u8282\u3002\u8de8\u4f1a\u8bdd\u6062\u590d\u65f6\uff0cAgent\u9700\u8981\u8bfb\u53d6\u5b8c\u6574\u63cf\u8ff0\u624d\u80fd\u7ee7\u7eed\u5de5\u4f5c<\/p>\n\n\n\n
def get_task(task_id: str) -> str:\n    task = load_task(task_id)\n    return json.dumps(asdict(task), indent=2)<\/code><\/pre>\n\n\n\n
\u72b6\u6001\u673a\uff1a\u4e24\u4e2a\u52a8\u4f5c\uff0c\u4e09\u4e2a\u72b6\u6001<\/strong><\/p>\n\n\n\n
pending \u2500\u2500claim\u2500\u2500\u2192 in_progress \u2500\u2500complete\u2500\u2500\u2192 completed<\/code><\/pre>\n\n\n\n
\u8fd9\u91cc\u7684claim\/complete\u662f\u52a8\u4f5c\uff0cpending\/in_progress\/completed\u662f\u72b6\u6001\uff1a<\/p>\n\n\n\n
    \n
  • claim_task\uff1apending -> in_progress\u3002\u8bbe\u7f6eowner\uff0c\u5f00\u59cb\u5de5\u4f5c\u3002<\/li>\n\n\n\n
  • complete_task\uff1ain_progress -> completed\u3002\u628a\u4efb\u52a1\u6807\u8bb0\u4e3a\u5b8c\u6210\uff0c\u5e76\u89e3\u9501\u4e0b\u6e38\u3002<\/li>\n<\/ul>\n\n\n\n
    CC\u6ca1\u6709in_progress -> pending\u7684release\u8def\u5f84\u3002\u5982\u679cteammate\u7ec8\u6b62\u6216shutdown\uff0cCC\u4f1a\u628a\u5b83\u672a\u5b8c\u6210\u7684\u4efb\u52a1unassign\uff08\u6e05\u9664owner\uff09\uff0c\u5e76\u5c06status\u91cd\u7f6e\u4e3apending\uff0c\u65b9\u4fbf\u5176\u4ed6agent\u91cd\u65b0\u8ba4\u9886\u3002<\/p>\n\n\n\n
    # \u521b\u5efa\u6709\u4f9d\u8d56\u7684\u4efb\u52a1\nschema = create_task(\"setup database schema\")\nendpoints = create_task(\"create API endpoints\", blockedBy=[schema.id])\ntests = create_task(\"write tests\", blockedBy=[endpoints.id])\ndocs = create_task(\"write docs\", blockedBy=[schema.id])\n\n# Agent \u8ba4\u9886\u7b2c\u4e00\u4e2a\u53ef\u505a\u7684\u4efb\u52a1\nclaim_task(schema.id)       # \u2713 Claimed (\u65e0\u4f9d\u8d56)\ncomplete_task(schema.id)    # \u2713 Completed \u2192 \u89e3\u9501 endpoints, docs\n\nclaim_task(endpoints.id)    # \u2713 Claimed (schema \u5df2\u5b8c\u6210)\ncomplete_task(endpoints.id) # \u2713 Completed \u2192 \u89e3\u9501 tests\n\nclaim_task(docs.id)         # \u2713 Claimed (schema \u5df2\u5b8c\u6210)\ncomplete_task(docs.id)      # \u2713 Completed\n\nclaim_task(tests.id)        # \u2713 Claimed (endpoints \u5df2\u5b8c\u6210)\ncomplete_task(tests.id)     # \u2713 Completed<\/code><\/pre>\n\n\n\n
    \u5355Agent\u53ea\u80fd\u987a\u5e8f\u5b8c\u6210task\uff0c\u4f46\u662f\u5f53\u591aAgent\u7684\u60c5\u51b5\u4e0bendpoints\u548cdocs\u53ef\u4ee5\u540c\u65f6\u8fdb\u884c\u3002\u6bcf\u4e2acreate_task\u5199\u4e00\u4e2aJOSN\u6587\u4ef6\uff0c\u6bcf\u4e2aclaim_task\/complete_task\u66f4\u65b0\u6587\u4ef6\u3002\u8de8\u4f1a\u8bdd\u65f6\uff0c.tasks\/\u76ee\u5f55\u8fd8\u5728\uff0cAgent\u8bfb\u6587\u4ef6\u5c31\u80fd\u6062\u590d\u8fdb\u5ea6\u3002<\/p>\n\n\n\n
    \"\"<\/div><\/figure>\n\n\n\n
    Background Tasks<\/h1>\n\n\n\n
    \u7c7b\u6bd4\u6d17\u8863\u673a\uff0c\u628a\u8863\u670d\u6254\u8fdb\u53bb\uff0c\u6309\u4e0b\u542f\u52a8\uff0c\u7136\u540e\u53bb\u522b\u7684\u4e8b\u60c5\u300230min\u540e\u6d17\u8863\u673a\u63d0\u9192\u6d17\u597d\u4e86\u8863\u670d\uff0c\u8fd930\u5206\u949f\u4e0d\u9700\u8981\u5e72\u7b49\u800c\u662f\u53ef\u4ee5\u5e72\u81ea\u5df1\u7684\u4e8b\u60c5\u3002<\/p>\n\n\n\n
    Agent\u7684bash\u5de5\u5177\u4e5f\u4e00\u6837\u3002pip install torch\u8981\u7b4910min\uff0cnpm run build \u89813min\u3002\u8fd9\u4e9b\u547d\u4ee4\u4e00\u8dd1\uff0cAgent\u5c31\u5728\u7b49bash\u5de5\u5177\u8fd4\u56de\uff0c\u6ca1\u6cd5\u5229\u7528\u8fd9\u6bb5\u65f6\u95f4\u5904\u7406\u522b\u7684\u4efb\u52a1\u3002\u8bfb\u6587\u4ef6\u662f\u6beb\u79d2\u7ea7\uff0c\u4e0d\u9700\u8981\u7b49\u5f85\u3002git status\u4e00\u79d2\u949f\u5185\u8fd4\u56de\uff0c\u4e0d\u9700\u8981\u7b49\u5f85\u3002\u4f46\u662fnpm install\uff1f\u5206\u949f\u7ea7\u3002Agent\u7b4910min\u4ec0\u4e48\u90fd\u4e0d\u505a\uff0c\u800cLLM\u6309token\u8ba1\u8d39\uff0c\u7a7a\u8f6c\u5c31\u662f\u6d6a\u8d39\u3002<\/p>\n\n\n\n
    \"Background<\/div><\/figure>\n\n\n\n
    \u91c7\u7528\u6162\u64cd\u4f5c\u4e22\u540e\u53f0\uff0cagent\u7ee7\u7eed\u5904\u7406-\u540e\u53f0\u7ebf\u7a0b\u8dd1\u547d\u4ee4\uff0c\u5b8c\u6210\u540e\u6ce8\u5165\u901a\u77e5\u3002<\/strong><\/p>\n\n\n\n
    should_run_background\uff1a\u663e\u793a\u8bf7\u6c42\u4f18\u5148\uff0c\u542f\u53d1\u5f0f\u515c\u5e95<\/strong><\/p>\n\n\n\n
    \u6a21\u578b\u901a\u8fc7bash\u5de5\u5177\u7684run_in_background\u53c2\u6570\u663e\u793a\u8bf7\u6c42\u540e\u53f0\u6267\u884c\u3002\u5982\u679c\u6a21\u578b\u6ca1\u6307\u5b9a\uff0c\u8fd9\u91cc\u7528\u5173\u952e\u8bcd\u542f\u53d1\u5f0f\u515c\u5e95<\/p>\n\n\n\n
    def is_slow_operation(tool_name: str, tool_input: dict) -> bool:\n    \"\"\"Fallback heuristic: commands likely to take > 30s.\"\"\"\n    if tool_name != \"bash\":\n        return False\n    cmd = tool_input.get(\"command\", \"\").lower()\n    slow_keywords = [\"install\", \"build\", \"test\", \"deploy\", \"compile\",\n                     \"docker build\", \"pip install\", \"npm install\",\n                     \"cargo build\", \"pytest\", \"make\"]\n    return any(kw in cmd for kw in slow_keywords)\n\ndef should_run_background(tool_name: str, tool_input: dict) -> bool:\n    \"\"\"Model explicit request takes priority; fallback to heuristic.\"\"\"\n    if tool_input.get(\"run_in_background\"):\n        return True\n    return is_slow_operation(tool_name, tool_input)<\/code><\/pre>\n\n\n\n
    CC\u7684bash\u5de5\u5177schema\u91cc\u6709run_in_background:boolean\u53c2\u6570\u3002\u6a21\u578b\u81ea\u5df1\u51b3\u5b9a\u54ea\u4e9b\u547d\u4ee4\u4e22\u540e\u53f0\uff0c\u4e0d\u9760\u5173\u952e\u8bcd\u731c\u3002<\/p>\n\n\n\n
    start_background_task\uff1a\u540e\u53f0\u6267\u884c\u4e0e\u751f\u547d\u5468\u671f<\/strong><\/p>\n\n\n\n
    \u628a\u5de5\u5177\u8c03\u7528\u5305\u88c5\u6210worker\u51fd\u6570\uff0c\u6254\u5230daemon\u7ebf\u7a0b\u91cc\u6267\u884c\u3002\u6bcf\u4e2a\u540e\u53f0\u6267\u884c\u4efb\u52a1\u6709\u552f\u4e00ID\uff0c\u72b6\u6001\u5b58\u5728background_tasks\u5b57\u5178\u91cc<\/p>\n\n\n\n
    _bg_counter = 0\nbackground_tasks: dict[str, dict] = {}   # bg_id \u2192 {tool_use_id, command, status}\nbackground_results: dict[str, str] = {}   # bg_id \u2192 output\nbackground_lock = threading.Lock()\n\ndef start_background_task(block) -> str:\n    \"\"\"Run tool in a daemon thread. Returns background task ID.\"\"\"\n    global _bg_counter\n    _bg_counter += 1\n    bg_id = f\"bg_{_bg_counter:04d}\"\n\n    def worker():\n        result = execute_tool(block)\n        with background_lock:\n            background_tasks[bg_id][\"status\"] = \"completed\"\n            background_results[bg_id] = result\n\n    with background_lock:\n        background_tasks[bg_id] = {\n            \"tool_use_id\": block.id,\n            \"command\": block.input.get(\"command\", \"\"),\n            \"status\": \"running\",\n        }\n    thread = threading.Thread(target=worker, daemon=True)\n    thread.start()\n    return bg_id<\/code><\/pre>\n\n\n\n
    \u8fd4\u56debg_id\u800c\u4e0d\u662f\u53ea\u8fd4\u56de[Running in background…]\u3002daemon=True\u786e\u4fddAgent\u8fdb\u7a0b\u9000\u51fa\u65f6\u7ebf\u7a0b\u8ddf\u7740\u9000\u51fa\u3002<\/p>\n\n\n\n
    collect_background_results\uff1a\u901a\u77e5\u6536\u96c6<\/strong><\/p>\n\n\n\n
    \u540e\u53f0\u4efb\u52a1\u5b8c\u6210\u540e\uff0c\u6536\u96c6\u7ed3\u679c\u5e76\u683c\u5f0f\u5316\u4e3a <task_notification>\u901a\u77e5\uff1a<\/p>\n\n\n\n
    def collect_background_results() -> list[str]:\n    \"\"\"Collect completed results as task_notification messages.\"\"\"\n    with background_lock:\n        ready_ids = [bid for bid, task in background_tasks.items()\n                     if task[\"status\"] == \"completed\"]\n    notifications = []\n    for bg_id in ready_ids:\n        with background_lock:\n            task = background_tasks.pop(bg_id)\n            output = background_results.pop(bg_id, \"\")\n        notifications.append(\n            f\"<task_notification>\\n\"\n            f\"  <task_id>{bg_id}<\/task_id>\\n\"\n            f\"  <status>completed<\/status>\\n\"\n            f\"  <command>{task['command']}<\/command>\\n\"\n            f\"  <summary>{output[:200]}<\/summary>\\n\"\n            f\"<\/task_notification>\")\n    return notifications<\/code><\/pre>\n\n\n\n
    \u901a\u77e5\u4e0d\u590d\u7528\u539f\u59cbtool_use_id\u3002\u539f\u59cbtool call\u5df2\u7ecf\u7528\u5360\u4f4dtool_result\u56de\u590d\u4e86\uff0c\u540e\u53f0\u5b8c\u6210\u662f\u72ec\u7acb\u4e8b\u4ef6\uff0c\u7528task_notification\u683c\u5f0f\u6ce8\u5165\u3002\u8fd9\u7b26\u5408Message API\u7684\u5de5\u5177\u914d\u5bf9\u8bed\u4e49\uff1a\u4e00\u4e2atool_use\u53ea\u5bf9\u5e94\u4e00\u4e2atool_result\u3002<\/p>\n\n\n\n
    agent_loop\u91cc\uff0c\u5de5\u5177\u6267\u884c\u5206\u4e24\u6761\u8def\uff0c\u901a\u77e5\u548c\u7ed3\u679c\u5408\u5e76\u4e3a\u4e00\u6761user\u6d88\u606f<\/p>\n\n\n\n
    results = []\nfor block in response.content:\n    if block.type != \"tool_use\":\n        continue\n    if should_run_background(block.name, block.input):\n        bg_id = start_background_task(block)\n        results.append({\"type\": \"tool_result\",\n            \"tool_use_id\": block.id,\n            \"content\": f\"[Background task {bg_id} started] \"\n                       f\"Result will be available when complete.\"})\n    else:\n        output = execute_tool(block)\n        results.append({\"type\": \"tool_result\",\n            \"tool_use_id\": block.id, \"content\": output})\n\n# \u901a\u77e5\u548c\u5de5\u5177\u7ed3\u679c\u5408\u5165\u540c\u4e00\u6761 user \u6d88\u606f\nuser_content = []\nbg_notifications = collect_background_results()\nif bg_notifications:\n    for notif in bg_notifications:\n        user_content.append({\"type\": \"text\", \"text\": notif})\nuser_content.extend(results)\nmessages.append({\"role\": \"user\", \"content\": user_content})<\/code><\/pre>\n\n\n\n
    \u6162\u64cd\u4f5c\u5148\u56de\u4e00\u4e2a\u5e26bg_id\u7684\u5360\u4f4dtool_result\uff0cLLM\u77e5\u9053\u8fd9\u4e2a\u547d\u4ee4\u8fd8\u5728\u8dd1\uff0c\u53ef\u4ee5\u5148\u505a\u522b\u7684\u4e8b\u3002\u540e\u53f0\u5b8c\u6210\u540e\uff0c\u901a\u77e5\u4f5c\u4e3a\u72ec\u7acbtext block\u548c\u5f53\u524d\u8f6e\u7684tool_result\u4e00\u8d77\u7ec4\u6210user\u6d88\u606f\u3002<\/p>\n\n\n\n
    \"\"<\/div><\/figure>\n\n\n\n
    Cron Scheduler-\u6309\u65f6\u95f4\u8868\u751f\u4ea7\u5de5\u4f5c<\/h1>\n\n\n\n
    \u524d\u9762\u8ba9Agent\u80fd\u540e\u53f0\u6267\u884c\u6162\u64cd\u4f5c\uff0c\u4f46\u6240\u6709\u64cd\u4f5c\u4ecd\u7136\u662f\u4f60\u624b\u52a8\u89e6\u53d1\u7684\u3002\u4f60\u8bf4\u4e00\u53e5\uff0cAgent\u52a8\u4e00\u4e0b\u3002”\u6bcf\u5929\u65e9\u4e0a9\u70b9\u8dd1\u6d4b\u8bd5”\u3001”\u6bcf30\u5206\u949f\u68c0\u67e5CI\u72b6\u6001”\uff0c\u8fd9\u4e9b\u5468\u671f\u6027\u4efb\u52a1\u4e0d\u8be5\u9700\u8981\u4eba\u6bcf\u6b21\u6765\u63a8\u3002<\/p>\n\n\n\n
    \"Cron<\/div><\/figure>\n\n\n\n
    \u901a\u8fc7\u72ec\u7acb\u7684cron\u8c03\u5ea6\u7ebf\u7a0b\uff0c\u6bcf\u79d2\u68c0\u67e5\u4e00\u6b21\uff0c\u65f6\u95f4\u5230\u4e86\u628a\u8ba9\u4efb\u52a1\u585e\u8fdbcron_queue\uff1b\u518d\u7531queue processor\u5728Agent\u7a7a\u95f2\u65f6\u81ea\u52a8\u4ea4\u4ed8\u3002<\/p>\n\n\n\n
    \u624b\u52a8 vs \u5b9a\u65f6<\/p>\n\n\n\n
    <\/td>\u624b\u52a8\u89e6\u53d1<\/td>\u5b9a\u65f6\u89e6\u53d1<\/td><\/tr>
    \u89e6\u53d1\u8005<\/td>\u7528\u6237\u8f93\u5165<\/td>\u8c03\u5ea6\u7ebf\u7a0b<\/td><\/tr>
    \u89e6\u53d1\u65f6\u673a<\/td>\u968f\u65f6<\/td>cron \u8868\u8fbe\u5f0f\u6307\u5b9a<\/td><\/tr>
    \u9700\u8981\u4eba\u53c2\u4e0e<\/td>\u662f<\/td>\u5426\uff08\u8c03\u5ea6\u5668\u81ea\u52a8\u5165\u961f\uff0c\u7a7a\u95f2\u65f6\u81ea\u52a8\u4ea4\u4ed8\uff09<\/td><\/tr>
    \u6301\u4e45\u6027<\/td>\u2014<\/td>durable \u8de8\u91cd\u542f<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    \u56db\u5c42\u6a21\u578b<\/strong><\/p>\n\n\n\n
    Cron\u8c03\u5ea6\u5206\u56db\u5c42\uff1a<\/p>\n\n\n\n
    1.Scheduler\uff1adaemon\u7ebf\u7a0b\uff0c\u6bcf\u79d2\u8f6e\u8be2\u5417\uff0c\u5224\u65ad\u65f6\u95f4\u5230\u4e86\u6ca1\u6709
    2.Queue\uff1acron_queue\uff0c\u8c03\u5ea6\u7ebf\u7a0b\u5199\u5165\u5df2\u89e6\u53d1\u4efb\u52a1
    3.Queue Processor\uff1a\u53d1\u73b0\u961f\u5217\u975e\u7a7a\u4e14Agent\u7a7a\u95f2\uff0c\u542f\u52a8\u4e00\u8f6eagent_loop
    4.Consumer\uff1aagent_loop\u4ece\u961f\u5217\u6d88\u8d39\uff0c\u6ce8\u5165\u5230messages<\/p>\n\n\n\n
    CronJob\uff1a\u6570\u636e\u7ed3\u6784<\/strong><\/p>\n\n\n\n
    \u6bcf\u4e2acron\u4efb\u52a1\u662f\u4e00\u4e2aCronJob\u5bf9\u8c61<\/p>\n\n\n\n
    @dataclass\nclass CronJob:\n    id: str\n    cron: str        # \"0 9 * * *\" (\u4e94\u6bb5\u5f0f cron \u8868\u8fbe\u5f0f)\n    prompt: str      # \u89e6\u53d1\u65f6\u6ce8\u5165\u7ed9 Agent \u7684\u6d88\u606f\n    recurring: bool  # True=\u5468\u671f\u6027\uff0cFalse=\u4e00\u6b21\u6027\n    durable: bool    # True=\u5199\u78c1\u76d8\uff0c\u8de8\u4f1a\u8bdd\u4fdd\u7559<\/code><\/pre>\n\n\n\n
    Cron\u8868\u8fbe\u5f0f\uff0c\u4e94\u6bb5\u5f0f<\/p>\n\n\n\n
    \u5206\u949f  \u5c0f\u65f6  \u65e5  \u6708  \u661f\u671f\n  *    *   *   *   *      \u6bcf\u5206\u949f\n  0    9   *   *   *      \u6bcf\u5929\u65e9\u4e0a 9:00\n *\/5    *   *   *   *      \u6bcf 5 \u5206\u949f\n  0    9   *   *  1-5     \u5de5\u4f5c\u65e5\u65e9\u4e0a 9:00<\/code><\/pre>\n\n\n\n
    cron_matches\uff1a\u4e94\u6bb5\u5f0f\u5339\u914d<\/strong><\/p>\n\n\n\n
    \u6807\u51c6cron\u8bed\u4e49\uff1a\u5206\u949f\u3001\u5c0f\u65f6\u3001\u6708\u5fc5\u987b\u5168\u90e8\u5339\u914d\uff1b\u65e5\uff08DOM\uff09\u548c\u661f\u671f\uff08DOW\uff09\u540c\u65f6\u88ab\u7ea6\u675f\u4efb\u4e00\u5339\u914d\u5373\u53ef<\/p>\n\n\n\n
    def cron_matches(cron_expr: str, dt: datetime) -> bool:\n    fields = cron_expr.strip().split()\n    if len(fields) != 5:\n        return False\n    minute, hour, dom, month, dow = fields\n    dow_val = (dt.weekday() + 1) % 7  # Python Monday=0 \u2192 cron Sunday=0\n\n    m = _cron_field_matches(minute, dt.minute)\n    h = _cron_field_matches(hour, dt.hour)\n    dom_ok = _cron_field_matches(dom, dt.day)\n    month_ok = _cron_field_matches(month, dt.month)\n    dow_ok = _cron_field_matches(dow, dow_val)\n\n    if not (m and h and month_ok):\n        return False\n    # DOM and DOW: both constrained \u2192 either matching is enough (OR)\n    dom_unconstrained = dom == \"*\"\n    dow_unconstrained = dow == \"*\"\n    if dom_unconstrained and dow_unconstrained:\n        return True\n    if dom_unconstrained:\n        return dow_ok\n    if dow_unconstrained:\n        return dom_ok\n    return dom_ok or dow_ok<\/code><\/pre>\n\n\n\n
    \u72ec\u7acb\u8c03\u5ea6\u7ebf\u7a0b\uff1a\u6bcf\u79d2\u8f6e\u8be2<\/strong><\/p>\n\n\n\n
    \u8c03\u5ea6\u5668\u8dd1\u5728\u72ec\u7acb\u7684daemon\u7ebf\u7a0b\u91cc\uff0c\u4e0d\u4f9d\u8d56agent_loop\u662f\u5426\u5728\u6267\u884c\u3002\u5355\u4e2ajob\u5f02\u5e38\u4e0d\u4f1a\u6740\u6389\u6574\u4e2a\u7ebf\u7a0b<\/p>\n\n\n\n
    def cron_scheduler_loop():\n    while True:\n        time.sleep(1)\n        now = datetime.now()\n        minute_marker = now.strftime(\"%Y-%m-%d %H:%M\")\n        with cron_lock:\n            for job in list(scheduled_jobs.values()):\n                try:\n                    if cron_matches(job.cron, now):\n                        if _last_fired.get(job.id) != minute_marker: #cron\u53ea\u7cbe\u786e\u5230\u5206\u949f\uff0c\u9632\u6b62\u4e00\u5206\u949f\u91cd\u590d\u6267\u884c60\u6b21\n                            cron_queue.append(job)\n                            _last_fired[job.id] = minute_marker\n                        if not job.recurring:\n                            scheduled_jobs.pop(job.id, None)\n                            if job.durable:\n                                save_durable_jobs()\n                except Exception as e:\n                    print(f\"[cron error] {job.id}: {e}\")<\/code><\/pre>\n\n\n\n
      \n
    • \u72ec\u7acb\u4e8eagent_loop\uff1a\u5373\u4f7fagent_loop\u6ca1\u5728\u8dd1\uff0c\u8c03\u5ea6\u5668\u4e5f\u5728\u540e\u53f0\u68c0\u67e5\u65f6\u95f4<\/li>\n\n\n\n
    • date-aware minute_marker\uff1a\u7528”YYYY-MM-DD HH:MM”\u9632\u6b62\u540c\u4e00\u5206\u949f\u91cd\u590d\u89e6\u53d1\uff0c\u540c\u65f6\u4e0d\u4f1a\u5728\u7b2c\u4e8c\u5929\u8df3\u8fc7<\/li>\n\n\n\n
    • \u5355 job try\/except\uff1a\u4e00\u4e2a\u574fjob\u4e0d\u4f1a\u62d6\u57ae\u6574\u4e2a\u8c03\u5ea6\u7ebf\u7a0b<\/li>\n\n\n\n
    • \u4e00\u6b21\u6027\u4efb\u52a1\uff1a\u89e6\u53d1\u540e\u81ea\u52a8\u4ecescheduled_jobs\u91cc\u5220\u9664<\/li>\n<\/ul>\n\n\n\n
      Queue Processor + agent_loop\uff1a\u4ea4\u4ed8\u7aef<\/strong><\/p>\n\n\n\n
      queue processor\u4e0d\u68c0\u67e5\u65f6\u95f4\uff0c\u53ea\u8d1f\u8d23\u5728\u961f\u5217\u6709\u4efb\u52a1\u4e14Agent\u7a7a\u95f2\u65f6\u62c9\u8d77\u4e00\u8f6e\u6267\u884c<\/p>\n\n\n\n
      def queue_processor_loop():\n    while True:\n        time.sleep(0.2)\n        if not has_cron_queue():\n            continue\n        if not agent_lock.acquire(blocking=False):\n            continue\n        try:\n            if has_cron_queue():\n                run_agent_turn_locked()\n        finally:\n            agent_lock.release()<\/code><\/pre>\n\n\n\n
      agent_loop\u4e5f\u4e0d\u8d1f\u8d23\u68c0\u67e5\u65f6\u95f4\uff0c\u5b83\u53ea\u4ececron_queue\u91cc\u62ff\u5df2\u89e6\u53d1\u7684\u4efb\u52a1\uff0c\u6ce8\u5165\u5230messages\u91cc<\/p>\n\n\n\n
      fired = consume_cron_queue()\nfor job in fired:\n    messages.append({\"role\": \"user\",\n                     \"content\": f\"[Scheduled] {job.prompt}\"})<\/code><\/pre>\n\n\n\n
      \u751f\u4ea7\u8005\uff08\u8c03\u5ea6\u7ebf\u7a0b\uff09\u3001\u4ea4\u4ed8\u8005\uff08queue processor\uff09\u548c\u6d88\u8d39\u8005\uff08agent_loop\uff09\u901a\u8fc7cron_queue\u3001cron_lock\u3001agent_lock\u89e3\u8026<\/p>\n\n\n\n
      \u6821\u9a8c\uff1a\u9632\u6b62\u574fcron\u6740\u6389\u8c03\u5ea6\u5668<\/strong><\/p>\n\n\n\n
      schedule_job\u5728\u6ce8\u518c\u524d\u6821\u9a8ccron\u8868\u8fbe\u5f0f\uff0c\u975e\u6cd5\u7684\u76f4\u63a5\u8fd4\u56de\u9519\u8bef<\/p>\n\n\n\n
      def schedule_job(cron, prompt, recurring=True, durable=True):\n    err = validate_cron(cron)\n    if err:\n        return err\n    # ... register job<\/code><\/pre>\n\n\n\n
      \u4ece\u78c1\u76d8\u52a0\u8f7ddurable job\u65f6\u4e5f\u4f1a\u8df3\u8fc7\u975e\u6cd5\u8868\u8fbe\u5f0f\uff0c\u907f\u514d\u5355\u4e2a\u574f\u4efb\u52a1\u62d6\u57ae\u542f\u52a8<\/p>\n\n\n\n
      Durable vs Session-only<\/strong><\/p>\n\n\n\n
        \n
      • Durable\uff1a\u4efb\u52a1\u5b9a\u4e49\u5199\u8fdb .scheduled_tasks.json\u3002Agent\u91cd\u542f\u540e\u52a0\u8f7d\u6587\u4ef6\uff0c\u6062\u590d\u4efb\u52a1<\/li>\n\n\n\n
      • Session-only\uff1a\u53ea\u5728\u5185\u5b58\u91cc\u3002Agent\u5173\u95ed\u5c31\u6ca1\u4e86<\/li>\n<\/ul>\n\n\n\n
        \u91cd\u8981\u524d\u63d0<\/strong>\uff1acron \u8c03\u5ea6\u5668\u5fc5\u987b\u5728 Agent \u8fdb\u7a0b\u5185\u8dd1\u3002\u8fdb\u7a0b\u5173\u95ed\uff0c\u8c03\u5ea6\u4e5f\u505c\u3002Durable \u53ea\u610f\u5473\u7740\u4efb\u52a1\u5b9a\u4e49\u8de8\u91cd\u542f\u4fdd\u7559\uff0c\u4e0b\u6b21 Agent \u542f\u52a8\u65f6\u8c03\u5ea6\u5668\u624d\u4f1a\u53d1\u73b0”\u8be5\u89e6\u53d1\u4e86”\u5e76\u89e6\u53d1\u3002\u5982\u679c\u9700\u8981”\u5373\u4f7f\u5e94\u7528\u5173\u95ed\u4e5f\u80fd\u5b9a\u65f6\u8dd1”\uff0c\u8bf7\u7528\u7cfb\u7edf crontab \u6216 systemd timer\u3002<\/strong><\/p>\n\n\n\n
          \n
        1. \u542f\u52a8\u65f6\uff1a
          load_durable_jobs() \u2192 \u4ece .scheduled_tasks.json \u6062\u590d\u6301\u4e45\u5316\u4efb\u52a1
          Thread(cron_scheduler_loop, daemon=True).start() \u2192 \u8c03\u5ea6\u7ebf\u7a0b\u5f00\u59cb\u8f6e\u8be2
          Thread(queue_processor_loop, daemon=True).start() \u2192 \u961f\u5217\u5904\u7406\u5668\u7b49\u5f85\u4ea4\u4ed8<\/li>\n\n\n\n
        2. \u6ce8\u518c\u4efb\u52a1\uff1a
          schedule_cron(cron=”*\/2 * * * *”, prompt=”run date”, durable=True)
          \u2192 CronJob \u5199\u5165 scheduled_jobs + .scheduled_tasks.json<\/li>\n\n\n\n
        3. \u6bcf 2 \u5206\u949f\uff1a
          \u8c03\u5ea6\u7ebf\u7a0b\u68c0\u67e5 \u2192 cron_matches \u8fd4\u56de True \u2192 cron_queue.append(job)
          \u2192 queue processor \u53d1\u73b0 Agent \u7a7a\u95f2 \u2192 agent_loop consume_cron_queue
          \u2192 \u6ce8\u5165 “[Scheduled] run date”
          \u2192 LLM \u6536\u5230\u6d88\u606f\uff0c\u6267\u884c date \u547d\u4ee4<\/li>\n\n\n\n
        4. \u5173\u95ed\u8fdb\u7a0b\uff1a
          \u8c03\u5ea6\u7ebf\u7a0b\u8ddf\u7740\u505c\uff08daemon=True\uff09
          .scheduled_tasks.json \u8fd8\u5728\u78c1\u76d8\u4e0a
          \u4e0b\u6b21\u542f\u52a8 \u2192 load_durable_jobs \u2192 \u4efb\u52a1\u6062\u590d<\/li>\n<\/ol>\n\n\n\n
          Agent Teams<\/h1>\n\n\n\n
          “\u91cd\u6784\u6574\u4e2a\u540e\u7aef”\u6d89\u53ca\u8ba4\u8bc1\u6a21\u5757\u3001\u6570\u636e\u5e93\u5c42\u3001API\u8def\u7531\u3001\u6d4b\u8bd5\u3002\u4e00\u4e2aAgent\u5728\u4feeAPI\u8def\u7531\u65f6\uff0c\u8ba4\u8bc1\u6a21\u5757\u7684\u7ec6\u8282\u5df2\u7ecf\u4e0d\u5728\u4e0a\u4e0b\u6587\u91cc\u4e86\u3002\u4e0a\u4e0b\u6587\u7a97\u53e3\u5c31\u90a3\u4e48\u5927\uff0c\u5355\u4e2aAgent\u7684\u6ce8\u610f\u529b\u8986\u76d6\u4e0d\u4e86\u6240\u6709\u6a21\u5757\u3002\u524d\u9762\u7684\u5b50Agent\u662f\u4e34\u65f6\u5de5\uff0c\u53eb\u6765\u5e72\u4e00\u4ef6\u4e8b\u5c31\u8d70\u4e86\u3002\u4f46\u6709\u4e9b\u4efb\u52a1\u9700\u8981\u80fd\u901a\u4fe1\u3001\u80fd\u534f\u4f5c\u7684\u961f\u53cb\u3002<\/p>\n\n\n\n
          \"\"<\/div><\/figure>\n\n\n\n
          \u65b0\u589e\u4e09\u6d0b\uff1aMessageBus\uff08\u6587\u4ef6\u6536\u4ef6\u7bb1\uff09\u3001spawn_teammate_thread\uff08\u542f\u52a8\u961f\u53cb\u7ebf\u7a0b\uff09\u3001inbox\u6ce8\u5165\uff08Lead\u63a5\u6536\u961f\u53cb\u6d88\u606f\u5e76\u6ce8\u5165history\uff09<\/p>\n\n\n\n
          \u5b50Agent vs \u961f\u53cb<\/p>\n\n\n\n
          <\/td>\u5b50 Agent<\/td>\u961f\u53cb<\/td><\/tr>
          \u751f\u547d\u5468\u671f<\/td>\u4e00\u6b21\u6027\uff0c\u7528\u5b8c\u9500\u6bc1<\/td>\u591a\u8f6e\uff08\u6559\u5b66\u7248\u9650 10 \u8f6e\uff0c\u771f\u5b9e CC \u7528 idle loop\uff09<\/td><\/tr>
          \u901a\u4fe1<\/td>\u53ea\u56de\u4f20\u7ed3\u8bba<\/td>\u5f02\u6b65\u6536\u4ef6\u7bb1\uff0c\u968f\u65f6\u901a\u4fe1<\/td><\/tr>
          \u4e0a\u4e0b\u6587<\/td>\u5b8c\u5168\u9694\u79bb<\/td>\u901a\u8fc7\u6d88\u606f\u5171\u4eab\u4fe1\u606f<\/td><\/tr>
          \u6570\u91cf<\/td>\u4e00\u4e2a\u4e3b Agent + \u5076\u5c14\u5b50 Agent<\/td>\u4e00\u4e2a Lead + \u591a\u4e2a\u961f\u53cb<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
          \"\"<\/div><\/figure>\n\n\n\n
          MessageBus\uff1a\u6587\u4ef6\u6536\u4ef6\u7bb1<\/strong><\/p>\n\n\n\n
          \u6bcf\u4e2aAgent\uff08\u5305\u62ecLead\u548c\u961f\u53cb\uff09\u6709\u4e00\u4e2a.jsonl\u90ae\u7bb1\u3002\u53d1\u6d88\u606f=\u5f80\u5bf9\u65b9\u7684\u6587\u4ef6\u91ccappend\u4e00\u884cJSON\u3002\u8bfb\u6d88\u606f = \u8bfb\u6587\u4ef6 + \u5220\u9664\uff08\u6d88\u8d39\u5f0f\uff09<\/p>\n\n\n\n
          class MessageBus:\n    def send(self, from_agent: str, to_agent: str,\n             content: str, msg_type: str = \"message\"):\n        msg = {\"from\": from_agent, \"to\": to_agent,\n               \"content\": content, \"type\": msg_type,\n               \"ts\": time.time()}\n        inbox = MAILBOX_DIR \/ f\"{to_agent}.jsonl\"\n        with open(inbox, \"a\") as f:\n            f.write(json.dumps(msg) + \"\\n\")\n\n    def read_inbox(self, agent: str) -> list[dict]:\n        inbox = MAILBOX_DIR \/ f\"{agent}.jsonl\"\n        if not inbox.exists():\n            return []\n        msgs = [json.loads(line) for line in inbox.read_text().splitlines()]\n        inbox.unlink()  # \u6d88\u8d39\u5f0f\uff1a\u8bfb\u5b8c\u5220\u9664\n        return msgs<\/code><\/pre>\n\n\n\n
          \u4e3a\u4ec0\u4e48\u7528\u6587\u4ef6\u800c\u4e0d\u662f\u5185\u5b58\u961f\u5217\uff0c\u8fd9\u91cc\u9009\u6587\u4ef6\u662f\u56e0\u4e3a\u76f4\u89c2\u3001\u8de8\u7ebf\u7a0b\u53ef\u89c2\u5bdf\u3002\u771f\u5b9eCC\u4e5f\u7528\u6587\u4ef6\u6536\u4ef6\u7bb1\uff08~\/.claude\/teams\/{team}\/inboxes\/<\/code>\uff09\uff0c\u4f46\u52a0\u4e86proper-lockfile\u9632\u5e76\u53d1\u5199\u51b2\u7a81\u3002\u8fd9\u91cc\u7684read_inbox\u6709read+unlink\u7adf\u6001\uff0c\u591a\u7ebf\u7a0b\u540c\u65f6\u8bfb\u53ef\u80fd\u4e22\u6d88\u606f\uff0c\u4f46\u5bf9\u76ee\u524d\u573a\u666f\u53ef\u4ee5\u63a5\u53d7\u3002<\/p>\n\n\n\n
          spawn_teammate_thread\uff1a\u542f\u52a8\u961f\u53cb<\/strong><\/p>\n\n\n\n
          Lead\u8c03\u7528spawn_teammate\u5de5\u5177\u542f\u52a8\u4e00\u4e2a\u961f\u53cb\u3002\u961f\u53cb\u8dd1\u5728\u81ea\u5df1\u7684daemon\u7ebf\u7a0b\u91cc\uff0c\u6709\u81ea\u5df1\u7684system prompt\u3001\u81ea\u5df1\u7684messages\u3001\u81ea\u5df1\u7684\u7b80\u5316\u5de5\u5177\u96c6<\/p>\n\n\n\n
          def spawn_teammate_thread(name: str, role: str, prompt: str) -> str:\n    system = f\"You are '{name}', a {role}. Use tools to complete tasks.\"\n\n    def run():\n        messages = [{\"role\": \"user\", \"content\": prompt}]\n        sub_tools = [bash, read_file, write_file, send_message]\n        for _ in range(10):           # \u6700\u591a 10 \u8f6e\n            inbox = BUS.read_inbox(name)\n            if inbox:\n                messages.append({\"role\": \"user\",\n                    \"content\": f\"<inbox>{json.dumps(inbox)}<\/inbox>\"})\n            response = client.messages.create(\n                model=MODEL, system=system, messages=messages[-20:],\n                tools=sub_tools, max_tokens=8000)\n            # ... \u6267\u884c\u5de5\u5177\u3001\u5904\u7406\u7ed3\u679c\n        # \u5b8c\u6210\u540e\u53d1 summary \u7ed9 Lead\n        BUS.send(name, \"lead\", summary, \"result\")\n\n    threading.Thread(target=run, daemon=True).start()<\/code><\/pre>\n\n\n\n
          \u5173\u952e\u8bbe\u8ba1\uff1a<\/strong><\/p>\n\n\n\n
            \n
          • \u961f\u53cb\u6709\u7b80\u5316\u5de5\u5177\u96c6\uff1a<\/strong>bash\u3001read\u3001write\u3001send_message\u3002\u771f\u5b9e\u7684CC\u961f\u53cb\u4e5f\u6709TaskCreate\u3001TaskUpdate\u7b49\u5de5\u5177\uff0c\u4efb\u52a1\u7cfb\u7edf\u662f\u56e2\u961f\u5171\u4eab\u7684\u8fd9\u91cc\u7b80\u6d01\u7248\u7701\u7565\u3002<\/li>\n\n\n\n
          • 10\u8f6e\u9650\u5236\uff1a<\/strong>\u9632\u6b62\u961f\u53cb\u65e0\u9650\u5faa\u73af\u3002\u771f\u5b9eCC\u7528idle loop\uff1a\u8dd1\u5b8c\u4e00\u8f6e\u540e\u53d1idle_notification\uff0c\u7b49inbox\u6d88\u606f\uff0c\u6536\u5230\u6d88\u606f\u540e\uff0c\u77e5\u9053shutdown_request\u624d\u9000\u51fa<\/li>\n\n\n\n
          • \u5b8c\u6210\u540e\u81ea\u52a8\u6c47\u62a5\uff1a<\/strong>BUS.send(name,”lead”,summary)\u628a\u6700\u7ec8\u7ed3\u679c\u53d1\u5230Lead\u7684\u6536\u4ef6\u7bb1<\/li>\n<\/ul>\n\n\n\n
            Lead\u7684inbox\u6ce8\u5165<\/strong><\/p>\n\n\n\n
            Lead\u5728\u6bcf\u8f6e\u4e3b\u5faa\u73af\u7ed3\u675f\u540e\u68c0\u67e5\u6536\u4ef6\u7bb1\u3002\u961f\u53cb\u53d1\u6765\u7684\u6d88\u606f\u6ce8\u5165\u5230history\u91cc\uff0c\u8ba9LLM\u80fd\u770b\u5230\u5e76\u4f5c\u51fa\u53cd\u5e94<\/p>\n\n\n\n
            # \u4e3b\u5faa\u73af\u7ed3\u675f\u540e\ninbox = BUS.read_inbox(\"lead\")\nif inbox:\n    inbox_text = \"\\n\".join(\n        f\"From {m['from']}: {m['content'][:200]}\" for m in inbox)\n    history.append({\"role\": \"user\",\n                    \"content\": f\"[Inbox]\\n{inbox_text}\"})<\/code><\/pre>\n\n\n\n
            \u8fd9\u91cc\u91c7\u7528\u5728\u7528\u6237\u8f93\u5165\u5faa\u73af\u5916\u6ce8\u5165\u3002CC\u66f4\u7cbe\u7ec6\uff0cLead\u7684useInboxPoller\u6bcf1s\u68c0\u67e5\u4e00\u6b21\uff0c\u6709\u6d88\u606f\u5c31\u63d0\u4ea4\u4e3a\u65b0\u7684turn\uff0c\u4e0d\u9700\u8981\u7b49\u7528\u6237\u8f93\u5165\u3002<\/p>\n\n\n\n
            \u6743\u9650\u5192\u6ce1<\/strong><\/p>\n\n\n\n
            \u771f\u5b9e\u7684CC\u6d41\u7a0b\uff1a<\/p>\n\n\n\n
              \n
            • \u961f\u53cb\u9047\u5230\u9700\u8981\u5ba1\u6279\u7684\u64cd\u4f5c -> \u53d1 permission_request\u5230Lead\u6536\u4ef6\u7bb1<\/li>\n\n\n\n
            • Lead\u7684useInboxPoller\u68c0\u6d4b\u5230\u8bf7\u6c42 -> \u8def\u7531\u5230\u5ba1\u6279\u961f\u5217<\/li>\n\n\n\n
            • \u7528\u6237\u5ba1\u6279\u540e -> Lead\u53d1permission_response\u56de\u961f\u53cb<\/li>\n\n\n\n
            • \u961f\u53cb\u7684useSwarmPermissionPoller\uff08\u6bcf500ms\u8f6e\u8be2\uff09\u6536\u5230\u56de\u590d -> \u7ee7\u7eed\u6216\u62d2\u7edd<\/li>\n<\/ul>\n\n\n\n
              1. Lead: \"\u642d\u5efa\u540e\u7aef\uff1a\u4e00\u4e2a\u4eba\u641e\u4e0d\u5b9a\uff0c\u7ec4\u961f\u5427\"\n2. Lead \u2192 spawn_teammate(\"alice\", \"backend dev\", \"\u521b\u5efa\u6570\u636e\u5e93 schema\")\n3. Lead \u2192 spawn_teammate(\"bob\", \"frontend dev\", \"\u5199 API \u5ba2\u6237\u7aef\")\n4. alice \u7ebf\u7a0b\u542f\u52a8 \u2192 \u81ea\u5df1\u7684 LLM \u8c03\u7528 \u2192 bash \"python manage.py migrate\"\n5. bob \u7ebf\u7a0b\u542f\u52a8 \u2192 \u81ea\u5df1\u7684 LLM \u8c03\u7528 \u2192 write_file(\"client.ts\", ...)\n6. alice \u5b8c\u6210 \u2192 BUS.send(\"alice\", \"lead\", \"Schema done: users, orders tables\")\n7. bob \u5b8c\u6210 \u2192 BUS.send(\"bob\", \"lead\", \"Client written with types\")\n8. Lead \u4e0b\u6b21\u5faa\u73af \u2192 inbox \u6ce8\u5165 history \u2192 LLM \u770b\u5230 alice \u548c bob \u7684\u7ed3\u679c<\/code><\/pre>\n\n\n\n
              \"\"<\/div><\/figure>\n\n\n\n
              Team Protocols-\u961f\u53cb\u4e4b\u95f4\u8981\u6709\u7ea6\u5b9a<\/h1>\n\n\n\n
              \u6709\u4e86\u961f\u53cb\uff0c\u961f\u53cb\u90fd\u80fd\u5e72\u6d3b\u4e86\uff0c\u4f46\u662f\u534f\u8c03\u662f\u677e\u6563\u7684\uff1aLead\u53d1\u6d88\u606f\uff0c\u961f\u53cb\u56de\u590d\uff0c\u6ca1\u6709\u7ed3\u6784\u5316\u7684\u534f\u8bae\u3002<\/p>\n\n\n\n
              \u5173\u673a\uff1a<\/strong>Lead\u60f3\u8ba9Alice\u5173\u673a\u3002\u76f4\u63a5\u6740\u7ebf\u7a0b\uff0cAlice\u6cc4\u5199\u4e86\u4e00\u534a\u7684\u6587\u4ef6\u7559\u5728\u78c1\u76d8\u4e0a\u3002\u9700\u8981\u63e1\u624b\uff1aLead\u53d1\u8bf7\u6c42\uff0cAlice\u786e\u8ba4\u6536\u5c3e\u540e\u5173\u673a<\/p>\n\n\n\n
              \u8ba1\u5212\u5ba1\u6279\uff1a<\/strong>Bob\u60f3\u91cd\u6784\u8ba4\u8bc1\u6a21\u5757\uff0c\u5c5e\u4e8e\u9ad8\u98ce\u9669\u64cd\u4f5c\u3002\u5e94\u8be5\u5148\u8ba9Lead\u770bBob\u7684\u8ba1\u5212\uff0c\u5ba1\u6279\u901a\u8fc7\u540e\u518d\u52a8\u624b\u3002<\/p>\n\n\n\n
              \u8fd9\u4e24\u4e2a\u573a\u666f\u7ed3\u6784\u5b8c\u5168\u4e00\u6837\uff1a\u4e00\u65b9\u53d1\u8bf7\u6c42\uff0c\u53e6\u4e00\u65b9\u7ed9\u56de\u590d\uff0c\u8bf7\u6c42\u548c\u56de\u590d\u901a\u8fc7\u540c\u4e00\u4e2aID\u5173\u8054\u3002\u6709\u72b6\u6001\u673a\u8ffd\u8e2a\uff1apending -> approved \/ rejected<\/p>\n\n\n\n
              \u65b0\u589e\u4e09\u6837\uff1aProtocolState\uff08\u8bf7\u6c42\u72b6\u6001\u8ffd\u8e2a\uff09\u3001dispatch_message\uff08\u6309\u6d88\u606f\u7c7b\u578b\u8def\u7531\u5230\u5904\u7406\u5668\uff09\u3001match_response\uff08\u901a\u8fc7request_id\u5173\u8054\u56de\u590d\u4e0e\u8bf7\u6c42\uff0c\u542b\u7c7b\u578b\u6821\u9a8c\uff09<\/p>\n\n\n\n
              \u4e24\u79cd\u534f\u8bae\uff0c\u4e00\u5957\u673a\u5236\uff1a<\/strong><\/p>\n\n\n\n
              \u534f\u8bae<\/th>\u65b9\u5411<\/th>\u7528\u9014<\/th><\/tr><\/thead>
              shutdown_request \/ response<\/td>Lead \u2192 \u961f\u53cb<\/td>\u4f53\u9762\u5173\u673a\u63e1\u624b<\/td><\/tr>
              plan_approval_request \/ response<\/td>\u961f\u53cb \u2192 Lead<\/td>\u8ba1\u5212\u5ba1\u6279\u534f\u8bae\u793a\u4f8b<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
              \u5de5\u4f5c\u539f\u7406<\/strong><\/p>\n\n\n\n
              ProtocolState\uff1a\u8bf7\u6c42\u72b6\u6001<\/strong><\/p>\n\n\n\n
              \u6bcf\u4e2a\u534f\u8bae\u8bf7\u6c42\u521b\u5efa\u4e00\u6761\u72b6\u6001\u8bb0\u5f55\uff0c\u8bb0\u5f55\u8c01\u53d1\u7684\u3001\u53d1\u7ed9\u8c01\u3001\u5f53\u524d\u72b6\u6001\u3001\u9644\u5e26\u5185\u5bb9<\/p>\n\n\n\n
              @dataclass\nclass ProtocolState:\n    request_id: str      # \u552f\u4e00 ID\uff0c\u5982 \"req_004281\"\n    type: str            # \"shutdown\" | \"plan_approval\"\n    sender: str          # \u53d1\u8d77\u65b9\n    target: str          # \u63a5\u6536\u65b9\n    status: str          # pending | approved | rejected\n    payload: str         # \u8ba1\u5212\u6587\u672c\u6216\u5173\u673a\u539f\u56e0\n    created_at: float    # \u65f6\u95f4\u6233\n\npending_requests: dict[str, ProtocolState] = {}<\/code><\/pre>\n\n\n\n
              \u53d1\u9001\u8bf7\u6c42\u65f6\u521b\u5efa\u8bb0\u5f55\uff0c\u6536\u56de\u590d\u65f6\u901a\u8fc7request_id\u627e\u5230\u5bf9\u5e94\u8bb0\u5f55\uff0c\u66f4\u65b0\u72b6\u6001\u3002<\/p>\n\n\n\n
              \u56db\u6b65\u534f\u8bae\u6d41\u7a0b<\/strong><\/p>\n\n\n\n
              \u56db\u6b65\u534f\u8bae\u6d41\u7a0b<\/strong><\/p>\n\n\n\n
              \u4ee5\u5173\u673a\u4e3a\u4f8b\uff0c\u5b8c\u6574\u94fe\u8def<\/p>\n\n\n\n
              \u2460 Lead \u53d1\u8bf7\u6c42\n   req_id = new_request_id()           # \"req_004281\"\n   pending_requests[req_id] = ProtocolState(type=\"shutdown\", status=\"pending\", ...)\n   BUS.send(\"lead\", \"alice\", \"shutdown_request\", metadata={\"request_id\": req_id})\n\n\u2461 \u961f\u53cb\u6536\u5230 \u2192 dispatch\n   inbox = BUS.read_inbox(\"alice\")\n   msg_type = msg[\"type\"]              # \"shutdown_request\"\n   \u2192 \u8def\u7531\u5230 handle_shutdown_request()\n\n\u2462 \u961f\u53cb\u56de\u590d\n   BUS.send(\"alice\", \"lead\", \"shutdown_response\",\n            metadata={\"request_id\": req_id, \"approve\": True})\n\n\u2463 Lead \u6536\u54cd\u5e94 \u2192 match\n   match_response(\"shutdown_response\", req_id, approve=True)\n   pending_requests[req_id].status = \"approved\"<\/code><\/pre>\n\n\n\n
              request_id\u662f\u8d2f\u7a7f\u5168\u94fe\u8def\u7684\u5173\u952e\u952e\uff0c\u8bf7\u6c42\u5e26\u7740\u5b83\u51fa\u53bb\uff0c\u56de\u590d\u5e26\u7740\u5b83\u56de\u6765\u3002<\/p>\n\n\n\n
              dispatch_messages\uff1a\u6309\u7c7b\u578b\u8def\u7531<\/strong><\/p>\n\n\n\n
              \u961f\u53cb\u7684inbox\u4e0d\u53ea\u6536\u666e\u901a\u6d88\u606f\uff0c\u8fd8\u6536\u534f\u8bae\u6d88\u606f\u3002handle_inbox_messge\u6309\u6d88\u606f\u7c7b\u578b\u5206\u53d1\uff1a<\/p>\n\n\n\n
              def handle_inbox_message(name, msg, messages):\n    msg_type = msg.get(\"type\", \"message\")\n    req_id = msg.get(\"metadata\", {}).get(\"request_id\", \"\")\n\n    if msg_type == \"shutdown_request\":\n        BUS.send(name, \"lead\", \"Shutting down.\", \"shutdown_response\",\n                 {\"request_id\": req_id, \"approve\": True})\n        return True   # \u505c\u6b62\u5faa\u73af\n\n    if msg_type == \"plan_approval_response\":\n        approve = msg[\"metadata\"].get(\"approve\", False)\n        messages.append({\"role\": \"user\",\n            \"content\": \"[Plan approved]\" if approve else \"[Plan rejected]\"})\n    return False       # \u7ee7\u7eed\u5faa\u73af<\/code><\/pre>\n\n\n\n
              \u65b0\u589e\u534f\u8bae\u7c7b\u578b\u53ea\u9700\u52a0\u65b0\u7684if\u5206\u652f<\/p>\n\n\n\n
              match_response\uff1a\u7c7b\u578b\u6821\u9a8c<\/strong><\/p>\n\n\n\n
              match_response\u4e0d\u53ea\u6309request_id\u627e\u72b6\u6001\uff0c\u8fd8\u4f1a\u6821\u9a8c\u54cd\u5e94\u7c7b\u578b\u662f\u5426\u5339\u914d\u8bf7\u6c42\u7c7b\u578b<\/p>\n\n\n\n
              def match_response(response_type, request_id, approve):\n    state = pending_requests.get(request_id)\n    if not state:\n        return\n    if state.type == \"shutdown\" and response_type != \"shutdown_response\":\n        return  # type mismatch, skip\n    if state.type == \"plan_approval\" and response_type != \"plan_approval_response\":\n        return\n    if state.status != \"pending\":\n        return  # already resolved, skip duplicate\n    state.status = \"approved\" if approve else \"rejected\"<\/code><\/pre>\n\n\n\n
              \u4e00\u4e2ashutdown_response\u4e0d\u4f1a\u610f\u5916approve\u4e00\u4e2aplan_approval\u8bf7\u6c42<\/p>\n\n\n\n
              \u7edf\u4e00inbox\u6d88\u8d39\uff1aconsume_lead_inbox<\/strong><\/p>\n\n\n\n
              check_inbox\u5de5\u5177\u548c\u4e3b\u5faa\u73af\u672b\u5c3e\u90fd\u8c03\u7528\u540c\u4e00\u4e2aconsume_lead_inbox()\u51fd\u6570\uff0c\u5148\u8def\u7531\u534f\u8bae\u6d88\u606f\u518d\u8fd4\u56de\u5269\u4f59\u5185\u5bb9\uff0c\u907f\u514d\u6d88\u606f\u88ab\u8bfb\u8d70\u4f46\u534f\u8bae\u72b6\u6001\u6ca1\u66f4\u65b0<\/p>\n\n\n\n
              def consume_lead_inbox(route_protocol=True) -> list[dict]:\n    msgs = BUS.read_inbox(\"lead\")\n    if route_protocol:\n        for msg in msgs:\n            meta = msg.get(\"metadata\", {})\n            req_id = meta.get(\"request_id\", \"\")\n            msg_type = msg.get(\"type\", \"\")\n            if req_id and msg_type.endswith(\"_response\"):\n                match_response(msg_type, req_id, meta.get(\"approve\", False))\n    return msgs<\/code><\/pre>\n\n\n\n
              \u4e3b\u5faa\u73af\u672b\u5c3e\u8fd8\u4f1a\u628ainbox\u6d88\u606f\u6ce8\u5165\u5230history\uff0c\u8ba9LLM\u80fd\u770b\u5230\u5e76\u4f5c\u51fa\u53cd\u5e94<\/p>\n\n\n\n
              \u961f\u53cbidle loop\uff1a\u7b49\u5f85\u800c\u4e0d\u662f\u9000\u51fa<\/strong><\/p>\n\n\n\n
              \u524d\u9762\u961f\u53cb\u8dd1\u5b8c10\u8f6e\u5c31\u9000\u51fa\uff0c\u73b0\u5728\u961f\u53cb\u5728LLM\u8fd4\u56de\u975etool_use\u540e\u8fdb\u5165idle\u7b49\u5f85\uff1a\u8f6e\u8be2inbox\uff0c\u6536\u5230shutdown_request\u5c31\u54cd\u5e94\u9000\u51fa\uff0c\u6536\u5230\u65b0\u6d88\u606f\u5c31\u7ee7\u7eed\u5de5\u4f5c\u3002<\/p>\n\n\n\n
              LLM \u8fd4\u56de\u975e tool_use\n  \u2192 idle: \u6bcf\u79d2\u8f6e\u8be2 inbox\n  \u2192 \u6536\u5230 shutdown_request \u2192 \u56de\u590d shutdown_response \u2192 \u9000\u51fa\n  \u2192 \u6536\u5230\u65b0\u6d88\u606f \u2192 \u6ce8\u5165 messages \u2192 \u7ee7\u7eed LLM turn<\/code><\/pre>\n\n\n\n
              \u6574\u5408\u540e\u5c31\u662f<\/p>\n\n\n\n
              1. Lead: \"\u8ba9 Alice \u521b\u5efa\u4e00\u4e2a\u6587\u4ef6\uff0c\u7136\u540e\u5173\u673a\"\n2. Lead \u2192 spawn_teammate(\"alice\", \"backend\", \"\u521b\u5efa config.py\")\n3. alice \u7ebf\u7a0b\u542f\u52a8 \u2192 write_file(\"config.py\", \"...\") \u2192 \u5b8c\u6210 \u2192 idle\n4. Lead \u2192 request_shutdown(\"alice\")\n   \u2192 BUS.send(\"shutdown_request\", {request_id: \"req_000142\"})\n5. alice idle \u8f6e\u8be2\u6536\u5230 \u2192 handle_shutdown_request\n   \u2192 BUS.send(\"shutdown_response\", {request_id: \"req_000142\", approve: True})\n6. Lead consume_lead_inbox \u2192 match_response(\"req_000142\", approve=True)\n   \u2192 pending_requests[\"req_000142\"].status = \"approved\"\n   \u2192 inbox \u6d88\u606f\u6ce8\u5165 history\uff0cLLM \u770b\u5230\u5173\u673a\u7ed3\u679c<\/code><\/pre>\n\n\n\n
              \"\"<\/div><\/figure>\n\n\n\n
              Autonomouts Agents-\u81ea\u5df1\u770b\u677f\u81ea\u5df1\u8ba4\u9886<\/h1>\n\n\n\n
              \u5728\u524d\u9762\u7684\u57fa\u7840\u4e0a\u8fdb\u884c\u6269\u5c55\uff0c\u961f\u53cb\u5e94\u8be5\u81ea\u5df1\u770b\u4efb\u52a1\u770b\u677f\uff0c\u53d1\u73b0\u6ca1\u4eba\u505a\u7684\u4efb\u52a1\u5c31\u8ba4\u9886\uff0c\u505a\u5b8c\u518d\u627e\u4e0b\u4e00\u4e2a<\/p>\n\n\n\n
              \u65b0\u589e\uff1aidle_poll\uff08\u7a7a\u95f2\u65f6\u6bcf5s\u8f6e\u8be2\u4e00\u6b21\uff09\u3001scan_unclaimed_tasks\uff08\u626b\u63cf\u770b\u677f\u4e0a\u53ef\u8ba4\u9886\u7684\u4efb\u52a1\uff09\u3001\u81ea\u52a8\u8ba4\u9886\uff08\u627e\u5230\u4efb\u52a1\u5c31claim\uff0c\u4e0d\u7528Lead\u64cd\u5fc3\uff09<\/p>\n\n\n\n
              \u961f\u53cb\u751f\u547d\u5468\u671f\u4ece\u4e24\u9636\u6bb5\u53d8\u6210\u4e09\u9636\u6bb5<\/p>\n\n\n\n
              \u9636\u6bb5<\/th>\u884c\u4e3a<\/th>\u9000\u51fa\u6761\u4ef6<\/th><\/tr><\/thead>
              WORK<\/td>inbox \u2192 LLM \u2192 \u5de5\u5177\u5faa\u73af<\/td>stop_reason != tool_use<\/code><\/td><\/tr>
              IDLE<\/td>\u6bcf 5s \u8f6e\u8be2 inbox + \u4efb\u52a1\u677f<\/td>60s \u8d85\u65f6<\/td><\/tr>
              SHUTDOWN<\/td>\u53d1 summary\uff0c\u9000\u51fa<\/td>\u2014<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
              \u5de5\u4f5c\u539f\u7406<\/strong><\/p>\n\n\n\n
              idle_poll\uff1a\u7a7a\u95f2\u8f6e\u8be2<\/strong><\/p>\n\n\n\n
              \u961f\u53cb\u5b8c\u6210\u5f53\u524d\u4efb\u52a1\u540e\u4e0d\u9000\u51fa\uff0c\u8fdb\u5165IDLE\u9636\u6bb5–\u6bcf5s\u68c0\u67e5\u4e00\u6b21\u6709\u6ca1\u6709\u65b0\u5de5\u4f5c<\/p>\n\n\n\n
              IDLE_POLL_INTERVAL = 5   # seconds\nIDLE_TIMEOUT = 60         # seconds\n\ndef idle_poll(name, messages, role) -> str:\n    \"\"\"Return 'work', 'shutdown', or 'timeout'.\"\"\"\n    for _ in range(IDLE_TIMEOUT \/\/ IDLE_POLL_INTERVAL):\n        time.sleep(IDLE_POLL_INTERVAL)\n\n        # \u2460 \u68c0\u67e5\u6536\u4ef6\u7bb1\uff08\u4f18\u5148\uff09\n        inbox = BUS.read_inbox(name)\n        if inbox:\n            # shutdown_request \u7acb\u5373\u5904\u7406\n            for msg in inbox:\n                if msg.get(\"type\") == \"shutdown_request\":\n                    # ... \u56de\u590d shutdown_response\n                    return \"shutdown\"\n            # \u666e\u901a\u6d88\u606f\u6ce8\u5165\u4e0a\u4e0b\u6587\uff0c\u56de\u5230 WORK\n            messages.append(...)\n            return \"work\"\n\n        # \u2461 \u626b\u63cf\u4efb\u52a1\u770b\u677f\n        unclaimed = scan_unclaimed_tasks()\n        if unclaimed:\n            task = unclaimed[0]\n            result = claim_task(task[\"id\"], name)\n            if \"Claimed\" in result:\n                messages.append(...)\n                return \"work\"\n    return \"timeout\"<\/code><\/pre>\n\n\n\n
              inbox\u4f18\u5148\uff08\u53ef\u80fd\u5305\u542bshutdown_request\u7b49\u534f\u8bae\u6d88\u606f\uff09\uff0c\u4efb\u52a1\u677f\u5176\u6b21\u3002IDLE\u9636\u6bb5\u6536\u5230shutdown_request\u4f1a\u76f4\u63a5\u56de\u590d\u5e76\u9000\u51fa\uff0c\u4e0d\u7b49\u5230\u4e0b\u4e00\u8f6eWORK\u3002<\/p>\n\n\n\n
              scan_unclaimed_tasks\uff1a\u626b\u63cf\u4efb\u52a1\u770b\u677f<\/strong><\/p>\n\n\n\n
              \u627epending\u72b6\u6001\uff0c\u65e0owner\u3001\u6240\u6709\u4f9d\u8d56\u5df2\u7ecf\u5b8c\u6210\uff08can_start\uff09\u7684\u4efb\u52a1<\/p>\n\n\n\n
              def scan_unclaimed_tasks() -> list[dict]:\n    unclaimed = []\n    for f in sorted(TASKS_DIR.glob(\"task_*.json\")):\n        task = json.loads(f.read_text())\n        if (task.get(\"status\") == \"pending\"\n                and not task.get(\"owner\")\n                and can_start(task[\"id\"])):\n            unclaimed.append(task)\n    return unclaimed<\/code><\/pre>\n\n\n\n
              \u4e09\u4e2a\u6761\u4ef6\uff1a\u5fc5\u987b\u662fpending\u3001\u6ca1\u6709owner\u3001\u6240\u6709blockedBy\u4f9d\u8d56\u5df2\u5b8c\u6210\u3002can_start\u68c0\u67e5\u4f9d\u8d56\u4efb\u52a1\u7684\u72b6\u6001–\u6709\u4f9d\u8d56\u4e0d\u4ee3\u8868\u4e0d\u80fd\u505a\uff0c\u53ea\u6709\u88ab\u672a\u5b8c\u6210\u7684\u4efb\u52a1\u963b\u585e\u624d\u4e0d\u80fd\u505a\u3002\u8fd9\u91cc\u6309\u6587\u4ef6\u540d\u6392\u5e8f\u53d6\u7b2c\u4e00\u4e2a\uff1bCC\u7528\u6587\u4ef6\u9501\u9632\u6b62\u591a\u4e2a\u961f\u53cb\u540c\u65f6\u8ba4\u9886\u540c\u4e00\u4e2a\u4efb\u52a1\u3002<\/p>\n\n\n\n
              claim_task\uff1aowner\u68c0\u67e5<\/strong><\/p>\n\n\n\n
              \u81ea\u52a8\u8ba4\u9886\u65f6\u68c0\u67e5claim\u7ed3\u679c\uff0c\u4e0d\u628a\u5931\u8d25\u5f53\u6210\u529f<\/p>\n\n\n\n
              def claim_task(task_id: str, owner: str = \"agent\") -> str:\n    task = load_task(task_id)\n    if task.status != \"pending\":\n        return f\"Task {task_id} is {task.status}, cannot claim\"\n    if task.owner:\n        return f\"Task {task_id} already owned by {task.owner}\"\n    if not can_start(task_id):\n        return f\"Blocked by: {deps}\"\n    task.owner = owner\n    task.status = \"in_progress\"\n    save_task(task)\n    return f\"Claimed {task.id} ({task.subject})\"<\/code><\/pre>\n\n\n\n
              \u4e3a\u4ec0\u4e48\u8fd9\u91cc\u8fd8\u9700\u8981\u8fdb\u884c\u4e00\u6b21owner\u68c0\u67e5\uff1f<\/strong><\/p>\n\n\n\n
              \u524d\u9762\u7a7a\u95f2\u5bfb\u8bba\u7684\u65f6\u5019\u626b\u63cf\u4efb\u52a1\u7684\u65f6\u5019\u8fdb\u884c\u4e86\u4e00\u6b21owner\u68c0\u67e5\u3002\u90a3\u4e48\u8fd9\u4e2a\u65f6\u5019\u53ef\u80fd\u51fa\u73b0\u4e24\u4e2aAgent\u7a7a\u95f2\u8f6e\u8be2\u5230\u540c\u4e00\u4e2a\u65e0owner\u7684\u4efb\u52a1\uff0c\u4e3a\u4e86\u9632\u6b62\u590d\u5199\u6240\u4ee5\u518d\u6b21\u68c0\u67e5owner\u3002<\/p>\n\n\n\n
              \u8fd9\u91cc\u6ca1\u6709\u6587\u4ef6\u9501\uff0c\u5e76\u53d1\u8ba4\u9886\u53ef\u80fd\u51fa\u73b0\u7ade\u4e89\u3002\u5e76\u53d1\u8ba4\u9886\u53ef\u80fd\u51fa\u73b0\u7ade\u4e89\u3002\u4f46\u81f3\u5c11task_owner\u68c0\u67e5\u907f\u514d\u4e86\u6700\u660e\u663e\u7684”\u540e\u5199\u8986\u76d6”\u95ee\u9898\u3002CC\u7528proper-lockfile\u4fdd\u62a4\u4efb\u52a1\u6587\u4ef6\uff0cclaimTask\u5728\u6587\u4ef6\u9501\u5185\u5b8c\u6210\u8bfb-\u6539-\u5199<\/p>\n\n\n\n
              \u961f\u53cb\u751f\u547d\u5468\u671f\uff1aWORK –> IDLE –> SHUTDOWN<\/strong><\/p>\n\n\n\n
              \u6dfb\u52a0IDLE\u9636\u6bb5\uff0c\u961f\u53cb\u5728\u5916\u5c42\u5faa\u73af\u4e2d\u53cd\u590dWORK –> IDLE<\/p>\n\n\n\n
              # Outer loop: WORK \u2192 IDLE cycle\nwhile True:\n    # WORK phase: \u5185\u5c42\u5faa\u73af\uff08\u6700\u591a 10 \u8f6e LLM \u8c03\u7528\uff09\n    for _ in range(10):\n        # \u68c0\u67e5 inbox\u3001\u5904\u7406\u534f\u8bae\u6d88\u606f\u3001\u8c03 LLM\u3001\u6267\u884c\u5de5\u5177\n        ...\n        if response.stop_reason != \"tool_use\":\n            break  # WORK \u9636\u6bb5\u7ed3\u675f\n\n    # IDLE phase\n    idle_result = idle_poll(name, messages, role)\n    if idle_result == \"shutdown\":\n        break\n    if idle_result == \"timeout\":\n        break  # 60s \u8d85\u65f6 \u2192 SHUTDOWN\n\n# SHUTDOWN: \u53d1 summary \u7ed9 Lead\nBUS.send(name, \"lead\", summary, \"result\")<\/code><\/pre>\n\n\n\n
              \u5173\u952e\u8bbe\u8ba1<\/strong><\/p>\n\n\n\n
                \n
              • \u5916\u5c42while True\uff1a<\/strong>WORK\u548cIDLE\u4ea4\u66ff\u8fdb\u884c\uff0c\u76f4\u5230\u8d85\u65f6\u6216\u6536\u5230\u5173\u673a\u8bf7\u6c42<\/li>\n\n\n\n
              • \u5185\u5c42 for 10\uff1a<\/strong>WORK\u9636\u6bb5\u6700\u591a10\u8f6eLLM\u8c03\u7528\uff08\u9632\u6b62\u65e0\u9650\u5faa\u73af\uff09<\/li>\n\n\n\n
              • IDLE\u8d85\u65f6 60 s\uff1a<\/strong>12\u6b21\u8f6e\u8be2 * 5 s = 60s\u3002\u8d85\u65f6\u540e\u53d1\u9001summary\u5e76\u63a8\u51fa<\/li>\n\n\n\n
              • shutdown_request\u4e24\u9636\u6bb5\u90fd\u80fd\u54cd\u5e94<\/strong>\uff1aWORK\u9636\u6bb5\u901a\u8fc7handle_inbox_message\u5206\u53d1\uff1bIDLE\u9636\u6bb5idle_poll\u76f4\u63a5\u68c0\u67e5\u5e76\u56de\u590d<\/li>\n<\/ul>\n\n\n\n
                \u8eab\u4efd\u91cd\u6ce8\u5165<\/strong><\/p>\n\n\n\n
                autoCompact\u4e4b\u540e\uff0c\u961f\u53cb\u7684message\u5217\u8868\u53ef\u80fd\u88ab\u538b\u7f29\u6210\u4e00\u6bb5\u6458\u8981\u3002\u6bcf\u6b21\u8fdb\u5165\u65b0\u7684WORK\u9636\u6bb5\u65f6\u68c0\u67e5<\/p>\n\n\n\n
                if len(messages) <= 3:\n    messages.insert(0, {\"role\": \"user\",\n        \"content\": f\"<identity>You are '{name}', role: {role}. \"\n                   f\"Continue your work.<\/identity>\"})<\/code><\/pre>\n\n\n\n
                \u6d88\u606f\u8fc7\u77ed\u8bf4\u660e\u53d1\u751f\u4e86\u538b\u7f29\uff0c\u6b64\u65f6\u91cd\u65b0\u6ce8\u5165\u8eab\u4efd\u4fe1\u606f\u3002\u771f\u5b9eCC\u4e2dcontext compaction\u4f1a\u4fdd\u7559system prompt\uff0c\u8fd9\u91cc\u7b80\u5316\u5b9e\u73b0\u9700\u8981\u624b\u52a8\u5904\u7406\u3002<\/p>\n\n\n\n
                consume_lead_inbox\uff1a\u7edf\u4e00inbox\u6d88\u8d39<\/strong><\/p>\n\n\n\n
                check_inbox\u5de5\u5177\u548c\u4e3b\u5faa\u73af\u672b\u5c3e\u90fd\u8c03\u7528\u4e00\u4e2aconsume_lead_inbox()\u51fd\u6570\uff1a\u5148\u8def\u7531\u534f\u8baeresponse\u66f4\u65b0\u72b6\u6001\uff0c\u518d\u628a\u6240\u6709\u6d88\u606f\u6ce8\u5165Lead\u7684\u5bf9\u8bdd\u5386\u53f2\u3002\u961f\u53cb\u53d1\u6765\u7684summary\/result\u4e0d\u4f1a\u53ea\u6253\u5370\u5728\u7ec8\u7aef\uff0cLead\u7684LLM\u80fd\u770b\u5230\u5e76\u534f\u8c03\u4e0b\u4e00\u6b65\u3002<\/p>\n\n\n\n
                1. Lead: \"\u642d\u5efa\u540e\u7aef\u2014\u2014\u4efb\u52a1\u592a\u591a\uff0c\u8ba9\u961f\u53cb\u81ea\u5df1\u8ba4\u9886\"\n2. Lead \u2192 create_task(\"\u521b\u5efa\u6570\u636e\u5e93 schema\")\n3. Lead \u2192 create_task(\"\u5199 API \u8def\u7531\")\n4. Lead \u2192 create_task(\"\u5199\u5355\u5143\u6d4b\u8bd5\")\n5. Lead \u2192 spawn_teammate(\"alice\", \"backend\", \"\u4f60\u662f\u540e\u7aef\u5f00\u53d1\u8005\")\n6. Lead \u2192 spawn_teammate(\"bob\", \"backend\", \"\u4f60\u662f\u540e\u7aef\u5f00\u53d1\u8005\")\n\n7. alice \u7ebf\u7a0b\u542f\u52a8 \u2192 WORK: \u6ca1\u6709\u521d\u59cb inbox \u2192 \u7a7a\u8f6c \u2192 IDLE\n8. bob \u7ebf\u7a0b\u542f\u52a8 \u2192 WORK: \u6ca1\u6709\u521d\u59cb inbox \u2192 \u7a7a\u8f6c \u2192 IDLE\n\n9. alice IDLE \u7b2c 1 \u6b21\u8f6e\u8be2 \u2192 scan_unclaimed \u2192 \u53d1\u73b0\"\u521b\u5efa\u6570\u636e\u5e93 schema\"\n10. alice \u2192 claim_task \u2192 \"\u521b\u5efa\u6570\u636e\u5e93 schema\" \u2192 \u56de\u5230 WORK\n11. bob IDLE \u7b2c 1 \u6b21\u8f6e\u8be2 \u2192 scan_unclaimed \u2192 \u53d1\u73b0\"\u5199 API \u8def\u7531\"\n12. bob \u2192 claim_task \u2192 \"\u5199 API \u8def\u7531\" \u2192 \u56de\u5230 WORK\n\n13. alice WORK: write_file(\"schema.sql\", ...) \u2192 complete_task \u2192 WORK \u7ed3\u675f\n14. alice IDLE \u2192 scan \u2192 \"\u5199\u5355\u5143\u6d4b\u8bd5\" \u2192 claim \u2192 WORK\n15. alice WORK: write_file(\"test_api.py\", ...) \u2192 complete_task \u2192 WORK \u7ed3\u675f\n16. alice IDLE \u2192 60s \u65e0\u65b0\u4efb\u52a1 \u2192 SHUTDOWN\n\n17. bob \u7c7b\u4f3c\u6d41\u7a0b \u2192 \u505a\u5b8c \u2192 SHUTDOWN\n18. Lead consume_lead_inbox \u2192 \u770b\u5230 alice \u548c bob \u7684 summary<\/code><\/pre>\n\n\n\n
                \u4e24\u4e2a\u961f\u53cb\u5e76\u884c\u8ba4\u9886\u3001\u5e76\u884c\u5de5\u4f5c\u3002Lead\u53ea\u9700\u8981\u521b\u5efa\u4efb\u52a1\u548c\u542f\u52a8\u961f\u53cb\uff0c\u4e0d\u9700\u8981\u624b\u52a8\u5206\u914d\u3002<\/p>\n\n\n\n
                Worktree Isolation-\u5404\u5e72\u5404\u7684\uff0c\u4e92\u4e0d\u5e72\u6270<\/h1>\n\n\n\n
                \u524d\u9762Alice\u548cBob\u90fd\u5728\u540c\u4e00\u4e2a\u76ee\u5f55\u4e0b\u5de5\u4f5c\u3002Alice\u7684\u4efb\u52a1\u662f”\u91cd\u6784\u8ba4\u8bc1\u6a21\u5757”\uff0cBob\u7684\u4efb\u52a1\u662f”\u91cd\u6784UI\u767b\u5f55\u9875”<\/p>\n\n\n\n
                Alice write_file(“config.py”\uff0c…)Bob\u4e5f write_file(“config.py”\uff0c…)\u4e24\u4e2a\u4eba\u6539\u540c\u4e00\u4e2a\u6587\u4ef6\uff0c\u4e92\u76f8\u8986\u76d6\u3002\u800c\u4e14\u65e0\u6cd5\u5e72\u51c0\u5730\u56de\u6eda–\u5206\u4e0d\u6e05\u54ea\u4e9b\u6539\u52a8\u662f\u8c01\u7684\u3002<\/p>\n\n\n\n
                \u53ef\u4ee5\u901a\u8fc7Git worktree\u8ba9\u5176\u5728\u540c\u4e00\u4ed3\u5e93\u4e2d\u521b\u5efa\u591a\u4e2a\u72ec\u7acb\u7684\u5de5\u4f5c\u76ee\u5f55\uff0c\u6bcf\u4e2a\u6709\u81ea\u5df1\u7684\u5206\u652f\u3002Alice\u5728.worktrees\/auth-refactor\/\u4e0b\u5de5\u4f5c\uff0cBob\u5728.worktrees\/ui-login\/\u4e0b\u5de5\u4f5c–\u4e92\u4e0d\u5e72\u6270\u3002<\/p>\n\n\n\n
                \u80fd\u529b<\/th>\u4f5c\u7528<\/th><\/tr><\/thead>
                create_worktree<\/td>\u4e3a\u4efb\u52a1\u521b\u5efa\u72ec\u7acb\u76ee\u5f55 + \u72ec\u7acb\u5206\u652f<\/td><\/tr>
                bind_task_to_worktree<\/td>\u628a\u4efb\u52a1\u548c\u5de5\u4f5c\u76ee\u5f55\u7ed1\u5b9a\uff08\u4e0d\u6539\u72b6\u6001\uff09<\/td><\/tr>
                remove_worktree \/ keep_worktree<\/td>\u5b8c\u6210\u540e\u6e05\u7406\u6216\u4fdd\u7559<\/td><\/tr>
                validate_worktree_name<\/td>\u62d2\u7edd\u8def\u5f84\u7a7f\u8d8a\u548c\u975e\u6cd5\u5b57\u7b26<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                \u5de5\u4f5c\u539f\u7406<\/strong><\/p>\n\n\n\n
                \u521b\u5efa\uff1a\u4efb\u52a1-Worktree\u7ed1\u5b9a<\/strong><\/p>\n\n\n\n
                def create_worktree(name: str, task_id: str = \"\") -> str:\n    validate_worktree_name(name)       # \u53ea\u5141\u8bb8 [A-Za-z0-9._-]{1,64}\n    path = WORKTREES_DIR \/ name\n    ok, result = run_git([\"worktree\", \"add\", str(path), \"-b\", f\"wt\/{name}\", \"HEAD\"])\n    if not ok:\n        return f\"Git error: {result}\"\n    if task_id:\n        bind_task_to_worktree(task_id, name)\n    log_event(\"create\", name, task_id)\n    return f\"Worktree '{name}' created at {path}\"\n\ndef bind_task_to_worktree(task_id: str, worktree_name: str):\n    task = load_task(task_id)\n    task.worktree = worktree_name       # \u53ea\u5199 worktree \u5b57\u6bb5\n    save_task(task)                     # \u72b6\u6001\u4fdd\u6301 pending\uff0c\u7b49\u961f\u53cb claim<\/code><\/pre>\n\n\n\n
                \u7ed1\u5b9a\u89c4\u5219\uff1a\u4e00\u4e2a\u4efb\u52a1\u7ed1\u5b9a\u4e00\u4e2aworktree\u3002\u7ed1\u5b9a\u4e0d\u6539\u4efb\u52a1\u72b6\u6001–\u4efb\u52a1\u4ecd\u662fpending\uff0c\u961f\u53cb\u81ea\u52a8\u8ba4\u9886\u65f6\u624d\u63a8\u8fdb\u5230in_progress\u3002\u8fd9\u6837Lead\u53ef\u4ee5\u63d0\u524d\u521b\u5efa\u4efb\u52a1\u548cworktree\uff0c\u961f\u53cbidle\u662f\u81ea\u7136\u8ba4\u9886\u5e26worktree\u7684\u4efb\u52a1<\/p>\n\n\n\n
                \u961f\u53cb\u5de5\u5177\u7684cwd\u5207\u6362<\/strong><\/p>\n\n\n\n
                \u8fd9\u91cc\u7ed9\u6bcf\u4e2a\u961f\u53cb\u7ef4\u62a4\u4e00\u4e2awt_ctx\u5b57\u5178\uff0c\u8bb0\u5f55\u5f53\u524dworktree\u8def\u5f84\u3002\u961f\u53cb\u8ba4\u9886\u5e26worktree\u7684\u4efb\u52a1\u65f6\uff0cwt_ctx\u81ea\u52a8\u8bbe\u7f6e\u4e3aworktree\u8def\u5f84\uff1b\u961f\u53cb\u7684bash\u3001read_file\u3001write_file\u5728worktree\u76ee\u5f55\u4e0b\u6267\u884c<\/p>\n\n\n\n
                # \u961f\u53cb\u7ebf\u7a0b\u5185\u90e8\nwt_ctx = {\"path\": None}\n\ndef _run_claim_task(task_id):\n    result = claim_task(task_id, owner=name)\n    if \"Claimed\" in result:\n        task = load_task(task_id)\n        if task.worktree:\n            wt_ctx[\"path\"] = str(WORKTREES_DIR \/ task.worktree)\n    return result\n\ndef _run_bash(command):\n    return run_bash(command, cwd=wt_ctx[\"path\"])  # \u5728 worktree \u4e0b\u6267\u884c<\/code><\/pre>\n\n\n\n
                \u771f\u5b9eCC\u7684EnterWorktree\u7528process.chdir()\u5207\u6362\u6574\u4e2a\u8fdb\u7a0b\u76ee\u5f55\uff0cAgentTool isolation\u7528cwdOverride\u5305\u4f4f\u5b50Agent\u6267\u884c\u3002<\/p>\n\n\n\n
                \u6536\u5c3e\uff1aKeep\u8fd8\u662fRemove<\/strong><\/p>\n\n\n\n
                \u4efb\u52a1\u5b8c\u6210\u540e\uff0c\u4e24\u4e2a\u9009\u62e9<\/p>\n\n\n\n
                def remove_worktree(name: str, discard_changes: bool = False) -> str:\n    # \u5b89\u5168\u68c0\u67e5\uff1a\u6709\u6539\u52a8\u65f6\u9ed8\u8ba4\u62d2\u7edd\n    if not discard_changes:\n        files, commits = _count_worktree_changes(path)\n        if files > 0 or commits > 0:\n            return \"\u6709\u672a\u63d0\u4ea4\u6539\u52a8\uff0c\u4f7f\u7528 discard_changes=true \u5f3a\u5236\u5220\u9664\uff0c\u6216 keep_worktree \u4fdd\u7559\"\n    ok, _ = run_git([\"worktree\", \"remove\", str(path), \"--force\"])\n    if not ok:\n        return \"\u5220\u9664\u5931\u8d25\"\n    run_git([\"branch\", \"-D\", f\"wt\/{name}\"])\n    log_event(\"remove\", name)\n\ndef keep_worktree(name: str) -> str:\n    log_event(\"keep\", name)\n    return f\"Worktree '{name}' kept for review (branch: wt\/{name})\"<\/code><\/pre>\n\n\n\n
                Keep = \u7559\u7740\u5206\u652f\uff0c\u7b49\u4eba\u5de5review\u540e\u5408\u5e76\u5230\u4e3b\u5206\u652f\u3002Remove = \u6709\u6539\u52a8\u65f6\u9ed8\u8ba4\u62d2\u7edd\uff0c\u9700\u8981discard_changes=true\u786e\u8ba4\u3002\u4e0d\u81ea\u52a8complete task –\u4efb\u52a1\u5b8c\u6210\u7531\u961f\u53cb\u7684complete_task\u663e\u5f0f\u89e6\u53d1\u3002<\/p>\n\n\n\n
                \u4e8b\u4ef6\u6d41\uff1a\u53ef\u5ba1\u8ba1<\/strong><\/p>\n\n\n\n
                \u6bcf\u6b21\u751f\u547d\u5468\u671f\u64cd\u4f5c\u5199\u5165\u65e5\u5fd7\uff0c\u65b9\u4fbf\u6392\u67e5<\/p>\n\n\n\n
                def log_event(event_type: str, worktree_name: str, task_id: str = \"\"):\n    event = {\"type\": event_type, \"worktree\": worktree_name,\n             \"task_id\": task_id, \"ts\": time.time()}\n    # append to .worktrees\/events.jsonl<\/code><\/pre>\n\n\n\n
                \u4e8b\u4ef6\u7c7b\u578b\uff1acreate\uff08\u521b\u5efa\uff09\u3001remove\uff08\u5220\u9664\uff09\u3001keep\uff08\u4fdd\u7559\uff09\u3002\u8fd9\u91cc\u53ea\u8bb0\u5f55\u4e8b\u4ef6\u7528\u4e8e\u4eba\u5de5\u6392\u67e5\uff1b\u5b8c\u6574\u6062\u590d\u8fd8\u9700\u8981index\u6216git worktree list\u626b\u63cf<\/p>\n\n\n\n
                run_git\uff1a\u8fd4\u56de\u6210\u529f\/\u5931\u8d25<\/strong><\/p>\n\n\n\n
                def run_git(args: list[str]) -> tuple[bool, str]:\n    r = subprocess.run([\"git\"] + args, cwd=WORKDIR, ...)\n    return r.returncode == 0, output<\/code><\/pre>\n\n\n\n
                create_worktree\u548cremove_worktree\u53ea\u5728git\u547d\u4ee4\u6210\u529f\u540e\u624d\u5199\u4e8b\u4ef6\u65e5\u5fd7\uff0c\u4fdd\u8bc1\u65e5\u5fd7\u53cd\u6620\u771f\u5b9e\u72b6\u6001\u3002<\/p>\n\n\n\n
                MCP Tools-\u5916\u63a5\u5de5\u5177\u6807\u51c6\u534f\u8bae<\/h1>\n\n\n\n
                \u524d\u9762Agent\u7684\u6240\u6709\u5de5\u5177\u90fd\u662f\u624b\u5199\u7684–bash\u3001read\u3001write\u3001task\u3001worktree\u3002\u6bcf\u4e2a\u5de5\u5177\u7684\u8f93\u5165\u9a8c\u8bc1\u3001\u6267\u884c\u903b\u8f91\u3001\u9519\u8bef\u5904\u7406\uff0c\u90fd\u662f\u4e00\u884c\u4e00\u884c\u5199\u7684\u3002<\/p>\n\n\n\n
                \u73b0\u5728\u67093\u4e2a\u5916\u90e8\u670d\u52a1\u60f3\u63a5\u5165\uff1a\u516c\u53f8\u7684Jira API\uff08\u67e5 issue\u3001\u5efa ticket\uff09\u3001\u81ea\u5efa\u7684\u90e8\u7f72\u7cfb\u7edf\uff08\u89e6\u53d1deploy\u3001\u770b\u65e5\u5fd7\uff09\u3001\u56e2\u961f\u7684Notion\u77e5\u8bc6\u5e93\uff08\u641c\u6587\u6863\u3001\u5efa\u9875\u9762\uff09\uff0c\u4e0d\u60f3\u4e3a\u6bcf\u4e2a\u670d\u52a1\u91cd\u5199\u4e00\u5957\u5de5\u5177\u4ee3\u7801\uff0c\u6b64\u65f6\u5c31\u9700\u8981\u4e00\u4e2a\u6807\u51c6\u534f\u8bae–\u5916\u90e8\u53ea\u8981\u5b9e\u73b0\u5b83\uff0cAgent\u5c31\u80fd\u76f4\u63a5\u8c03\u7528\u3002<\/p>\n\n\n\n
                MCP\u5b9a\u4e49\u4e86Agent\u5982\u4f55\u53d1\u73b0\u548c\u8c03\u7528\u5916\u90e8\u5de5\u5177<\/p>\n\n\n\n
                \u6982\u5ff5<\/th>\u4f5c\u7528<\/th><\/tr><\/thead>
                MCPClient<\/td>Agent \u7aef\u7684\u5ba2\u6237\u7aef\uff0c\u8fde\u63a5 server\u3001\u53d1\u73b0\u5de5\u5177\u3001\u8c03\u7528\u5de5\u5177<\/td><\/tr>
                MCP Server<\/td>\u5916\u90e8\u670d\u52a1\uff0c\u5b9e\u73b0 tools\/list<\/code> + tools\/call<\/code><\/td><\/tr>
                assemble_tool_pool<\/td>\u628a\u5185\u7f6e\u5de5\u5177\u548c MCP \u5de5\u5177\u7ec4\u88c5\u6210\u4e00\u4e2a\u5de5\u5177\u6c60<\/td><\/tr>
                mcp__server__tool \u547d\u540d<\/td>\u907f\u514d\u4e0d\u540c server \u7684\u5de5\u5177\u540d\u51b2\u7a81<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                \u8fd9\u91cc\u7528mock handler\u6a21\u62df\u5916\u90e8server\u3002\u771f\u5b9e\u7248\u4f1a\u542f\u52a8\u5b50\u8fdb\u7a0b\uff0c\u901a\u8fc7stdin\/stdout\u53d1\u9001JSON-RPC\u8bf7\u6c42\u3002mock\u7684\u597d\u5904\u662f\u4e0d\u4f9d\u8d56\u5916\u90e8\u670d\u52a1\u5c31\u80fd\u8dd1\u5b8c\u6574\u6d41\u7a0b\uff1b\u4ee3\u4ef7\u662f\u4f60\u770b\u4e0d\u5230\u771f\u6b63 \u7f51\u7edc\u901a\u4fe1\u548c\u8fdb\u7a0b\u7ba1\u7406\u3002<\/p>\n\n\n\n
                \u5de5\u4f5c\u539f\u7406<\/strong><\/p>\n\n\n\n
                MCPClient\uff1a\u53d1\u73b0+\u8c03\u7528<\/strong><\/p>\n\n\n\n
                class MCPClient:\n    def __init__(self, name: str):\n        self.name = name\n        self.tools: list[dict] = []\n        self._handlers: dict[str, callable] = {}\n\n    def register(self, tool_defs, handlers):\n        \"\"\"Simulates tools\/list discovery.\"\"\"\n        self.tools = tool_defs\n        self._handlers = handlers\n\n    def call_tool(self, tool_name: str, args: dict) -> str:\n        \"\"\"Simulates tools\/call.\"\"\"\n        handler = self._handlers.get(tool_name)\n        if not handler:\n            return f\"MCP error: unknown tool '{tool_name}'\"\n        return handler(**args)<\/code><\/pre>\n\n\n\n
                \u8fd9\u91cc\u7528python\u51fd\u6570\u6a21\u62dfserver\u7684\u5de5\u5177\u5b9e\u73b0\u3002\u771f\u5b9e\u7248\u901a\u8fc7stdio JSON-RPC\u4e0e\u5b50\u8fdb\u7a0b\u901a\u4fe1\u3002<\/p>\n\n\n\n
                connect_mcp\uff1a\u8fde\u63a5+\u53d1\u73b0<\/strong><\/p>\n\n\n\n
                def connect_mcp(name: str) -> str:\n    if name in mcp_clients:\n        return f\"MCP server '{name}' already connected\"\n    factory = MOCK_SERVERS.get(name)\n    if not factory:\n        return f\"Unknown server '{name}'. Available: ...\"\n    mcp_client = factory()\n    mcp_clients[name] = mcp_client\n    return f\"Connected to '{name}'. Discovered: ...\"<\/code><\/pre>\n\n\n\n
                \u8fde\u63a5\u540e\uff0cserver\u63d0\u4f9b\u7684\u5de5\u5177\u7acb\u5373\u53ef\u7528<\/p>\n\n\n\n
                normalize_mcp_name\uff1a\u540d\u79f0\u89c4\u8303\u5316<\/strong><\/p>\n\n\n\n
                _DISALLOWED_CHARS = re.compile(r'[^a-zA-Z0-9_-]')\n\ndef normalize_mcp_name(name: str) -> str:\n    return _DISALLOWED_CHARS.sub('_', name)<\/code><\/pre>\n\n\n\n
                \u6240\u6709\u975e[a-zA-Z0-9_-]\u7684\u5b57\u7b26\u66ff\u6362\u4e3a_\u9632\u6b62server\u540d\u6216\u5de5\u5177\u540d\u4e2d\u5305\u542b\u7279\u6b8a\u5b57\u7b26\u5bfc\u81f4\u547d\u540d\u51b2\u7a81\u6216\u6ce8\u5165\u95ee\u9898<\/p>\n\n\n\n
                assemble_tool_pool\uff1a\u7ec4\u88c5\u5de5\u5177\u6c60<\/strong><\/p>\n\n\n\n
                def assemble_tool_pool() -> tuple[list[dict], dict]:\n    tools = list(BUILTIN_TOOLS)\n    handlers = dict(BUILTIN_HANDLERS)\n    for server_name, mcp_client in mcp_clients.items():\n        safe_server = normalize_mcp_name(server_name)\n        for tool_def in mcp_client.tools:\n            safe_tool = normalize_mcp_name(tool_def[\"name\"])\n            prefixed = f\"mcp__{safe_server}__{safe_tool}\"\n            tools.append(...)\n            handlers[prefixed] = (\n                lambda *, c=mcp_client, t=tool_def[\"name\"], **kw:\n                    c.call_tool(t, kw))\n    return tools, handlers<\/code><\/pre>\n\n\n\n
                \u524d\u7f00mcp_{server}_{tool}\u907f\u514d\u4e0d\u540cserver\u7684\u5de5\u5177\u540d\u51b2\u7a81\u3002\u540d\u79f0\u7ecf\u8fc7normalize_mcp_name\u89c4\u8303\u5316<\/p>\n\n\n\n
                MCP\u5de5\u5177\u7684description\u5e26\uff08readOnly\uff09\u6216\uff08destructive\uff09\u6807\u6ce8<\/p>\n\n\n\n
                \u65e0\u7f13\u5b58\uff1a\u5de5\u5177\u6c60\u53d8\u4e86\uff0cprompt\u4e5f\u53d8<\/strong><\/p>\n\n\n\n
                \u524d\u9762agent_loop\u7528prompt cache\u907f\u514d\u91cd\u590d\u5e8f\u5217\u5316\uff0c\u8fd9\u91cc\u53bb\u6389\u7f13\u5b58\u91cd\u65b0\u751f\u6210<\/p>\n\n\n\n
                def agent_loop(messages, context):\n    tools, handlers = assemble_tool_pool()     # \u6bcf\u6b21\u91cd\u65b0\u6784\u5efa\n    system = assemble_system_prompt(context)    # \u6bcf\u6b21\u91cd\u65b0\u751f\u6210\n    ...\n    if any(b.name == \"connect_mcp\" ...):\n        tools, handlers = assemble_tool_pool()  # \u8fde\u63a5\u540e\u91cd\u5efa\n        system = assemble_system_prompt(context)<\/code><\/pre>\n\n\n\n
                \u539f\u56e0\uff1aconnect_mcp\u4e4b\u540e\u5de5\u5177\u6c60\u53d8\u5316\u4e86–\u65b0\u589e\u4e86mcp_docs_search\u7b49\u5de5\u5177\u3002\u7f13\u5b58\u4e2d\u7684\u5de5\u5177\u5217\u8868\u662f\u65e7\u7684\uff0c\u7ee7\u7eed\u7528\u4f1a\u5bfc\u81f4\u6a21\u578b\u8c03\u7528\u4e0d\u4e86\u65b0\u5de5\u5177\u3002<\/p>\n\n\n\n
                MCP\u5de5\u5177\u53ea\u6709Lead\u53ef\u7528<\/strong><\/p>\n\n\n\n
                connect_mcp<\/code> \u662f Lead \u5de5\u5177\uff0cassemble_tool_pool<\/code> \u4e5f\u53ea\u670d\u52a1\u4e8e Lead \u7684 agent_loop\u3002Teammate \u4ecd\u4f7f\u7528\u56fa\u5b9a\u7684 8 \u4e2a\u5b50\u96c6\u5de5\u5177\uff08bash\u3001read_file\u3001write_file\u3001send_message\u3001submit_plan\u3001list_tasks\u3001claim_task\u3001complete_task\uff09\u3002<\/p>\n\n\n\n
                \u771f\u5b9e CC \u4e2d\uff0cMCP \u5de5\u5177\u5bf9\u4e3b agent \u548c\u5b50 agent \u90fd\u53ef\u7528\u2014\u2014\u5b50 agent \u7ee7\u627f\u7236\u7ea7\u7684 MCP \u914d\u7f6e\u3002<\/p>\n\n\n\n
                Comprehensive Agent<\/h1>\n\n\n\n
                \u4e00\u4e2a\u957f\u671f\u5de5\u4f5c\u7684coding agent\u9700\u8981\u540c\u65f6\u62e5\u6709<\/p>\n\n\n\n
                  \n
                • \u5de5\u5177\u5206\u53d1\u548c\u6743\u9650\u8fb9\u754c<\/li>\n\n\n\n
                • hooks\u6269\u5c55\u70b9<\/li>\n\n\n\n
                • todo\u8ba1\u5212\u548c\u4efb\u52a1\u56fe<\/li>\n\n\n\n
                • \u6280\u80fd\u3001\u8bb0\u5fc6\u3001\u7cfb\u7edfprompt\u7ec4\u88c5<\/li>\n\n\n\n
                • \u538b\u7f29\u548c\u9519\u8bef\u6062\u590d<\/li>\n\n\n\n
                • \u540e\u53f0\u4efb\u52a1\u548ccron\u8c03\u5ea6<\/li>\n\n\n\n
                • \u56e2\u961f\u3001\u534f\u8bae\u3001\u81ea\u6cbb\u8ba4\u9886<\/li>\n\n\n\n
                • worktree\u9694\u79bb<\/li>\n\n\n\n
                • MCP\u5916\u90e8\u5de5\u5177\u63a5\u5165<\/li>\n<\/ul>\n\n\n\n
                  \u96be\u70b9\u4e0d\u662f\u628a\u529f\u80fd\u5806\u8d77\u6765\uff0c\u800c\u662f\u770b\u6e05\u695a\u5b83\u4eec\u90fd\u6302\u5728\u5faa\u73af\u7684\u54ea\u4e2a\u4f4d\u7f6e<\/p>\n\n\n\n
                  \u4e00\u4e2a\u5b8c\u6574\u7684harness<\/strong><\/p>\n\n\n\n
                  \u7528\u6237\u8f93\u5165\n  \u2192 UserPromptSubmit hooks\n  \u2192 cron\/background \u901a\u77e5\u6ce8\u5165\n  \u2192 context compact\n  \u2192 memory + skills + MCP \u72b6\u6001\u7ec4\u88c5 system prompt\n  \u2192 LLM\n  \u2192 has tool_use block?\n      \u5426 \u2192 Stop hooks \u2192 \u8fd4\u56de\n      \u662f \u2192 PreToolUse hooks + permission\n          \u2192 TOOL_HANDLERS \/ MCP handlers \/ background dispatch\n          \u2192 PostToolUse hooks\n          \u2192 tool_result \/ task_notification \u56de messages\n          \u2192 \u4e0b\u4e00\u8f6e<\/code><\/pre>\n\n\n\n
                  \u5faa\u73af\u672c\u8eab\u4ecd\u7136\u662f\u540c\u4e00\u4e2a\u7ed3\u6784\uff1a\u8c03\u7528\u6a21\u578b\uff0c\u68c0\u67e5\u54cd\u5e94\u91cc\u662f\u5426\u51fa\u73b0tool_useblock\uff0c\u6267\u884c\u5de5\u5177\uff0c\u628a\u7ed3\u679c\u8ffd\u52a0\u56demessages\u3002<\/p>\n\n\n\n
                  \u7ec4\u4ef6\u5728\u5faa\u73af\u4e2d\u7684\u4f4d\u7f6e<\/strong><\/p>\n\n\n\n
                  \u4f4d\u7f6e<\/th>\u7ec4\u4ef6<\/th>\u4f5c\u7528<\/th><\/tr><\/thead>
                  \u7528\u6237\u8f93\u5165\u524d\u540e<\/td>UserPromptSubmit<\/code> hooks<\/td>\u8bb0\u5f55\u3001\u6ce8\u5165\u3001\u5ba1\u8ba1\u7528\u6237\u8f93\u5165<\/td><\/tr>
                  LLM \u524d<\/td>cron queue<\/td>\u628a\u5b9a\u65f6\u89e6\u53d1\u7684 prompt \u6ce8\u5165 messages<\/code><\/td><\/tr>
                  LLM \u524d<\/td>background notifications<\/td>\u540e\u53f0\u4efb\u52a1\u5b8c\u6210\u540e\u4ee5 <task_notification><\/code> \u6ce8\u5165<\/td><\/tr>
                  LLM \u524d<\/td>compaction pipeline<\/td>\u5148\u538b\u5927\u8f93\u51fa\uff0c\u518d\u88c1\u5386\u53f2\uff0c\u518d\u538b\u65e7 tool_result\uff0c\u5fc5\u8981\u65f6\u6458\u8981<\/td><\/tr>
                  LLM \u524d<\/td>memory \/ skills \/ MCP state<\/td>\u7ec4\u88c5 system prompt\uff0c\u8ba9\u6a21\u578b\u770b\u5230\u5f53\u524d\u80fd\u529b\u548c\u957f\u671f\u4e0a\u4e0b\u6587<\/td><\/tr>
                  LLM \u8c03\u7528<\/td>error recovery<\/td>429\/529 \u91cd\u8bd5\uff0cmax_tokens<\/code> \u5347\u7ea7\uff0cprompt too long \u89e6\u53d1 reactive compact<\/td><\/tr>
                  \u5de5\u5177\u6267\u884c\u524d<\/td>PreToolUse<\/code> hooks + permission<\/td>\u62e6\u622a\u5371\u9669\u547d\u4ee4\u3001\u5199\u8d8a\u754c\u3001\u7834\u574f\u6027 MCP \u5de5\u5177<\/td><\/tr>
                  \u5de5\u5177\u5206\u53d1<\/td>assemble_tool_pool<\/code><\/td>\u7ec4\u88c5\u5185\u7f6e\u5de5\u5177\u548c MCP \u52a8\u6001\u5de5\u5177<\/td><\/tr>
                  \u5de5\u5177\u6267\u884c\u65f6<\/td>background dispatch<\/td>\u6162 bash \u64cd\u4f5c\u653e daemon thread\uff0c\u4e3b\u5faa\u73af\u5148\u8fd4\u56de\u5360\u4f4d\u7ed3\u679c<\/td><\/tr>
                  \u5de5\u5177\u6267\u884c\u540e<\/td>PostToolUse<\/code> hooks<\/td>\u5927\u8f93\u51fa\u544a\u8b66\u3001\u65e5\u5fd7\u7b49\u540e\u5904\u7406<\/td><\/tr>
                  \u8fd4\u56de\u5faa\u73af<\/td>tool_result<\/td>\u6bcf\u4e2a tool_use<\/code> \u5bf9\u5e94\u4e00\u4e2a tool_result<\/code>\uff0c\u518d\u56de\u5230\u4e0b\u4e00\u8f6e<\/td><\/tr>
                  \u672c\u8f6e\u6ca1\u6709 tool_use \/ \u505c\u6b62\u65f6<\/td>Stop<\/code> hooks<\/td>\u7edf\u8ba1\u3001\u6e05\u7406\u3001\u5ba1\u8ba1<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                  \u5de5\u5177\u4e0e\u5206\u53d1<\/strong><\/p>\n\n\n\n
                  \u5185\u7f6e\u5de5\u5177\u6c60\u5305\u542b27\u4e2a\u5de5\u5177<\/p>\n\n\n\n
                  bash, read_file, write_file, edit_file, glob\ntodo_write, task, load_skill, compact\ncreate_task, list_tasks, get_task, claim_task, complete_task\nschedule_cron, list_crons, cancel_cron\nspawn_teammate, send_message, check_inbox\nrequest_shutdown, request_plan, review_plan\ncreate_worktree, remove_worktree, keep_worktree\nconnect_mcp<\/code><\/pre>\n\n\n\n
                  assemble_tool_pool()\u6bcf\u8f6e\u7ec4\u88c5<\/p>\n\n\n\n
                  BUILTIN_TOOLS + connected MCP tools\nBUILTIN_HANDLERS + mcp__server__tool handlers<\/code><\/pre>\n\n\n\n
                  \u6240\u4ee5connect_mcp(“docs”)\u540e\uff0c\u4e0b\u4e00\u8f6e\u5de5\u5177\u6c60\u91cc\u4f1a\u51fa\u73b0mcp_docs_search<\/p>\n\n\n\n
                  \u6743\u9650\u548chooks<\/strong><\/p>\n\n\n\n
                  \u6743\u9650\u4e0d\u5199\u6b7b\u5728\u5de5\u5177\u6267\u884c\u884c\u91cc\uff0c\u800c\u662f\u4f5c\u4e3aPreToolUse hook<\/p>\n\n\n\n
                  blocked = trigger_hooks(\"PreToolUse\", block)\nif blocked:\n    results.append(tool_result(block.id, blocked))\n    continue<\/code><\/pre>\n\n\n\n
                  \u8fd9\u6837permission\u3001log\u3001\u5ba1\u8ba1\u90fd\u53ef\u4ee5\u6302\u5728\u540c\u4e00\u4e2ahook\u70b9\u4e0a\u3002\u6267\u884c\u540e\u518d\u89e6\u53d1PostToolUse<\/p>\n\n\n\n
                  \u8ba1\u5212\u4e0e\u4efb\u52a1<\/strong><\/p>\n\n\n\n
                  \u4e24\u5c42\u8ba1\u5212<\/p>\n\n\n\n
                    \n
                  • todo_write\uff1a\u5f53\u524d\u4f1a\u8bdd\u7684\u8f7b\u91cf\u8ba1\u5212\uff0c\u4fdd\u5b58\u5728\u5185\u5b58\u4e2d<\/li>\n\n\n\n
                  • task graph\uff1a\u8de8\u4f1a\u8bdd\u3001\u53ef\u4f9d\u8d56\u3001\u53ef\u8ba4\u9886\u7684\u4efb\u52a1\u6587\u4ef6\uff0c\u5199\u5165.tasks\/task_*.json<\/li>\n<\/ul>\n\n\n\n
                    \u524d\u8005\u5e2e\u52a9\u5355\u4e2aAgent\u4e0d\u98d8\u79fb\uff1b\u540e\u8005\u652f\u6491\u56e2\u961f\u534f\u4f5c<\/p>\n\n\n\n
                    \u5b50agent\u4e0e\u56e2\u961f<\/strong><\/p>\n\n\n\n
                      \n
                    • task\uff1a\u4e00\u6b21\u6027subagent\u3002\u72ec\u7acbmessages[]\uff0c\u4e2d\u95f4\u8fc7\u7a0b\u4e22\u5f03\uff0c\u53ea\u8fd4\u56de\u6700\u7ec8\u6458\u8981\u3002<\/li>\n\n\n\n
                    • spawn_teammate\uff1a\u6301\u4e45\u961f\u53cb\u7ebf\u7a0b\u3002\u901a\u8fc7MessageBus\u6536\u53d1\u6d88\u606f\uff0c\u80fdidle\u8f6e\u8be2\u4efb\u52a1\u677f\u5e76\u81ea\u52a8\u8ba4\u9886<\/li>\n<\/ul>\n\n\n\n
                      \u4e00\u6b21\u6027subagent\u89e3\u51b3”\u4e0a\u4e0b\u6587\u9694\u79bb”\uff1b\u6301\u4e45\u961f\u53cb\u89e3\u51b3”\u957f\u671f\u5e76\u884c\u534f\u4f5c”<\/p>\n\n\n\n
                      \u8bb0\u5fc6\u3001\u6280\u80fd\u4e0eprompt<\/strong><\/p>\n\n\n\n
                      assemble_system_prompt(context)\u6bcf\u8f6e\u7ec4\u88c5<\/p>\n\n\n\n
                        \n
                      • \u8eab\u4efd\u548c\u5de5\u5177\u8bf4\u660e<\/li>\n\n\n\n
                      • workspace<\/li>\n\n\n\n
                      • skills catalog<\/li>\n\n\n\n
                      • .memory\/MEMORY.md<\/li>\n\n\n\n
                      • \u5df2\u8fde\u63a5MCP server<\/li>\n<\/ul>\n\n\n\n
                        \u6280\u80fd\u53ea\u5728system prompt\u91cc\u653e\u76ee\u5f55\u3002\u5b8c\u6574\u5185\u5bb9\u901a\u8fc7load_skill(name)\u6309\u9700\u52a0\u8f7d<\/p>\n\n\n\n
                        \u538b\u7f29\u548c\u6062\u590d<\/strong><\/p>\n\n\n\n
                        LLM\u524d\u5148\u8dd1\u538b\u7f29\u7ba1\u7ebf<\/p>\n\n\n\n
                        tool_result_budget \u2192 snip_compact \u2192 micro_compact \u2192 compact_history<\/code><\/pre>\n\n\n\n
                        \u8c03\u7528\u6a21\u578b\u65f6\u518d\u5305\u4e00\u5c42\u6062\u590d<\/p>\n\n\n\n
                        \u8c03\u7528\u6a21\u578b\u65f6\u518d\u5305\u4e00\u5c42\u6062\u590d\uff1a<\/p>\n\n\n\n
                          \n
                        • 429\uff1a\u6307\u6570\u9000\u907f\u91cd\u8bd5<\/li>\n\n\n\n
                        • 529\uff1a\u6307\u6570\u9000\u907f\uff0c\u8fde\u7eed\u5931\u8d25\u53ef\u5207fallback model<\/li>\n\n\n\n
                        • max_tokens\uff1a\u5148\u63d0\u9ad8max_tokens\uff0c\u518d\u8981\u6c42continuation<\/li>\n\n\n\n
                        • prompt too long\uff1areactive compact\u540e\u91cd\u8bd5<\/li>\n<\/ul>\n\n\n\n
                          \u540e\u53f0\u548ccron<\/strong><\/p>\n\n\n\n
                          \u6162bash\u64cd\u4f5c\u4e0d\u4f1a\u963b\u585e\u4e3b\u5faa\u73af<\/p>\n\n\n\n
                          should_run_background \u2192 start_background_task \u2192 placeholder tool_result\n\u540e\u53f0\u5b8c\u6210 \u2192 task_notification \u2192 \u4e0b\u4e00\u8f6e\u6ce8\u5165 messages<\/code><\/pre>\n\n\n\n
                          cron\u8c03\u5ea6\u5668\u72ec\u7acbdaemon thread\u6bcf\u79d2\u68c0\u67e5\u4e00\u6b21\u3002CLI\u4f1a\u76d1\u542ccron_queue\uff0c\u547d\u4e2d\u540e\u4e3b\u52a8\u628a[Scheduled]\u6ce8\u5165\u5e76\u8fd0\u884c\u4e00\u8f6eAgent<\/p>\n\n\n\n
                          worktree\u4e0eMCP<\/strong><\/p>\n\n\n\n
                          worktree\u8d1f\u8d23\u9694\u79bb\u76ee\u5f55<\/p>\n\n\n\n
                            \n
                          • create_worktree(name,task_id)\u521b\u5efa\u72ec\u7acb\u5206\u652f\u548c\u76ee\u5f55<\/li>\n\n\n\n
                          • task\u7684worktree\u5b57\u6bb5\u7ed1\u5b9a\u76ee\u5f55<\/li>\n\n\n\n
                          • \u961f\u53cbclaim\u5230\u5e26worktree\u7684task\u540e\uff0cbash\/read\/write\u81ea\u52a8\u5728\u5bf9\u5e94\u76ee\u5f55\u4e0b\u6267\u884c<\/li>\n<\/ul>\n\n\n\n
                            MCP\u8d1f\u8d23\u5916\u90e8\u80fd\u529b<\/p>\n\n\n\n
                              \n
                            • connect_mcp(name)\u8fde\u63a5mock server<\/li>\n\n\n\n
                            • assemble_tool_pool()\u628aMCP\u5de5\u5177\u7ec4\u88c5\u8fdb\u5de5\u5177\u6c60<\/li>\n\n\n\n
                            • \u5de5\u5177\u540d\u7edf\u4e00\u4e3amcp_server_tool<\/li>\n<\/ul>\n\n\n\n
                              <\/p>\n","protected":false},"excerpt":{"rendered":"
                              Agent loop Agent Loop \uff08\u667a\u80fd\u4f53\u5faa\u73af\uff09\u6307AI Agent\u4e3a\u5b8c\u6210\u76ee\u6807\u800c\u53cd\u590d\u6267\u884c\u7684\u4e00\u5957\u95ed\u73af\u8fc7\u7a0b […]<\/p>\n","protected":false},"author":1,"featured_media":1936,"comment_status":"open","ping_status":"open","sticky":true,"template":"","format":"standard","meta":{"footnotes":""},"categories":[17,1],"tags":[14],"class_list":["post-1933","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-knowledge-base","category-lern","tag-knowledge-base"],"_links":{"self":[{"href":"http:\/\/charlottezhiend.cn:8080\/index.php\/wp-json\/wp\/v2\/posts\/1933","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/charlottezhiend.cn:8080\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/charlottezhiend.cn:8080\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/charlottezhiend.cn:8080\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/charlottezhiend.cn:8080\/index.php\/wp-json\/wp\/v2\/comments?post=1933"}],"version-history":[{"count":26,"href":"http:\/\/charlottezhiend.cn:8080\/index.php\/wp-json\/wp\/v2\/posts\/1933\/revisions"}],"predecessor-version":[{"id":2277,"href":"http:\/\/charlottezhiend.cn:8080\/index.php\/wp-json\/wp\/v2\/posts\/1933\/revisions\/2277"}],"wp:featuredmedia":[{"embeddable":true,"href":"http:\/\/charlottezhiend.cn:8080\/index.php\/wp-json\/wp\/v2\/media\/1936"}],"wp:attachment":[{"href":"http:\/\/charlottezhiend.cn:8080\/index.php\/wp-json\/wp\/v2\/media?parent=1933"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/charlottezhiend.cn:8080\/index.php\/wp-json\/wp\/v2\/categories?post=1933"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/charlottezhiend.cn:8080\/index.php\/wp-json\/wp\/v2\/tags?post=1933"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}