无需改 Agent 循环，循环 Agent 核心调度方式。

在 v1 的工具列表基础上，v2 新增 TodoManager 管理和 TodoWrite 工具。

todo_manager = TodoManager
def execute_tool:
    if name == "TodoWrite":
        try:
            todo_manager.update
            # 返回给模型kan的文本形式，模型Ke以据此继续思考和geng新
            return todo_manager.summary_text
        except Exception as e:
            return f" {e}"
    # 其他工具: bash / read_file / write_file / edit_file...
    ...

小叙：从 Bash 到 SKILL 的灵感火花

说实话，我刚把一段老掉牙的 Bash 脚本搬到电脑里结果卡死了。

那一瞬间，我脑子里冒出一个念头：干脆把脚本包装成 SKILL，让 Agent 自己去跑？

哈哈，这主意听起来像是把厨房的锅直接塞进微波炉——有点疯狂，但谁不爱尝鲜呢。

于是我开始拆解这件事儿，顺便把“怎么让 AI Neng懂得你的 Bash”写成一篇文章。

第一步：把 Bash 当作「元工具」来认识

Bash 本身就是操作系统的底层语言，几乎所有命令行工具douNeng在它下面跑。

所以我们Ke以把 Bash 当成一个「万Neng钥匙」：

文件读写 → cat、echo、sed

系统查询 → ls、find、grep

网络请求 → curl、wget

咱就是说只要Neng在终端敲进去的，douKe以抽象成一个 tool 调用。

第二步：定义 SKILL 的结构化描述

S K I L L 其实是个 Markdown 文档，加上一点元信息就Neng被 Agent 读取。

--- 
name: deploy_app
description: 自动化部署 Web 应用
--- 
# 步骤
1. 拉取Zui新代码
2. 安装依赖
3. 重启服务

bash
git pull origin main
npm install
pm2 restart app

这个文档里既有「说明」也有「可执行代码块」。Agent 在需要时会把代码块提取出来用 Bash 执行。

第三步：让 Agent Neng够「加载」SKILL 并执行其中的 Bash 块

核心函数大概长这样：

def load_skill:
    # 读取 skill 文件
    content = open.read
    # 正则提取 
bash 块
    cmds = re.findall\

', content, re.DOTALL)
    return cmds
def run_skill:
    cmds = load_skill
    for cmd in cmds:
        result = run_bash   # 这里调用我们之前封装好的 bash 执行器
        logger.info
    return "Skill 完成"

注意，这里我们没有硬编码任何业务逻辑，一切dou交给 Skill 文档自己说话。咱们只负责把它搬运到机器上执行。

实战案例：从简单脚本到完整 Agent 工作流 #1 把单文件复制脚本转成 Skill

Bash 原始脚本：

#!/bin/bash
src="/tmp/data.txt"
dst="/var/www/html/data.txt"
cp "$src" "$dst"
echo "复制完成"

S K I L L 文档：

---
name: copy_data
description: 将临时数据复制到网站根目录
---
# 操作步骤

bash
src="/tmp/data.txt"
dst="/var/www/html/data.txt"
cp "$src" "$dst"
echo "复制完成"

A g e n t 调用流程：

User 提问：「帮我把 data.txt 放到网站目录」.

L​LM 判断需要使用 `Skill` 工具.

`Skill` 参数为 `copy_data`.

A​gent 加载 Skill 内容并执行其中的 Bash.

A​gent 把执行结果回报给用户.

#2 多步骤部署 Skill 示例

S K I L L 内容：

---
name: deploy_webapp
description: 自动化部署 Node.js Web 应用
---
# Todo 列表
git pull origin main
npm install --production
pm2 restart myapp

A​gent 在每一步dou会调用 `TodoWrite` geng新状态，然后继续跑下一条 Bash。整个过程像是有人手动敲键盘，但实际上是模型在背后调度的。

为什么百度不收录？——顺带聊聊 SEO 小技巧

a) 你得明白搜索引擎爬虫喜欢结构化的数据。

b) 我们的 SKILL 文档Ru果直接放在项目根目录，且没有 robots.txt 限制，它们会被抓取。但Ru果你用了太多内部链接或者文件名里有中文空格，爬虫可Neng会迷路。

b) 再说一点——标题要明确。比如「如何将 Bash 脚本转换为 SKILL 实现 Agent？」这种长尾关键词正好匹配搜索需求，记得在 `