MagicWork：面向AI辅助开发的Markdown优先并行工作流系统

MagicWork是一款面向AI辅助开发的Markdown优先并行工作流系统，核心解决AI编程助手普及后多并行编码任务的管理挑战。它以Markdown任务卡片为核心，通过Git工作树隔离、可恢复会话和终端自动化等机制，帮助开发者高效管理多个并行AI任务，避免上下文混乱与进度追踪困难，提升开发协作效率。

AI编程助手普及后，开发者面临多并行AI编码任务的组织难题：传统单一会话模式易导致上下文混乱、进度难追踪。MagicWork的愿景是成为AI辅助开发的日常操作系统，而非简单工具。每天从日期分组的Markdown任务卡片开始，每张卡片对应独立Git工作树、分支、终端空间与可恢复会话，支持多任务自由切换，如同与多个队友协作。

核心设计原则

1. Markdown优先：任务卡片为Markdown格式，既是文档也是配置，消除配置与文档割裂。
2. 严格路径分离：区分osRoot（配置/状态）、recordsDir（任务卡片/索引）、codeDir（工作树），边界清晰。
3. 可恢复会话：作为核心能力，存储会话ID，支持中断后准确恢复状态。
4. 终端级信号集成：AI等待输入时通过终端发出信号，避免错过人工介入时机。

关键命令

• init：初始化每日工作空间，生成任务卡片；
• sync：重建索引确保概览与任务一致；
• run：创建隔离工作树与终端空间，启动未开始任务；
• restore：恢复活跃任务会话，不重新初始化；
• clean：清理工作树，可生成摘要；
• report：生成/追加摘要；
• config：管理路径与钩子配置。

Codex+kitty参考实现

• 共享Socket：所有任务窗口连接统一kitty socket，支持统一控制；
• 等待输入检测：监听Codex等待事件，更新标签页标记并触发通知；
• 快速切换：通过kls助手（kitty+ fzf）快速跳转任务窗口。

生命周期钩子

通过onCodeTabOpen/onClean等配置注入脚本，分离核心逻辑与项目定制流程，支持仓库特定初始化与资源释放。

自动摘要

基于智能体会话历史生成摘要，与clean/report绑定，确保工作痕迹可靠，不依赖终端输出抓取。

MagicWork适用于以下场景：

1. 并行功能开发：多独立功能在隔离工作树演进，互不干扰；
2. 长周期任务管理：可恢复会话支持中断与继续数天/周的任务；
3. 团队协作准备：合并前提供完整审查与摘要机制；
4. 实验性探索：快速验证多个想法，失败任务可清理，成功保留记录。

MagicWork代表AI辅助开发的新范式：将AI视为需专门基础设施支持的协作伙伴。通过Markdown优先设计、隔离机制、会话管理与终端集成，赋能开发者管理多并行AI工作流。未来，这类工作流系统将成为开发者工具链核心，为更复杂AI协作模式奠定基础。