---
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` 进行错误反思（反思为什么会报错，以及下一步修正动作）。