ARTI · 研发规范

研发日报模板

让 Steve 用 3 分钟判断:卡点在哪、明天方向对不对

日报模板
📋 ARTI 研发日报 · YYYY-MM-DD
今天完成了什么 必填
- 完成了行情数据接口对接(Tushare → A股日线),可在 /quick 命令中调用 - 修复了 Natasha 模块的 prompt 截断 bug,超长新闻不再报错 - 部署到开发环境,验证通过 ✅
规则:只写有输出的事。"研究了 X"不算完成——要写"研究了 X,结论是 Y,决定用 Z"。能 demo 的附截图或链接。
明天计划做什么 必填
- 接入 AKShare fallback,完成三级降级逻辑(Tushare → AKShare → 新浪) - 写单元测试覆盖行情数据层(目标:主要接口 80% 覆盖) - 联调 /rotation 命令的板块轮动数据源
规则:要具体到文件/功能/接口级别。不能写"继续开发行情模块"——要写"完成行情模块的 X 功能"。
卡点 / 需要决策 必填
【有卡点】 AKShare 的港股数据延迟约 15 分钟,yfinance 实时但不稳定。 需要 Steve 决策:优先数据稳定性还是实时性?影响 /quick 命令的体验。 【没有卡点】 今天顺利,无阻塞。
规则:卡了半天没进展 = 必须写卡点。不写卡点 = 默认一切顺利,Steve 不会主动来问。
今日工时 选填
实际开发:6h | 调研 & 联调:1.5h | 其他:0.5h
用途:帮 Steve 判断任务量是否合理,不是考勤。
核心规则
🚫
不写"研究了 X"
研究不是产出。要写研究的结论和决策,没有结论就说"还没搞清楚,明天继续"。
🔗
完成 = 可验证
说"完成了 X 功能"必须附测试截图、链接或可跑的命令。没有佐证的完成不算完成。
🚨
卡了必须写
卡了超过 2 小时没进展,当天日报必须写卡点。不写 = 默认顺利,Steve 不会猜。
📌
明天计划要具体
写"完成行情模块"不行,要写"完成行情模块的 AKShare fallback 逻辑并写测试"。能具体到文件名最好。
不要为了填而填
今天没有卡点就写"无",不要编一个假卡点。日报是沟通工具,不是考核材料。
好/差 示例对比
❌ 差的写法
今天研究了 Tushare 的 API, 了解了接口结构。 明天继续开发行情模块。 没有卡点。
✅ 好的写法
完成了 Tushare 日线接口封装, 支持 A股/ETF,已写单测。 截图:[链接] 明天完成 AKShare fallback, 预计下午联调 /quick 命令。 卡点:港股数据延迟问题, 需要 Steve 决策优先级。
提交规范
⏰ 每天 20:00 前提交
📨 发到 ARTI 项目群
📝 格式:复制模板填写
💡
临时进展随时更新
遇到重要决策点或严重卡点,不用等到 20:00,直接在群里 @ Steve 说清楚。日报是每日总结,不是唯一沟通渠道。