agent-bus

基于 agent-first 思想的飞书项目管理系统骨架。

这个仓库不是一个可运行的产品，而是一份设计骨架：

• 目录结构、契约文档、配置模板、agent 元文件都已就位
• 未来的工程师（或 agent）可以直接按本仓库的契约实施业务代码
• 所有文档一律 Markdown，所有配置一律 YAML/SQL

核心理念

1. Git = 业务真相：所有需求/报告/会议纪要/看板都是 Markdown 文件，版本化、可审计
2. 飞书 = 沟通通道：只做 IM（机器人）、妙记（会议输入）、消息卡片（通知）
3. 每个员工配一个专属 agent + 专属飞书机器人（1 对 1）
4. agent 之间不直接通信：协作全部通过写 Markdown → 文件变更 → 订阅者被唤醒

如何阅读本仓库

建议按以下顺序：

1. 先读 Spec：docs/superpowers/specs/2026-04-16-agent-bus-feishu-design.md —— 完整架构设计，7 节正文 + 附录
2. 再读 Plan：docs/superpowers/plans/2026-04-16-agent-bus-feishu-plan.md —— 本骨架的实施计划（产出目录与清单）
3. 查 Contracts：docs/contracts/ —— 6 份权威契约（frontmatter / 指令块 / 状态机 / commit 消息 / 审批门 / 飞书卡片）
4. 看 Agent 骨架：agents/_shared/ → 具体角色目录
5. 跑 Demo 脚本：docs/runbooks/e2e-demo.md

仓库导航

设计与计划

• Spec
• Plan
• 验收清单

契约（权威定义）

• 任务 frontmatter
• 指令块 / 回问块
• 状态机
• commit 消息
• 审批门禁
• 飞书消息卡片

Runbooks

• 端到端演练
• 故障处理
• 事件类型参考

Agents

• 共享协议与通用指令
• PM agent · Alice
• dev agent · Bob
• qa agent · Carol
• devops agent · Dan
• docs agent
• reporter agent

配置与基础设施

• 订阅路由表模板
• 审批策略模板
• SQLite 建表脚本

样例

• 样例项目：demo-ecommerce
• 人员档案

状态

• 骨架生成日期：2026-04-16
• 阶段：设计完成 · 骨架就位 · 待代码实施