node ~/.openclaw/skills/agent-work-visibility/deactivate.js

Agent Work Visibility v3.0

系统级任务透明层 - Agent 的职业本能

⚠️ 这不是一个技能，而是 Agent 的职业素养。

透明层不应该被触发，它应该是 Agent 工作时的默认状态。

---

🎯 核心哲学 (Core Philosophy)

3.0 重大重构

v2.x 的问题：

• - ❌ 依赖关键词匹配（用户说查查才触发）
• ❌ 被动等待调用（Agent 可以绕过）
• ❌ 被视为独立工具（与业务逻辑分离）

v3.0 的原则：

• - ✅ 基于任务属性触发（只要涉及 API/联网/多步 → 自动启动）
• ✅ 系统级中间件（业务逻辑无法绕过）
• ✅ Agent 的职业本能（不启动 = 失职）

触发逻辑对比

❌ v2.x（关键词匹配）：
用户：查查 bnb memecoin top3
→ 匹配查查 → 触发透明层
→ 匹配失败 → 不触发（Agent 直接执行）

✅ v3.0（任务属性感知）：
用户：bnb memecoin top3
→ 识别任务类型：crypto-market-rank
→ 检测属性：外部 API + 联网 + 多步
→ 自动启动透明层（无条件的）

---

📋 调用协议 (Invocation Protocol)

强制调用顺序

任何长任务必须遵循：

1. 1. 感知任务属性 → 2. 启动透明层 → 3. 执行业务逻辑

代码层面的强制流程：

javascript
// ✅ 正确流程（v3.0）
async function executeTask(userQuery) {
// Step 1: 感知任务属性
const taskProps = analyzeTask(userQuery);

// Step 2: 如果是长任务，必须先启动透明层
if (taskProps.isLongRunning) {
await createvisibilitytask(
generateId(),
extractTitle(userQuery),
taskProps.type,
taskProps.totalSteps
);
}

// Step 3: 执行业务逻辑
const result = await executeBusinessLogic(userQuery);

// Step 4: 完成透明层
await updatevisibilityphase(taskId, 完成, complete, 100);

return result;
}

// ❌ 错误流程（禁止！）
async function executeTask(userQuery) {
// 直接执行，绕过透明层 → 职业失职！
return await executeBusinessLogic(userQuery);
}

任务属性检测

只要满足任一条件，必须启动透明层：

属性	检测条件	示例
外部 API	调用非本地服务	crypto-market-rank, web_search
链上数据

读取区块链状态 | query-address-info, query-token-info |
| 联网操作 | 需要 HTTP 请求 | web_fetch, browser |
| 多步推理 | 步骤≥3 | 比较/分析/调研类任务 |
| 子 Agent | 需要协作 | 调用其他 bot/skill |
| 耗时>10 秒 | 预估执行时间 | 任何可能等待的操作 |

---

🔧 核心接口

调用方式（CLI v3）

通过 exec 调用 CLI v3 工具：

bash

创建任务（第一优先级！）

node ~/.openclaw/skills/agent-work-visibility/bin/agent-visibility-v3.js create task-001 查询 BNB MemeCoin Top3 api

更新进度（每步 + 每 60 秒）

node ~/.openclaw/skills/agent-work-visibility/bin/agent-visibility-v3.js update task-001 连接 API 25 正在获取数据

完成任务

node ~/.openclaw/skills/agent-work-visibility/bin/agent-visibility-v3.js complete task-001

查看状态

node ~/.openclaw/skills/agent-work-visibility/bin/agent-visibility-v3.js status task-001

报告阻塞

node ~/.openclaw/skills/agent-work-visibility/bin/agent-visibility-v3.js block task-001 API 响应超时

在 LLM 中使用（通过 exec）：

javascript
// 1. 创建任务（第一优先级！）
exec(node ~/.openclaw/skills/agent-work-visibility/bin/agent-visibility-v3.js create task-001 查询 BNB MemeCoin Top3 api)

// 2. 更新进度（每步操作后 + 每 60 秒）
exec(node ~/.openclaw/skills/agent-work-visibility/bin/agent-visibility-v3.js update task-001 连接 API 25 正在获取数据)

// 3. 完成任务
exec(node ~/.openclaw/skills/agent-work-visibility/bin/agent-visibility-v3.js complete task-001)

输出格式

🟢 查询 BNB MemeCoin Top3
━━━━━━━━━━━━━━━━━━━
进度：[█████░░░░░░░░░░░░░░░] 25% (1/4)
━━━━━━━━━━━━━━━━━━━
健康度：🟢 健康 (100/100)
当前阶段：连接 API
正在做什么：正在获取 BNB 链 MemeCoin 数据
已运行：0 分钟

---

🎯 使用场景

场景 1：Crypto 排行榜查询

用户：bnb memecoin top3

[任务属性分析]
→ 需要调用 crypto-market-rank
→ 涉及外部 API + 联网
→ 必须启动透明层

[自动执行]
✅ createvisibilitytask(task-001, 查询 BNB MemeCoin Top3, api, total_steps=4)

[输出视图]
🟢 查询 BNB MemeCoin Top3
━━━━━━━━━━━━━━━━━━━
进度：[█████░░░░░░░░░░░░░░░] 25% (1/4)
━━━━━━━━━━━━━━━━━━━
健康度：🟢 健康 (100/100)
当前阶段：连接 API
正在做什么：正在获取 BNB 链 MemeCoin 数据
已运行：0 分钟

[执行业务]
→ crypto-market-rank 获取数据

[更新进度]
✅ updatevisibilityphase(task-001, 数据处理, update, 50, 2, 4)

[输出视图]
🟢 查询 BNB MemeCoin Top3
━━━━━━━━━━━━━━━━━━━
进度：[██████████░░░░░░░░░░] 50% (2/4)
━━━━━━━━━━━━━━━━━━━
健康度：🟢 健康 (100/100)
当前阶段：数据处理
正在做什么：正在解析 Top3 代币信息
已运行：1 分钟

[完成]
✅ updatevisibilityphase(task-001, 完成, complete, 100, 4, 4)

场景 2：链上地址查询

用户：0x1234...5678 持有哪些币

[任务属性分析]
→ 需要调用 query-address-info
→ 涉及链上数据抓取
→ 必须启动透明层

[自动执行]
✅ createvisibilitytask(task-002, 查询地址持仓, onchain, total_steps=5)

[输出视图]
🟢 查询地址持仓
━━━━━━━━━━━━━━━━━━━
进度：[█████░░░░░░░░░░░░░░░] 20% (1/5)
━━━━━━━━━━━━━━━━━━━
健康度：🟢 健康 (100/100)
当前阶段：连接 RPC
正在做什么：正在读取链上代币余额
已运行：0 分钟

场景 3：多步分析任务

用户：比较 5 个 AI Agent 框架

[任务属性分析]
→ 需要多步推理（≥3 步）
→ 涉及信息搜集 + 分析
→ 必须启动透明层

[自动执行]
✅ createvisibilitytask(task-003, 比较 AI 框架, analysis, total_steps=7)

[每步同步]
✅ updatevisibilityphase(..., 框架 1: LangChain, update, 14, 2, 7)
✅ updatevisibilityphase(..., 框架 2: AutoGen, update, 28, 3, 7)
✅ updatevisibilityphase(..., 框架 3: CrewAI, update, 42, 4, 7)
...

场景 4：遇到阻塞

[阻塞检测]
⚠️ API 响应超时 45 秒

[自动报告]
✅ reportvisibilityblocker(task-001, api_timeout, API 响应超时, medium)

[用户