⚖️ Veritas Kanban

Veritas in actis — 知行合一的真相。

本地优先的任务管理与 AI 智能体编排平台。

专为希望使用自主编程智能体（Autonomous Coding Agents）协作，并追求可视化看板管理体验的开发者打造。

🎬 观看完整演示视频 (MP4)

⭐ 如果您觉得本项目有帮助，请给项目加个星标 — 这能帮助更多人发现它！

快速入门 · 功能亮点 · 为什么选择 VK · 全部功能 · 文档 · 故障排除 · API · 智能体集成 · MCP Server · 贡献指南 · 更新日志

---

由 Brad Groux 创建 — Digital Meld 首席执行官，Start Small, Think Big 播客主持人 · LinkedIn · Twitter · YouTube

---

⚡ 快速入门

想走捷径？直接向你的智能体（如 OpenClaw）下达指令：

Clone and set up veritas-kanban locally. Install dependencies with pnpm, copy the .env.example, and start the dev server. Verify it's running at localhost:3000.

想自己动手？5 分钟内即可完成部署：

git clone https://github.com/BradGroux/veritas-kanban.git
cd veritas-kanban
pnpm install
cp server/.env.example server/.env   # 编辑文件以修改 VERITAS_ADMIN_KEY
pnpm dev

打开 http://localhost:3000 — 完成。系统在首次运行时会自动生成示例任务，方便你快速探索。

想要清空看板？ 删除示例任务：rm tasks/active/task_example_*.md 并刷新页面。 想要重新生成示例？ 运行 pnpm seed 即可恢复示例任务（仅在看板为空时有效）。

注意： 请勿将 .env 文件提交到版本库。请使用 .env.example 作为模板，其中包含安全的占位值及详细的变量说明。

---

📚 文档地图

• MCP Server 指南 — 包含 33+ 工具、架构、快速入门、工具目录、安全模型及故障排除。
• API 参考 — 认证、端点、请求/响应示例、WebSocket 及常用工作流。
• 自托管指南 — 生产环境部署、反向代理、安全加固、Docker 及备份。
• 入门指南 — 从零到智能体就绪只需 5 分钟，另含健康检查和提示词仓库（Prompt Registry）技巧。
• 智能体任务工作流 SOP — 生命周期、API/CLI 代码片段、提示词。
• Squad Chat 协议 — 智能体间消息传递、系统事件（生成/完成/失败）、模型归属及辅助脚本。
• Sprint 规划 SOP — 从史诗（Epic）到迭代（Sprint）再到任务拆解。
• 多智能体编排 — 项目经理（PM）与执行者（Worker）的任务交接。
• 跨模型代码审查 — 强制执行 Claude ↔ GPT 互审机制。
• 智能体治理 SOP — 策略引擎、偏差检测、决策审计追踪、输出评估、用户反馈。
• 操作 SOP — 广播、委派、交付物、提示词仓库、Squad Chat、系统健康监测。
• 最佳实践 & 实用技巧 — 模式、快捷键、集成方案。
• 真实案例 — 可直接复制粘贴的智能体方案。
• 故障排除 — 遇到问题时的深度诊断指南。

⚠️ 智能体 AI 安全

[!CAUTION] AI 智能体能够编写代码、执行命令并修改你的系统。 虽然 Veritas Kanban 等工具让智能体工作流变得强大，但如果没有适当的防范措施，也可能造成实质性破坏。在向任何 AI 智能体授予环境访问权限之前，请务必阅读相关安全文档。

智能体 AI 最佳实践