Think Skill

强制 AI Agent 在执行任何高风险或实质性操作(如修改文件、执行命令、查询数据库)前进行逻辑梳理、步骤拆解。这是一种显式驱动 ReAct 循环的思想链(CoT)触发器。

valkryhx 29e60bf 2 files · 3.5 KB Updated

File contents

Think Skill (思考技能)

概述

think_skill 提供了一个 Dummy Tool(无副作用的思考白板工具)—— think_and_plan。通过该工具,Agent 可以在“脑海中”拆解复杂任务,并将推理过程持久化到日志中,从而极大地提升复杂场景下的准确度和逻辑严密性。


核心提示词与约束规则 (System Prompt)

为了强制 Agent 养成“先想后做”的习惯,建议在 System Prompt 中加入以下硬性约束规则:

[!IMPORTANT] 💡 思考优先原则 你是一个高级 AI Agent。对于任何需要多步操作或高风险的操作(如执行代码、修改文件、发送API请求、删除资源等),必须直接调用 think_and_plan 工具

在面对复杂任务时,你必须首先调用 think_and_plan 工具,结构化地写下你对当前状态的分析、接下来的 Todo 列表 以及潜在风险。 只有在收到思考确认信息后,你才能继续调用其他实质工具。


工具使用指南

1. think_and_plan

这是该技能的核心工具。

  • current_state_analysis (String):
    • 填写规范:对目前已知的信息进行建模,分析已经拿到了什么,还缺什么,当前遇到了什么阻塞。
  • next_steps (List[String]):
    • 填写规范:清晰、细颗粒度的步骤列表。例如:
      1. 检查 app.py 的第 40 行导入语句
      2. 使用 pip 安装 missing_module
      3. 重启服务验证
  • potential_risks (String, 可选):
    • 填写规范:提前反思可能踩坑的点。例如:“修改配置文件可能会导致端口冲突,需要先检查 netstat”。

适用场景 (WHEN to use)

  1. 复杂代码重构:涉及 3 个以上文件的关联修改前。
  2. 带有风险的 Shell 命令:运行 rm, kill, docker 等指令前。
  3. 遇到报错或死循环:当连续 2 次工具调用报错时,必须调用 think_and_plan 进行错误反思(反思为什么会报错,以及下一步修正动作)。

valkryhx/google_adk_agent/tree/main/skills/think_skill commit 29e60bf99f

Frequently asked questions

npx skillmds@latest add valkryhx/think-skill