lxy
8df4e33656
- 看板: 907 补注/909~941 登记与销账(含 929 模型停用根因与 4 处次生缺口、931 队列丢失、933/935/937 新需求、939 上下文瓶颈清单、941 C-r0 行为变更待拍板) - 归档: 全量完成态条目/段落 + 只读核验销账 4 段迁 todo归档/2026-10-10.md(机械搬运零措辞改动,未完成项零丢失) - 设计档: 输入框列表预览与自动编号 / 定时消息与待发箱持久化(统一 ai_outbox 底座) / 对话内定时延时任务 / 消息渲染管线重构(P0-P2 分期) / 上下文分层组装器落地方案(记账基点单一真值,与并行写者职责划清) / FileTree 大目录方案(推荐后端分页,否决虚拟滚动) / u-relay 运维手册 - 索引与事实修正: docs/INDEX crate 数 8→13 + 四子树补录 25 条 + 专项设计补录 27 条;纠正「项目无独立 ARCHITECTURE.md」等过时声明;统一 bun 口径 - CLAUDE.md: 新增「命名与代码风格」节(变量/方法名精简+准确;DRY·简洁·扩展性·高内聚低耦合·单一真值来源)
2.5 KiB
2.5 KiB
DevFlow 工作规范
任务看板自动领单（最高优先级纪律）
- 会话启动即读板：任何会话开工前，先读
docs/todo.md——按优先级领任务：🔴 高危项 > B 批次/编号项 > C 类候选。 - 批收敛即回读：每完成一个任务批（提交后），重读看板领下一项——挂机/连续工作模式下每批必回读，禁凭记忆连续开工。
- 领单动作：领单后将条目改为
[→]（进行中），完成后改[x]并附验收命令输出（G4）；无法完成的改[!]附卡点，禁静默跳过。 - 🔴 门禁（G2）：看板存在未清零 🔴 条目时，只允许领 🔴 销账任务，新功能任务禁领（除非用户明示）。
- 提交纪律（G3/G4）：提交描述与 diff 机械对应；一笔一事或逐件列全；分组提交按看板标注的主题分组。
- 汇报实测：任何进度/完成汇报，先跑
git log -1 --format="%h %s"与git status --short | wc -l实测再报，禁凭记忆报状态。 - 看板顶部「挂机必读」警示：启动时若存在，视为最高优先级上下文覆盖。
自主修复纪律
- 明确 bug（实证在案/用户指出/唯一正确解或用户已给修法方向）：直接修并报告，禁反问「要不要修」（2026-10-06 用户纠正：发现换装脚本缺陷后反问=自主性差）。
- 边界对齐意志卡 forbidden：发版/部署/重启线上、git push、生产数据操作、对外发消息，攒齐等拍板。
- 本机工具/脚本的行为变更属 report_after 级（干完通报、可回滚），不属确认级。
命名与代码风格（2026-10-10 用户重申）
- 变量/方法名：精简 + 准确——一眼看出「是什么/做什么」且不超必要长度。忌把实现细节写进名字（
..._after_tool_run）、忌无信息缩写（tmp2/h）、忌同概念多叫法。名字过长通常说明该拆函数或把说明下沉到注释（注释承载「为什么」，名字只承载「是什么」）。 - DRY · 简洁 · 扩展性 · 高内聚低耦合（同期重申）：新增能力先找共用底座（如定时消息与定时任务共用一张
ai_outbox+ 一个调度器），不造双轨；同一事实只留单一真值来源（如 token 估值口径）。
其他规范
- 架构设计文档在
docs/02-架构设计/；当前活跃专项：无人值守可靠性（B1-B4）+ 异步任务会话（13-17），设计见temp/与 docs。