Auto-sync: 2026-04-27 12:02

wiki/sources/project-state-management.md

@@ -1,45 +1,63 @@
----
-title: "Project State Management System: Event-Driven Alternative to Kanban"
-type: source
-tags: [project-state]
-date: 2026-04-22
----
-
-## Source File
-- [[Agent/usecases/project-state-management.md]]
-
-## Summary（用中文描述）
-- 核心主题：用事件驱动系统替代传统看板管理项目状态
-- 问题域：传统看板（Kanban）静态、需手动更新、容易遗忘、上下文丢失、无法追踪变更原因
-- 方法/机制：自然语言对话式输入 → 事件日志 → 状态自动更新 → 自然语言查询；支持 Git 提交自动关联项目，每日 Cron 汇总报告
-- 结论/价值：消灭"更新卡片"的摩擦，保留决策上下文，让项目状态查询和每日站会自动化
-
-## Key Claims（用中文描述）
-- 自然语言对话替代拖拽看板卡片的机制：用户说"完成了X"/"被Y阻塞" → 系统自动记录事件并更新项目状态
-- 全历史保留机制：每次状态变更均记录事件类型、描述、上下文、时间戳，而非仅存储当前状态
-- Git 提交自动关联机制：Cron Job 扫描过去 24 小时提交，按分支名或提交信息匹配项目
-- 每日站会自动化机制：9 AM 自动汇总"昨日进展 + 今日计划 + 当前阻塞"
-
-## Key Quotes
-> "Traditional Kanban boards are static and require manual updates. You forget to move cards, lose context between sessions, and can't track the 'why' behind state changes." — 看板痛点描述
-> "Instead of dragging cards, you chat with your assistant: 'Finished the auth flow, starting on the dashboard.'" — 事件驱动交互模式
-
-## Key Concepts
-- [[Event Sourcing]]：将项目状态变更存储为事件序列，而非仅记录当前状态，每次变更（progress/blocker/decision/pivot）均作为独立事件持久化，保留完整上下文
-- [[Project State]]：项目的当前状态元数据（status/phase/last_update），由事件自动驱动更新，而非手动维护
-
-## Key Entities
-- [[OpenClaw]]：项目状态管理系统的核心平台，提供多 Agent 编排和 Telegram/Discord 通知集成能力
-- PostgreSQL / SQLite：项目状态数据库的持久化存储引擎
-
-## Connections
-- [[Event Sourcing]] ← uses ← [[Project State Management]]
-- [[OpenClaw]] ← powers ← [[Project State Management]]
-- [[GitHub]] ← provides commit data to ← [[Project State Management]]
-- [[Project State Management]] ← alternative_to ← [[Kanban]]
-
-## Contradictions
-- 与 [[Kanban]]（看板）存在方法论冲突：
-  - 冲突点：手动卡片拖拽 vs 事件驱动自动更新；静态快照 vs 全历史保留
-  - 当前观点（Event Sourcing）：事件驱动记录保留完整决策上下文，避免手动维护的摩擦和遗忘
-  - 对方观点（Kanban）：可视化面板提供直觉化状态概览，适合团队协作场景
+---
+title: "Project State Management System: Event-Driven Alternative to Kanban"
+type: source
+tags: [project-state, automation, ai, workflow]
+date: 2026-04-27
+---
+
+## Source File
+- [[raw/Agent/usecases/project-state-management.md]]
+
+## Summary（用中文描述）
+- 核心主题：用事件驱动系统替代传统 Kanban 看板，实现项目状态的自动化追踪与上下文保留
+- 问题域：Kanban 看板易失效（忘记移动卡片）、上下文丢失（无法追溯决策原因）、无代码变更与项目进度的自动关联
+- 方法/机制：
+  - PostgreSQL/SQLite 存储项目状态（projects 表 + events 表 + blockers 表）
+  - AI Agent 解析自然语言命令，自动生成 progress/blocker/decision/pivot 事件
+  - 每日 Cron 任务扫描 Git 提交（gh CLI），将 commit 链接到项目事件
+  - Discord/Telegram 频道接收更新通知和响应查询
+  - 每日站会摘要自动生成
+- 结论/价值：用自然对话替代手动看板维护，保留完整决策历史，实现"项目为什么这样"的即时查询能力
+
+## Key Claims（用中文描述）
+- 自然语言对话（"完成了X，被Y阻塞"）→ 自动触发项目状态转换，无需手动拖拽看板
+- 项目状态由事件序列自动推导，而非手动维护的快照
+- Git 提交自动扫描并关联到项目事件，实现代码变更与进度的可追溯链接
+- 每日站会摘要由 AI Agent 根据过去 24 小时事件和提交自动生成
+- Sub-agent 并行分析各项目状态，在 Sprint 规划时提供优先级建议
+
+## Key Quotes
+> "Kanban boards become stale. You waste time updating cards instead of doing work. Context gets lost—three months later, you can't remember why you made a key decision." — 痛点描述
+
+> "Instead of dragging cards, you chat with your assistant: 'Finished the auth flow, starting on the dashboard.' The system logs the event, updates project state, and preserves context." — 核心交互模式
+
+> "Git commits are automatically scanned and linked to projects. Your daily standup summary writes itself." — 自动化价值总结
+
+## Key Concepts
+- [[EventSourcing]]：本系统的底层架构模式 —— 所有状态变更作为不可变事件序列持久化，通过重放事件重建任意时间点状态
+- [[Kanban]]：本系统要替代的传统方案 —— 静态看板需手动更新，无法保留决策上下文
+- [[ProjectState]]：本系统的核心抽象 —— 项目任意时间点的完整快照，由事件序列自动驱动更新
+- 事件类型（progress / blocker / decision / pivot）：与 [[EventSourcing]] 中的事件类型定义完全一致
+
+## Key Entities
+- Discord：项目状态频道（#project-state）—— 接收事件更新通知、响应状态查询、发布每日站会摘要
+- Telegram：备选消息平台 —— 同样用于更新推送和自然语言查询接口
+- GitHub CLI（gh）：每日 Cron 扫描 Git 提交 —— 根据分支名或提交信息将 commit 关联到项目
+- PostgreSQL / SQLite：项目状态数据库 —— 存储 projects、events、blockers 三张核心表
+- Cron：定时任务调度器 —— 每日 9 AM 触发站会摘要生成
+- Sub-agents：并行项目分析器 —— Sprint 规划时并行分析各项目状态并提供优先级建议
+
+## Connections
+- [[ProjectState]] ← derived_from ← **EventSourcing**（[[ProjectState]] 由事件溯源模式驱动）
+- **Project State Management** ← uses ← [[EventSourcing]]（事件溯源是本系统的技术基础）
+- [[ProjectState]] ← uses ← **Discord**（Discord 承载事件通知和查询接口）
+- [[ProjectState]] ← uses ← **gh CLI**（GitHub CLI 实现提交与项目的自动关联）
+- **Project State Management** ← extends ← [[Vibe-Kanban]]（事件驱动管理是 Vibe-Kanban 的进阶形态）
+- [[Kanban]] ← alternative_to ← **Project State Management**（冲突：Kanban 静态可视化 vs 事件驱动自动追踪）
+
+## Contradictions
+- 与 [[Kanban]] 冲突：
+  - 冲突点：状态更新机制 —— Kanban 依赖手动拖拽卡片，事件驱动系统依赖自然语言对话自动记录
+  - 当前观点：手动看板易失效、丢失上下文；事件驱动自动追踪且保留完整历史
+  - 对方观点：Kanban 提供实时可视化，多人协作场景下状态一目了然，无需依赖 AI 解析准确性
+- 与 [[Vibe-Kanban]] 关系：Vibe-Kanban 是本地化的事件驱动看板实验，本系统是其在 Discord/Telegram 多渠道 + Git 集成 + 每日摘要方向的完整工程实现