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

阳火锅
1,859 阅读4分钟

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

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

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

常见场景：

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

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

于是有了 MaDu（码度）。

二、MaDu 是什么？

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

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

三大核心理念：

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

image.png

三、核心功能演示

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

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

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

终端会自动弹出：

1.选择提交类型

image.png

2.选择关联的任务

image.png

3.选择任务的进度

image.png

4.完成提交

image.png

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

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

几个体验优化：

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

3.2 快捷命令直达

# 老手跳过交互，一条命令完成提交 + 上报
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/，能看到：

image.png

image.png

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

image.png

3.4 AI 智能拆分工单

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

image.png

还支持上传 .docx 文件，自动提取文档内容填入需求框：勾选后一键批量创建到项目中。

3.5 AI 整理日报/周报

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

image.png

## 日报 · 张三（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 都更有价值。开源地址：gitee.com/wx_b16fa220… 对你们有帮助的麻烦点个星星

avatar
文章
阅读
粉丝