24-listed

# 项目看板 (Project Boards) v1.0 > **起源 **: 要一套能像专业 PM 一样调度的本地看板 — 看全盘、钻单项目、知道下一步推哪个。 ## ★ 设计铁律 (最高优先, 决定一切) **好看板必须锚在「垂直结构分解」(目标 ↓ 板块 ↓ 项) → 有分母、有边界、能完成。** - **禁止扁平「状态看板」** (Kanban 把 待办/进行中/阻塞/完成 当组织轴): 它没分母、待办列可无限加 → 制造 CLAUDE.md 最怕的「做不完的增项 / 无限优化循环 / 跑偏」, 是**反 Scope-Lock (TEP)** 的。 - **状态当「有界结构项的属性」** (格子颜色 / 角标), **不当组织轴**。一个格子可以同时是「部分」+「下一步」, 用可叠加标记表达, 不用互斥状态。 - 试过扁平 Kanban, 已退役 (2026-06-09)。**不要再提议扁平状态看板。** ## 一个系统, 两层视图 (单一入口) **`~/Developer/BOARD.html` = 唯一入口** (不再一堆散页面/标签)。一个自包含 HTML, 内部路由: | 视图 | 路由 | 锚在哪个垂直结构 (= 分母) | |---|---|---| | **全盘首页** | `#/` | 项目 ↓ 项目 (扫 ~/Developer 全部 git 仓) — 点项目卡钻进去 | | **项目详情** | `#/p/<项目>` | 项目 ↓ 板块 ↓ 模块 — **6 个 tab** 分区 | **项目详情页 = 6 tab** (不再一长条): **总揽**(cockpit 板块网格+进度环) · **规划**(现在做/下一步, 自动抽 focus/next+current-task) · **对话**(conversation-log) · **提交**(每天提交按天分组) · **部署**(docs/releases) · **仓库**(分支/P-1/未推/未提交改动/链接)。客户端切 tab, 不开新页。 **统一口径**: 全盘每个项目进度由系统**从 cockpit 格子统一算 done/total** (跨项目可比), 同时保留并标注**项目自报目标** (如 ProjectA 自报)。解决"各项目理解有偏差导致维度不一样"。 **板块格子**: status 颜色 + 当前说明(meta) + **更新日期**(该板块最近 git 提交) + 点开弹窗看**实施历史**(git log -- paths) + 对应文件。靠 cockpit 格子 `paths` 字段自动算, 零维护。 **不开新标签**: BOARD.html 路径固定, AI 重生后**刷新已开的那个标签 (Cmd+R)** 即可, 不要每次 `open` 开新标签。 ## 目录结构 ``` 24-项目看板/ ├── SKILL.md # 本文件 ├── system/ # ★ 看板系统 (单一入口, 日常用这个) │ ├── board-system.mjs # 生成器: 扫所有项目 + bundle cockpit + 统一算 → BOARD.html │ ├── board-system.template.html # 单页 app (路由: 全盘 ⇄ 项目) │ └