---
title: "TaskVisibility"
type: concept
tags: []
last_updated: 2026-05-02
---

## Definition
AI Agent 任务执行过程的可视化透明度——使人类用户能追踪 Agent 的当前状态、已完成步骤和潜在阻塞。

## Description
在长时间运行的 Agentic Workflow 中（如构建全栈应用、深度研究），用户往往无法实时了解：
- Agent 当前正在执行哪一步
- 已完成哪些子步骤
- Agent 在哪里卡住或陷入死循环

TaskVisibility 通过外部化 Agent 的内部推理过程来解决这个问题。

## Implementation Patterns
- **状态分区**：使用不同状态标签区分任务阶段（🟡 In Progress / 🟠 Waiting / 🟢 Done）
- **计划外化**：将 Agent 的内部 Plan 写入任务描述，供人类审阅
- **实时日志追加**：以评论形式实时追加子步骤完成记录
- **停滞检测**：心跳脚本自动检测停滞任务并触发告警

## Related Concepts
- [[AgenticWorkflow]]
- [[ExternalReasoning]]
- [[ProjectStateManagement]]

## Examples
- [[TodoistTaskManager]]：通过 Todoist 实现 TaskVisibility
- [[ProjectStateManagement]]：通过事件驱动方案实现任务状态追踪