初始化设置

若 ~/kanban/ 不存在或为空，则静默读取 setup.md，仅在用户确认后执行初始化。

适用场景

当用户需要一个跨项目、跨会话由智能体持续维护的看板系统（Kanban system）时，使用本技能。智能体应为各项目构建专属看板，记住每个看板的存储位置，并以一致规则处理任务卡片。

架构设计

记忆数据存于 ~/kanban/ 目录下。基础文件模板参见 memory-template.md，看板结构模板参见 board-template.md，项目路由机制参见 discovery-protocol.md。

~/kanban/
├── memory.md                  # 全局状态、集成配置与默认值
├── index.md                   # 项目注册表及看板位置映射
├── templates/
│   └── board-template.md      # 标准看板格式副本
└── projects/
    └── {project-id}/
        ├── board.md           # 当前项目的活跃看板
        ├── rules.md           # 项目专属泳道定义与策略
        ├── log.md             # 看板写入日志
        └── archive/

可选的项目本地模式：

{workspace}/.kanban/
├── board.md
├── rules.md
└── log.md

快速参考

针对当前任务，优先使用最小且相关性最强的文件。

核心规则

1. 读写前必须明确项目上下文

• 每次会话开始时，须执行 discovery-protocol.md 中定义的发现流程。
• 若项目范围不明确，应在写入前仅询问一次。

2. 持久化路由信息，确保任意智能体均可无缝续接

• 持续更新 Kanban 索引文件（index.md），确保其中包含工作区路径、项目别名及主看板路径。
• 每次成功写入后，需同步更新对应项目条目的 last_used 字段。

3. 支持自定义看板形态，但需维持稳定的核心 Schema

• 用户可在项目规则文件（rules.md）中按需重命名泳道或添加自定义列。
• 每张卡片必须保留可解析的核心字段：id、title、state、priority、owner、updated。

4. 卡片处理须确定性执行

• 严格遵循 processing-rules.md 中规定的决策顺序进行优先级判定与状态迁移。
• 不得跳过阻塞项（blockers）、依赖关系（dependencies）或显式设定的在制品限制（WIP limits）。

5. 写入操作须原子化并记录日志

• 更新看板文件与向项目日志（log.md）追加一行记录，必须在同一操作周期内完成。
• 若写入中途失败，应报告部分完成状态，不得声称操作成功。

6. 保障各项目看板相互隔离

• 未经用户明确指示，禁止跨不同项目看板移动或编辑卡片。
• 对于跨项目请求，须先生成执行计划，再依计划逐一看板应用变更。

7. 维持跨会话的上下文连续性

• 新会话首条消息到达时，须先解析看板位置并加载当前状态，再提出工作建议。
• 若尚无对应看板，应基于 board-template.md 初始化，将其注册至索引文件后继续执行。

常见陷阱

• 所有项目共用一个全局看板 → 优先级与负责人归属变得模糊不清。
• 重命名泳道但未同步更新项目规则文件中的状态映射 → 卡片将无法被正确处理。
• 更新看板后未刷新索引文件 → 后续智能体会话无法定位该看板。
• 任务卡片缺失 id 字段 → 导致重复更新与引用失效。
• 标记任务完成却未写入日志 → 后续会话缺乏审计依据。

安全与隐私

始终保留在本地的数据：

• ~/kanban/ 或 {workspace}/.kanban/ 目录下的看板文件与项目注册表。

默认情况下不会离开您设备的数据：

• 无任何数据默认外传。

本技能明确不执行以下操作：

• 发起未声明的网络请求。
• 修改 Kanban 作用域之外的任意文件。
• 在日志缺失时虚构看板历史记录。

相关技能

如用户确认，可通过 clawhub install 安装以下技能：

• workflow —— 运营工作流设计与执行循环
• projects —— 项目组织与跨项目治理
• delegate —— 负责人指派与任务交接协议
• daily-planner —— 日度规划与任务序列编排

反馈

• 若本技能有用：运行 clawhub star kanban
• 保持更新：运行 clawhub sync