老板要周报？我说不用，代码提交就是进度

当代码提交变成进度条，当 PRD 文档一键拆成任务列表，当 AI 帮你写提交说明------研发进度管理原来可以这么轻。

一、研发进度管理，为什么总是这么难？

作为一个全栈开发者，我长期被一个问题困扰：代码写了不少，但进度条总是不准。

常见场景：

周一会议上项目经理问"登录模块做到哪了"，我说"差不多了"，其实才 60%。
禅道/Jira 的任务状态是"进行中"，但具体多少全靠记忆。
周报写不出来，得翻 git log 一条条回忆这周干了啥。
新需求 PRD 发下来，手动拆任务要半小时，还容易漏。

现有工具太重了。Jira 配置复杂、禅道 UI 老旧、飞书项目又要切窗口。我更想要一个：不离开终端、不增加操作负担、提交代码时顺便把进度也上报了 的工具。

于是有了 MaDu（码度）。

二、MaDu 是什么？

MaDu = 命令行 + Web 平台 + AI 辅助

一句话：你在终端正常 git commit，MaDu 自动帮你把进度同步到 Web 看板；在 Web 看板上管理团队任务，AI 还能帮你拆需求、写日报。

三大核心理念：

提交即上报 ------ 不改变现有工作流，git commit 时自动弹出让选任务、选进度，commit 完进度就同步到平台。
零打扰 ------ 断网也能提交，数据先存本地，联网后自动补传。
AI 提效 ------ 上传 PRD 文档自动拆任务、根据 git diff 自动生成提交说明、一键整理日报周报。

三、核心功能演示

3.1 CLI：提交代码时顺便上报进度

bash 复制代码

# 初始化项目（一次）
madu init --base-url http://127.0.0.1:3210

# 之后每次提交
git add .
git commit

终端会自动弹出：

1.选择提交类型

2.选择关联的任务

3.选择任务的进度

4.完成提交

提交信息自动生成规范格式：

csharp 复制代码

[TASK-1001] 优化登录页表单校验逻辑（进度: 70%）

几个体验优化：

rawlist 编号选择：不用上下键翻半天，直接输数字回车。
最近使用置顶：常做的任务永远排在最前面。
关键字过滤：任务超过 15 个时，先输关键字缩小范围。
AI 生成提交说明 ：根据 git diff 自动建议一句提交说明，直接回车就用。

3.2 快捷命令直达

bash 复制代码

# 老手跳过交互，一条命令完成提交 + 上报
madu done --task TASK-1001 --progress 70 --type 任务迭代 -m "优化登录页表单校验逻辑"

# 修复 BUG 同理
madu done --bug BUG-1001 --progress 60 -m "修复登录跳转404"

3.3 Web 平台：项目看板 + 成员日志

打开 http://127.0.0.1:3210/，能看到：

项目列表：每个项目展开后显示任务、BUG、成员、进度。
电池进度条 ：<30% 红色、30-79% 蓝色、≥80% 绿色，一目了然。
成员详情：点击成员头像，查看他的提交日志、日报、周报、月报。
Token 管理：按项目开启/关闭 Token 鉴权，保障数据安全。

3.4 AI 智能拆分工单

粘贴一段需求文档，AI 自动拆分为结构化任务列表：

还支持上传 .docx 文件，自动提取文档内容填入需求框：

【配图 7：.docx 文件上传截图】

📸 截图建议 ：展示拖拽上传 .docx 文件到需求框的过程，上传后显示文件名和字数（如"中集智慧水务平台软件需求规格说明书.docx · 13804 字"），下方文本框已自动填入提取的纯文本内容。

勾选后一键批量创建到项目中。

3.5 AI 整理日报/周报

点击成员详情页的「日报」标签，AI 自动根据提交记录生成：

markdown 复制代码

## 日报 · 张三（2026-08-31）

**已完成**
- TASK-1001 用户登录模块：进度从 50% 提升至 70%，完成手机号格式实时校验
- BUG-1002 登录跳转404：已修复，验证通过

**进行中**
- TASK-1003 数据统计报表：进度 0%，预计本周启动

**今日总结**：共 2 次提交，修复 1 个 BUG，推进 1 个任务

四、项目状态与规划

已实现：

✅ CLI 交互提交与进度上报
✅ Web 平台项目/任务/BUG 管理
✅ 认证与权限体系（Session + Token）
✅ AI 智能拆分工单（支持 .docx 上传）
✅ AI 自动生成提交说明
✅ AI 整理日报/周报/月报
✅ 离线队列与自动补传
✅ 最近使用任务置顶
✅ 负责人分配与头像展示
✅ CLI 只拉取分配给自己的任务

规划中：

🚧 任务截止时间 + 逾期提醒
🚧 工时估算 vs 实际（燃尽图）
🚧 任务依赖关系（前置任务阻塞）
🚧 CI/CD 联动（构建结果回写）

五、写在最后

MaDu 的定位不是替代 Jira/禅道，而是在「太重」和「没有」之间找一个平衡点。

对于 5-20 人的研发团队，它足够轻、足够快、足够用。不改变你的工作流，只是让你的每一次 git commit 都更有价值。