面向飞书技术协作的可复用 Skill 集合。当前覆盖技术教程写作与审校、架构图与流程图等可编辑画板交付，以及基于多 Agent 会话证据的飞书技术周报。
这套仓库构建在 lark-cli 之上，不重复文档、Wiki、消息、日历、任务、会议、Base、Sheets、邮件和画板等原子 Skill。这里沉淀的是跨领域工作流、交付质量规范和可复用模板。
- 命令选择遵循 Shortcut → 已注册 API → 原生 OpenAPI。
- 认证、权限和高风险写入统一遵循
lark-shared。 - 文档编辑携带已读取的 revision；冲突后重新读取，不静默覆盖。
- 跨资源工作流通过 token 和 ID 传递状态，并明确失败回滚与写后回读。
- 每个 Skill 只负责一个可复用协作目标，底层操作路由到对应的
lark-*原子 Skill。
把 AgentRecall、Codex、Claude Code、Pi 和 Trae 中分散的工作记录汇总成可验证的技术周报，并创建或幂等更新飞书文档。
- AgentRecall session-search MCP 优先；不可用时只读明确的本地会话目录。
- 跨 Agent 合并同一事项，按“结果—影响—验证”表达，不堆聊天流水。
- 区分已验证、进行中和仅线索，避免把计划或 Agent 自述写成已完成。
- 同一自然周只维护一个章节，携带 revision 更新并在写后局部回读。
- 输出前脱敏，默认不把本地路径、密钥、提示词和长聊天原文写入飞书。
用于撰写、重构和审校中文技术教程，重点解决概念顺序混乱、代码缺少上下文、图文脱节、实现范围混写、事实随版本变化和表达机械等问题。
- 区分 Review、直接改写、逐条讨论和从零写作四种模式。
- 建立读者问题、事实、状态与术语清单。
- 按“问题 → 触发 → 整体流程 → 数据 → 实现 → 状态 → 失败路径”组织教程。
- 对代码身份、触发者、状态生命周期、证据范围、单位和图文一致性做双轮审校。
- 在飞书中遵循 revision、block 范围、资源保护和写后回读规则。
用 66 类结构化模板生成可编辑飞书画板：
- Agent：ReAct、规划执行、RAG、记忆、多 Agent 协作、评测与调试。
- 研发：需求到设计、TDD、Git/PR、CI/CD、完整开发生命周期。
- 架构：分层、微服务、插件、C4 Context/Container/Component、部署拓扑。
- 运行与治理：容量、故障传播、SLO、一致性、信任边界、多租户隔离。
- 学习与决策：路线图、知识脑图、原理拆解、ADR、质量属性和架构权衡。
每类模板都包含使用场景、核心结论、布局、必备语义、常见坏味道、可改写画图要求和自包含 SVG。SVG 仅使用基础形状、文字与连线，可导入飞书画板继续编辑。
将需要的 Skill 复制到 Codex Skill 目录：
cp -R skills/feishu-tech-diagram ~/.codex/skills/
cp -R skills/rewrite-technical-tutorial ~/.codex/skills/
cp -R skills/lark-workflow-weekly-report ~/.codex/skills/也可以在团队仓库中保留该目录，并按运行环境的 Skill 加载方式注册。
改写或审校教程时，提供文档、目标读者和任务模式：
用 rewrite-technical-tutorial 直接改写这篇飞书教程，保留已有图片和画板，重点检查代码上下文与状态生命周期。
需要画图时，描述读者和要表达的关系：
为这份技术方案补一组可编辑图：先画 C4 Context 和 Container，再画核心时序与故障传播图。
画图 Skill 会先生成图意图卡，再按要回答的问题选择模板。模板示例位于 assets/samples/，完整索引见 references/template-catalog.md。
需要生成周报时，提供目标飞书文档；没有目标文档时会新建：
汇总本周 Codex、Claude Code、Pi 和 Trae 的工作记录，生成技术周报并更新到这份飞书文档。
如需重新生成整份飞书模板文档：
python3 skills/feishu-tech-diagram/scripts/render_lark_skill_doc.py > diagram-skill.xml输出为飞书文档 XML，66 个画板分别紧跟对应模板说明，不会集中堆在文档末尾。
python3 skills/feishu-tech-diagram/tests/validate_assets.py
python3 -m unittest tests/test_collect_local_sessions.py
python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/rewrite-technical-tutorial校验会检查 66 组元数据和 SVG 是否一一对应、SVG 能否解析、是否包含外部资源或不安全节点，以及渲染后的文档是否包含 66 个可编辑画板且不含位图。
skills/
├── feishu-tech-diagram/
│ ├── SKILL.md
│ ├── assets/samples/ # 66 个自包含 SVG
│ ├── references/ # 目录、规格、画图要求与示例索引
│ ├── scripts/ # 飞书文档渲染器
│ └── tests/ # 资产契约校验
├── rewrite-technical-tutorial/
│ ├── SKILL.md
│ └── agents/openai.yaml
└── lark-workflow-weekly-report/
├── SKILL.md
├── agents/openai.yaml
├── references/ # MCP、本地来源与飞书周报模板
└── scripts/ # 多 Agent 本地会话只读采集器