Lark CLI Dev Hub

Lark CLI Dev Hub 是一个基于飞书多维表格（Base）、文档/维基（Docs/Wiki）、任务（Tasks）和白板（Whiteboard）构建的开发知识系统。用于避免重复排查问题、保持任务状态清晰可见，并留存发布证据。

发现别名：feishu-cli、飞书 CLI、lark-cli、Lark CLI、Feishu Dev Hub、Lark Dev Hub、Codex Feishu、Claude Code Feishu

核心边界

• Agent 会话记忆存储协作偏好和工作风格。
• Lark CLI Dev Hub 存储项目事实、任务、缺陷证据、常见陷阱、操作手册、决策记录、发布信息、产物文件以及 AI 运行摘要。
• 不要写入密钥、访问令牌、应用密钥、私钥、原始凭证或完整的环境配置文件。
• 将多维表格（Base）视为结构化数据的唯一真实来源。文档（Docs）用于存放长篇上下文内容。白板作为可视化辅助工具，其文本摘要需关联回 Base。

本地入口点

export DEVHUB_HOME="${DEVHUB_HOME:-$HOME/.codex/devhub}"

python3 "$DEVHUB_HOME/bin/devhub.py" search --project "$(basename "$PWD")" --query "symptom area keywords"
python3 "$DEVHUB_HOME/bin/devhub.py" record-bugfix --payload /tmp/devhub-bugfix.json
python3 "$DEVHUB_HOME/bin/devhub.py" record-ai-run --payload /tmp/devhub-ai-run.json
python3 "$DEVHUB_HOME/bin/devhub.py" record-release --payload /tmp/devhub-release.json
python3 "$DEVHUB_HOME/bin/devhub.py" sync-outbox --cwd "$PWD"

配置文件默认路径：

$HOME/.codex/devhub/config.json

项目本地的收据与待发送队列目录：

.devhub/receipts/
.devhub/outbox/

处理缺陷时的操作流程

调查前：

1. 提取项目名称、模块/区域、症状特征、错误关键词及相关文件路径。
2. 使用 devhub.py search 命令执行简洁查询。
3. 阅读输出中相关的“常见陷阱”、“已修复缺陷”、“操作手册”、“决策记录”和“领域说明”。
4. 让历史记录影响当前修复方案，但仅在对工作产生实质性改变时，才在最终总结中提及。

完成有意义的修复后：

1. 创建一条“缺陷修复”记录。
2. 创建一条“AI 运行”记录。
3. 当经验可复用时，创建或更新“常见陷阱”或“操作手册”条目。
4. 仅当长篇叙述具有长期阅读价值时，才将其保留在文档中。

参见 [references/writeback-flows.md](references/writeback-flows.md)。

主分支推送前准备

在向 main 或 master 推送前，需创建一条“发布”记录，或留下一个待发送项。钩子链接受以下任意一种形式：

• # kb-updated
• .devhub/receipts/ 目录下的收据文件
• .devhub/outbox/ 目录下的待发送项
• # kb-skip: reason（适用于有合理理由跳过的场景）

默认模式为“影子模式”：先发出警告，待流程被信任后再切换为强制模式。

参见 [references/hook-policy.md](references/hook-policy.md)。

领域路由

当需要深入使用飞书 CLI 的特定行为时，请使用对应的细分领域技能：

• lark-cli-devhub-base：用于多维表格的模式定义、记录管理、视图配置、仪表盘展示及结构化 AI 搜索。
• lark-cli-devhub-docs-wiki：用于文档、维基空间、长篇页面及节点组织。
• lark-cli-devhub-taskflow：用于任务列表、缺陷/功能任务、负责人分配及状态管理。
• lark-cli-devhub-whiteboard：用于架构图、流程图、依赖关系图及可视化摘要。
• lark-cli-devhub-drive：用于网盘文件、导入导出、文件夹同步、评论、权限管理及产物注册。
• lark-cli-devhub-sheets：用于电子表格报告、质量保证矩阵、发布检查清单及人工可编辑追踪表。
• lark-cli-devhub-calendar：用于日程安排、空闲时间、会议室预订、评审时段及发布窗口管理。
• lark-cli-devhub-communications：用于即时消息与邮件搜索、摘要生成、草稿、回复、公告及产物共享。
• lark-cli-devhub-meetings：用于视频会议、会议纪要、录音、待办事项及决策提取。
• lark-cli-devhub-approvals-okr：用于正式审批、OKR 进度跟踪、发布治理及目标对齐。
• lark-cli-devhub-slides：用于项目简报、发布评审演示文稿、复盘汇报及利益相关方更新。
• lark-cli-devhub-events：用于事件消费者、监听器、自动化触发器及写回循环。

参见 [references/domain-map.md](references/domain-map.md) 和 [references/knowledge-model.md](references/knowledge-model.md)。