BLSFlow docs

Appearance

AI 会话启动规范（渐进式、按需读取） ​

1. 固定职责（强制） ​

任何新会话进入 blsflow 后只有两个职责：

  1. 先协助用户完成/修订 tasks/ 任务文档
  2. 只有在用户明确确认“按 task 写代码”后，才允许执行代码修改

默认规则：

  • 默认先写 task，不直接写代码
  • 未获确认前，只允许：文档分析、task 起草/修订、风险提示、验收与边界检查
  • 如发现文档冲突，必须显式指出，并按 docs/standards/文档优先级.md 处理

2. 启动必读（默认只读这 4 份） ​

目标：用最少上下文快速定位当前进度与下一步。

  1. AGENTS.md
  2. docs/架构设计.md
  3. docs/进度看板.md
  4. tasks/INDEX.md

读完后必须先输出（不得写代码）：

  • 进度判断依据：引用以上 4 份文档
  • Doing / Next：各最多 3 条，只写 task 编号与一句话
  • 风险/阻塞：最多 5 条
  • 下一步还需再读的 1～3 个文件：列路径 + 理由（只为推进 Next#1）

3. 按需扩读规则（强制） ​

只有在需要推进某个具体 task 时才允许扩读，并且遵守：

  • 只读被点名的：优先读取该 task 文档与其“依赖文档”段落中明确列出的文件
  • 一次最多扩读 1～3 份：每次扩读前先说明“缺什么信息/为什么需要读”
  • 禁止自由扩读：不得为了“更懂项目”而横向扫文档

建议的扩读顺序（当且仅当需要）：

  1. 当前 task：tasks/(doing|todo|done)/Txxxx-*.md
  2. 相关模块文档：docs/modules/*.md
  3. 变更记录：changelogs/ 最近条目
  4. 质量门禁与反例（仅在任务需要时）：docs/standards/验收门禁.md、docs/standards/反例清单.md

4. 进入写代码的门禁（强制） ​

只有在用户明确确认“按 task 写代码”后，才允许进入实现，并且：

  • 只允许修改 task「作用范围」列出的目录/文件
  • 写代码前先输出：将改动的文件清单 + 对应验收点
  • 每完成关键验收点后，同步补齐 task 的实施记录与必要回写

5. 最短启动提示词（复制用） ​

text
你在 blsflow 项目中工作。强制采用“渐进式按需读取”，禁止上来全量阅读。

你只有两个职责：
1) 先协助我完成/修订 tasks 任务文档
2) 只有在我明确确认“按 task 写代码”后才能改代码

第一步只允许读取 4 份：
- AGENTS.md
- docs/架构设计.md
- docs/进度看板.md
- tasks/INDEX.md

读完后先输出（不得写代码）：
- 当前进度判断依据（引用上述 4 份）
- Doing/Next（各最多 3 条，只写 task 编号）
- 风险/阻塞（最多 5 条）
- 为推进 Next#1 还需再读的 1~3 个文件（路径+理由）