企业官网建设流程全解析

Craft Agents状态工作流使用指南：Todo到Done管理AI会话的艺术

【免费下载链接】craft-agents-oss项目地址: https://gitcode.com/GitHub_Trending/cr/craft-agents-oss

Craft Agents 是一款开源的 AI Agent 会话管理工具，它的核心亮点之一就是状态工作流（Status Workflow）：通过 Todo → Needs Review → Done 这样清晰的阶段流转，帮你把成百上千个 AI 会话整理得井井有条，再也不会迷路在混乱的会话列表里。无论你是刚接触 AI 编程新手，还是管理大量 Agent 任务的老手，这套状态系统都能让你快速上手、高效收尾。

状态工作流是什么？为什么需要它

当你同时运行多个 AI 会话时，很容易出现这种情况：这个任务做到哪一步了？那个会话还需要人工检查吗？

Craft Agents 借鉴了经典看板（Kanban）思想，给每个会话打上一个状态标签：

• Backlog（待办池）：还没打算做，先存着
• Todo（待办）：准备开工，新会话的默认状态
• Needs Review（待审查）：AI 已完成，等你确认结果
• Done（已完成）：任务收尾，移入归档
• Cancelled（已取消）：不再继续的任务

默认状态配置定义在 storage.ts 中，其中 Todo、Done、Cancelled 是"固定状态"（不可删除），Backlog 和 Needs Review 则可以根据你的习惯修改。

💡 像规划登山路线一样规划你的任务：先看全景（Backlog），再确定路径（Todo），逐步推进，最终登顶（Done）。

收件箱与归档：open 和 closed 两大类别

每个状态都有一个**类别（Category）**属性，它决定了会话出现在哪里：

这个设计非常贴心：你的收件箱永远只保留"活着"的任务，已完成和已取消的会话自动沉入归档区，界面清爽不杂乱。类别逻辑的完整定义见 types.ts。

如何查看和修改会话状态

快速切换：状态徽章

每个会话卡片上都有一个彩色圆点 + 文字组成的状态徽章（Status Badge）。它的颜色会随状态自动变化——比如 "Needs Review" 是醒目的琥珀色，"Done" 是代表完成的紫色。当会话正在实时生成内容时，圆点还会泛起脉冲光环，一眼就能看出哪些 AI 正在干活。徽章组件源码位于 StatusBadge.tsx。

看板视图：拖拽即流转

打开看板（Kanban Board）视图，你会看到三列经典布局：Todo / In Progress / Done。拖拽任务卡片即可改变它所在的列，状态同步更新：

• in-progress、needs-review等状态默认归入In Progress列
• done、cancelled归入Done列
• 其余状态落在Todo列

列的映射规则很简单明了，见 status-column.ts，看板主体实现见 KanbanBoard.tsx。

自定义你的专属状态系统

Craft Agents 的状态工作流是完全可配置的——这正是"Agent Native"理念的体现：你的流程应该匹配你的工作方式，而不是反过来。

你可以随时：

1. 新建状态：比如加一个 "Blocked（被阻塞）" 或 "Waiting on Team（等队友）"，支持自定义颜色和图标（emoji、URL 图片、本地 SVG 均可）
2. 重命名/改色：默认的 Backlog、Needs Review 可以改成任何你喜欢的名字
3. 调整顺序：拖拽即可改变状态在列表中的显示顺序
4. 删除自定义状态：使用该状态的会话会被自动迁移到 Todo，不会丢失任何数据

这些增删改查操作的完整实现位于 crud.ts，其中业务规则（如固定状态不可删除、删除后自动迁移会话）都有严格保护，不用担心误操作。

配置存在哪里？

每个工作区（Workspace）的状态配置独立存储，配置文件位于工作区根目录下的statuses/config.json，状态图标存放在statuses/icons/文件夹中。存储与加载逻辑见 storage.ts。

这种按工作区隔离的设计意味着：你可以为"工作项目"配置严谨的审查流程，为"个人实验"配置轻量的三状态流转，互不干扰。

新手上手三步走 🚀

1. 创建会话：新会话默认进入 Todo 状态，出现在收件箱
2. 交给 AI 干活：Agent 完成任务后，把会话标记为 Needs Review，用琥珀色提醒你来验收
3. 验收收尾：满意则标记 Done 归档；不满意可改回 Todo 继续迭代

总结

Craft Agents 的状态工作流把"管理 AI 会话"这件琐事，变成了一条清晰的流水线：Todo 起步 → Needs Review 把关 → Done 收尾。它内置了合理的默认流程，又保留了完整的自定义能力，无论是个人用户还是团队协作，都能找到最顺手的节奏。上手只需要几分钟，收益却是长期清晰可控的 Agent 工作流。

【免费下载链接】craft-agents-oss项目地址: https://gitcode.com/GitHub_Trending/cr/craft-agents-oss