Skip to content

valkryhx/google_adk_agent / skills/think_skill

think_skill

Verified

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

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

# 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` 进行错误反思(反思为什么会报错,以及下一步修正动作)。
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall