Plan Kit

伟星SAB股份大洋数字化发展部周计划/月总结工具。

通过 npx 一键安装两个飞书多维表格 Skill（周计划 / 月总结）到本地 Coding Agent，并引导完成飞书 CLI 的安装与授权。

上手指南

1. 安装

直接运行：

npx @wx-sab/plan-kit setup

如果无法直连 npmjs，可从 npmmirror 镜像站拉取：

npx @wx-sab/plan-kit setup --registry=https://registry.npmmirror.com

安装向导会依次引导你完成以下步骤。

2. 飞书 CLI 安装与配置

2.1 安装飞书 CLI

向导会自动检测 lark-cli 是否已安装。未安装时会提示运行：

npx @larksuite/cli@latest install

2.2 应用配置与登录认证

飞书 CLI 的 config init 和 auth login 是交互式 TUI，请在独立终端中手动执行（嵌套在本工具内会导致键盘输入卡住）：

# 1. 初始化应用配置（需要 App ID 和 App Secret）
lark-cli config init --new

# 2. 登录认证
lark-cli auth login

App ID / App Secret 在飞书开放平台创建应用后获取，参考 https://open.feishu.cn/document/home/introduction

2.3 权限要求

登录时务必勾选以下四个业务域的全部权限，否则脚本无法正常工作：

| 业务域 | 必需权限（示例） | |--------|------------------| | base | base:table:read base:record:read base:record:create base:record:update base:field:read base:view:read 等 | | contact | contact:user.base:readonly | | docs | docx:document:create docx:document:write_only docx:document:readonly | | markdown | drive:drive.metadata:readonly drive:file:upload |

向导会在认证后自动检测权限范围，缺少时会列出缺失项并提示重新授权。

完成认证后回到本工具终端，按任意键继续。

3. 安装 Skill

向导会让你选择：

1. 目标 Coding Agent（可多选）：

   • Claude Code → ~/.claude/skills/
   • Cursor → ~/.cursor/skills/
   • Trae CN → ~/.trae-cn/skills/
   • Codex → ~/.codex/skills/
   • 自定义路径

2. 要安装的 Skill：

   • 周计划（sab-weekly-plan）— 默认必装
   • 月总结（sab-monthly-summary）— 可选

每个 Skill 目录包含 SKILL.md 和 scripts/（Python 脚本），完全自包含。

4. 开始使用

打开你的 Coding Agent，直接用自然语言触发即可：

• 写本周计划 / 反馈完成情况：

  帮我写本周计划。本周完成了 A、B，C 没做完放下周，下周还要做 D（8h）。

• 生成月总结：

  生成 7 月工作总结。

功能说明

周计划 Skill（sab-weekly-plan）

• 反馈本周完成情况：更新 完成情况 和 备注 字段；空完成情况的记录会逐条追问，不自行推断
• 创建下周计划：自动迁移本周未完成项 + 用户新增事项
• 月周归属规则：以周一为周起始，一周中某月天数 ≥ 4 则归属该月

月总结 Skill（sab-monthly-summary）

• 读取上月自己的所有周计划记录
• 从备注字段提取临时工作
• 按模板生成飞书云文档：工作计划完成情况（表格）、重点工作回顾、存在问题及分析、下月工作重点

技术细节

• 数据操作全部通过固化的 Python 脚本执行（lark-cli 间接调用），减少 AI 幻觉导致的数据错乱
• 多维表格 token、表 ID 等配置硬编码在脚本中，开箱即用
• 支持的 Coding Agent 路径以官方文档为准（Trae CN 参考 https://docs.trae.cn/ide_skills）

许可

UNLICENSED