@yionr/plan-kit 1.0.0

package/scripts/get_user_info.py

@@ -0,0 +1,85 @@
+#!/usr/bin/env python3
+"""查部门人员表，返回当前用户的姓名、open_id、所属组。
+
+流程:
+1. lark-cli contact +get-user --as user → 获取当前用户 open_id
+2. lark-cli base +record-search → 在部门人员表按人员字段筛选
+3. 返回 {open_id, name, group}
+
+用法: python3 get_user_info.py
+输出: {"open_id": "ou_xxx", "name": "张三", "group": "移动"}
+"""
+
+import json
+import subprocess
+import sys
+import os
+
+# 允许脚本从上级目录 import config
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+import config
+
+
+def run_lark(args):
+    """执行 lark-cli 命令并返回 JSON 结果。失败时退出。"""
+    result = subprocess.run(
+        ["lark-cli"] + args,
+        capture_output=True,
+        text=True,
+        timeout=30,
+    )
+    try:
+        data = json.loads(result.stdout)
+    except json.JSONDecodeError:
+        print(json.dumps({"error": "parse_failed", "stdout": result.stdout[:500], "stderr": result.stderr[:500]}, ensure_ascii=False))
+        sys.exit(1)
+
+    if not data.get("ok"):
+        print(json.dumps({"error": "lark_cli_failed", "detail": data.get("error", {})}, ensure_ascii=False))
+        sys.exit(1)
+
+    return data
+
+
+def main():
+    # 1. 获取当前用户
+    user_data = run_lark(["contact", "+get-user", "--as", "user"])
+    user = user_data["data"]["user"]
+    open_id = user["open_id"]
+    name = user["name"]
+
+    # 2. 在部门人员表中查找
+    record_data = run_lark([
+        "base", "+record-list",
+        "--base-token", config.BASE_TOKEN,
+        "--table-id", config.TABLE_IDS["部门人员"],
+        "--filter-json", json.dumps(
+            {"logic": "and", "conditions": [
+                ["人员", "intersects", [{"id": open_id}]],
+            ]},
+            ensure_ascii=False
+        ),
+        "--as", "user",
+        "--format", "json",
+    ])
+
+    records = record_data["data"]["data"]
+    if not records:
+        print(json.dumps({"error": "user_not_found", "open_id": open_id, "name": name}, ensure_ascii=False))
+        sys.exit(1)
+
+    # fields 顺序: [人名, 人员, 所属组, 推送日期]
+    record = records[0]
+    group_arr = record[2]  # 所属组
+    group = group_arr[0] if group_arr else ""
+
+    result = {
+        "open_id": open_id,
+        "name": name,
+        "group": group,
+    }
+    print(json.dumps(result, ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    main()

package/scripts/query_weekly_records.py

@@ -0,0 +1,90 @@
+#!/usr/bin/env python3
+"""按用户和月周查询周计划记录。
+
+用法: python3 query_weekly_records.py --open-id ou_xxx --week "7月第4周"
+输出: JSON 数组
+"""
+
+import json
+import subprocess
+import sys
+import argparse
+import os
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+import config
+
+
+def run_lark(args):
+    result = subprocess.run(
+        ["lark-cli"] + args,
+        capture_output=True,
+        text=True,
+        timeout=30,
+    )
+    data = json.loads(result.stdout)
+    if not data.get("ok"):
+        print(json.dumps({"error": "lark_cli_failed", "detail": data.get("error", {})}, ensure_ascii=False))
+        sys.exit(1)
+    return data
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--open-id", required=True)
+    parser.add_argument("--week", required=True)
+    args = parser.parse_args()
+
+    open_id = args.open_id
+    week = args.week
+
+    data = run_lark([
+        "base", "+record-list",
+        "--base-token", config.BASE_TOKEN,
+        "--table-id", config.TABLE_IDS["周计划"],
+        "--filter-json", json.dumps(
+            {"logic": "and", "conditions": [
+                ["月周", "intersects", [week]],
+                ["责任人", "intersects", [{"id": open_id}]],
+            ]},
+            ensure_ascii=False
+        ),
+        "--as", "user",
+        "--format", "json",
+    ])
+
+    records = data["data"]["data"]
+    field_ids = data["data"]["field_id_list"]
+
+    idx_content = field_ids.index("fldjdmxh69")
+    idx_completion = field_ids.index("fldF9ebqDi")
+    idx_remark = field_ids.index("fldu5uAqGU")
+    idx_hours = field_ids.index("fldQXhORVG")
+    idx_week = field_ids.index("fldAivwku1")
+
+    result = []
+    for i, rec in enumerate(records):
+        def safe_val(arr, default=""):
+            if isinstance(arr, list):
+                return arr[0] if arr else default
+            if arr is None:
+                return default
+            return arr
+
+        record_id = (
+            rec.get("_record_id") if isinstance(rec, dict) else None
+        ) or (data["data"].get("record_id_list") or [None])[i] or "rec_{}".format(i)
+        result.append({
+            "record_id": record_id,
+            "content": safe_val(rec[idx_content]),
+            "completion_status": safe_val(rec[idx_completion]),
+            "remark": safe_val(rec[idx_remark]),
+            "hours": safe_val(rec[idx_hours], None),
+            "week": safe_val(rec[idx_week]),
+        })
+
+    print(json.dumps(result, ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    main()

package/scripts/update_completion.py

@@ -0,0 +1,69 @@
+#!/usr/bin/env python3
+"""批量更新周计划记录的完成情况和备注。
+
+用法: python3 update_completion.py --records '<json_array>'
+  json_array 格式: [{"record_id": "rec_xxx", "completion": "完成", "remark": "..."}]
+
+输出: {"ok": true, "updated": N}
+"""
+
+import json
+import subprocess
+import sys
+import argparse
+import os
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+import config
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--records", required=True)
+    args = parser.parse_args()
+
+    try:
+        records = json.loads(args.records)
+    except json.JSONDecodeError:
+        print(json.dumps({"ok": False, "error": "invalid_json"}, ensure_ascii=False))
+        sys.exit(1)
+
+    update_records = {}
+    for r in records:
+        rid = r["record_id"]
+        fields = {}
+        if "completion" in r and r["completion"]:
+            fields["完成情况"] = r["completion"]
+        if "remark" in r:
+            fields["备注"] = r["remark"] if r["remark"] else ""
+        update_records[rid] = fields
+
+    payload = json.dumps({"update_records": update_records}, ensure_ascii=False)
+
+    result = subprocess.run(
+        [
+            "lark-cli", "base", "+record-batch-update",
+            "--base-token", config.BASE_TOKEN,
+            "--table-id", config.TABLE_IDS["周计划"],
+            "--json", payload,
+            "--as", "user",
+        ],
+        capture_output=True,
+        text=True,
+        timeout=30,
+    )
+
+    try:
+        data = json.loads(result.stdout)
+    except json.JSONDecodeError:
+        data = json.loads(result.stderr) if result.stderr else {"ok": False}
+
+    if data.get("ok"):
+        print(json.dumps({"ok": True, "updated": len(update_records)}, ensure_ascii=False))
+    else:
+        print(json.dumps({"ok": False, "error": data.get("error", {})}, ensure_ascii=False))
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/skills/sab-monthly-summary/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: sab-monthly-summary
+description: >-
+  读取上月飞书多维表格"周计划"数据，按模板格式生成飞书云文档月总结。
+  当用户说"生成本月总结"、"写月总结"、"生成X月工作总结"时就使用此skill。
+---
+
+# SAB 月总结生成
+
+## 前置依赖
+
+- `lark-cli` 已安装并认证
+- Python 脚本位于本 skill 目录下的 `scripts/` 中
+- 依赖 `lark-doc` skill 用于创建飞书文档
+
+## 重要规则
+
+1. **只汇总用户自己的记录**
+2. **所有数据采集通过固化脚本**，AI 负责生成章节二、三、四的分析内容
+3. **章节一表格严格来自数据**，不要增删或篡改
+4. **脚本路径**：本 skill 的 SKILL.md 所在目录下的 `scripts/`
+
+## 流程
+
+### 步骤 1：定位用户
+
+```bash
+python3 scripts/get_user_info.py
+```
+
+### 步骤 2：确定目标月份
+
+如果用户没说具体月份，默认为上个月。
+
+### 步骤 3：汇总数据
+
+```bash
+python3 scripts/collect_monthly_data.py --open-id <open_id> --month <month>
+```
+
+输出 JSON，含 `records`（所有周计划记录）和 `temp_work`（从备注提取的临时工作）。
+
+### 步骤 4：生成 Markdown
+
+```bash
+python3 scripts/generate_monthly_md.py --data '<json_from_step3>'
+```
+
+输出包含完整章节骨架的 Markdown：
+- **章节一** 的表格已完整填充（数据驱动，包含临时工作）
+- **章节二、三、四** 标注了原材料数据和 AI 生成提示
+
+### 步骤 5：AI 补充分析内容
+
+基于 Markdown 中的原材料，生成分析文字：
+
+- **章节二 重点工作回顾**：从已完成项中挑选 1-3 项最有价值的，写背景、过程和成果
+- **章节三 存在问题及分析**：从备注/未完成原因中汇总共性问题
+- **章节四 下月工作重点**：列出未完成项 + 跟进措施
+
+### 步骤 6：创建飞书文档
+
+使用 `lark-doc` skill 创建飞书云文档：
+
+- **标题**: `信息技术科YYYY年M月工作总结--{姓名}`
+- **内容**: 补全后的 Markdown
+
+## 文档格式模板
+
+```
+# 信息技术科 YYYY年M月工作总结
+{姓名}
+
+## 一、工作计划完成情况（包括计划外完成）
+（表格）
+
+## 二、重点工作回顾
+（AI 生成）
+
+## 三、存在问题及分析
+（AI 生成）
+
+## 四、下月工作重点
+（AI 生成）
+```

package/skills/sab-monthly-summary/scripts/collect_monthly_data.py

@@ -0,0 +1,126 @@
+#!/usr/bin/env python3
+"""汇总指定月份所有周计划记录。
+
+用法: python3 collect_monthly_data.py --open-id ou_xxx --month 7
+输出: JSON
+"""
+
+import json
+import subprocess
+import sys
+import argparse
+import os
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+import config
+
+
+def run_lark(args):
+    result = subprocess.run(
+        ["lark-cli"] + args,
+        capture_output=True,
+        text=True,
+        timeout=30,
+    )
+    try:
+        data = json.loads(result.stdout)
+    except json.JSONDecodeError:
+        print(json.dumps({"error": "parse_failed", "stdout": result.stdout[:500], "stderr": result.stderr[:500]}, ensure_ascii=False))
+        sys.exit(1)
+
+    if not data.get("ok"):
+        print(json.dumps({"error": "lark_cli_failed", "detail": data.get("error", {})}, ensure_ascii=False))
+        sys.exit(1)
+    return data
+
+
+def safe_val(arr, default=""):
+    if isinstance(arr, list):
+        return arr[0] if arr else default
+    if arr is None:
+        return default
+    return arr
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--open-id", required=True)
+    parser.add_argument("--month", required=True, type=int)
+    args = parser.parse_args()
+
+    month = args.month
+
+    # 先查所有记录（按责任人筛选，内存中再按月份过滤）
+    data = run_lark([
+        "base", "+record-list",
+        "--base-token", config.BASE_TOKEN,
+        "--table-id", config.TABLE_IDS["周计划"],
+        "--filter-json", json.dumps(
+            {"logic": "and", "conditions": [
+                ["责任人", "intersects", [{"id": args.open_id}]],
+            ]},
+            ensure_ascii=False
+        ),
+        "--as", "user",
+        "--format", "json",
+    ])
+
+    records = data["data"]["data"]
+    field_ids = data["data"]["field_id_list"]
+
+    idx_content = field_ids.index("fldjdmxh69")
+    idx_completion = field_ids.index("fldF9ebqDi")
+    idx_remark = field_ids.index("fldu5uAqGU")
+    idx_hours = field_ids.index("fldQXhORVG")
+    idx_week = field_ids.index("fldAivwku1")
+
+    all_records = []
+    seen_ids = set()
+
+    for i, rec in enumerate(records):
+        record_id = rec.get("_record_id") if isinstance(rec, dict) else None
+        record_id = record_id or (data["data"].get("record_id_list") or [None])[i] or "rec_{}".format(i)
+        if record_id in seen_ids:
+            continue
+        seen_ids.add(record_id)
+
+        week_val = safe_val(rec[idx_week])
+        # 过滤：只保留目标月份的记录
+        if week_val.startswith("{}月".format(month)):
+            all_records.append({
+                "record_id": record_id,
+                "content": safe_val(rec[idx_content]),
+                "completion_status": safe_val(rec[idx_completion]),
+                "remark": safe_val(rec[idx_remark]),
+                "hours": safe_val(rec[idx_hours], None),
+                "week": week_val,
+            })
+
+    # 提取临时工作（从备注中识别）
+    temp_work = []
+    skip_keywords = ["未完成", "延期", "搁置", "等待"]
+    for rec in all_records:
+        remark = rec.get("remark", "")
+        if remark and len(remark) > 10 and not any(k in remark for k in skip_keywords):
+            temp_work.append({
+                "record_id": rec["record_id"],
+                "content": remark,
+                "source_week": rec["week"],
+            })
+
+    user_data = run_lark(["contact", "+get-user", "--as", "user"])
+    name = user_data["data"]["user"]["name"]
+
+    result = {
+        "name": name,
+        "month": month,
+        "records": all_records,
+        "temp_work": temp_work,
+        "total_records": len(all_records),
+        "temp_work_count": len(temp_work),
+    }
+    print(json.dumps(result, ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    main()

package/skills/sab-monthly-summary/scripts/config.py

@@ -0,0 +1,41 @@
+"""共享配置"""
+
+BASE_TOKEN = "HBR3bvERVaooCUsFfxcc0fYLndd"
+
+TABLE_IDS = {
+    "部门人员": "tblxsJA46bTLlUEE",
+    "周计划": "tblN6nUNSwah6j2v",
+    "月计划": "tblLb0SsT38HFf8X",
+}
+
+DEFAULT_DEPT = "信息技术"
+
+# 人员字段映射
+PERSONNEL_FIELDS = {
+    "人员": "fldbGCCdNV",
+    "所属组": "flddUR4K4c",
+    "人名": "fldrI663hx",
+}
+
+# 周计划可写字段
+WEEKLY_WRITABLE_FIELDS = [
+    "责任人",       # fldOavYzSr, user
+    "月周",         # fldAivwku1, select
+    "工作计划内容",  # fldjdmxh69, text
+    "工时",         # fldQXhORVG, number
+    "完成情况",     # fldF9ebqDi, select
+    "备注",         # fldu5uAqGU, text
+    "计划来源",     # fldIvgrltV, select
+    "业务组",       # fldgFNrrqP, select
+]
+
+# 周计划只读字段（不要写）
+WEEKLY_READONLY_FIELDS = [
+    "创建时间",     # fldJrGqC4Y, created_at
+    "修改人",       # fldMZjLGsr, updated_by
+    "创建人",       # fldnYVOlV6, created_by
+    "最后更新时间",  # fldzy7XDqO, updated_at
+]
+
+# 脚本可被 sab-weekly-plan 和 sab-monthly-summary 两个 skill 引用
+# SKILL.md 中的引用路径: ../sab-shared/scripts/

package/skills/sab-monthly-summary/scripts/create_next_week.py

@@ -0,0 +1,85 @@
+#!/usr/bin/env python3
+"""创建下周周计划记录：迁移未完成项 + 新建用户口述的计划。
+
+用法:
+  python3 create_next_week.py \
+    --open-id ou_xxx \
+    --group 移动 \
+    --next-week "7月第5周" \
+    --migrated '[{"content":"xxx","hours":8}]' \
+    --new '[{"content":"yyy","hours":4}]'
+"""
+
+import json
+import subprocess
+import sys
+import argparse
+import os
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+import config
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--open-id", required=True)
+    parser.add_argument("--group", required=True)
+    parser.add_argument("--next-week", required=True)
+    parser.add_argument("--migrated", default="[]")
+    parser.add_argument("--new", default="[]")
+    args = parser.parse_args()
+
+    try:
+        migrated = json.loads(args.migrated)
+        new_items = json.loads(args.new)
+    except json.JSONDecodeError as e:
+        print(json.dumps({"ok": False, "error": "invalid_json", "detail": str(e)}, ensure_ascii=False))
+        sys.exit(1)
+
+    all_items = migrated + new_items
+    if not all_items:
+        print(json.dumps({"ok": True, "created": 0}, ensure_ascii=False))
+        return
+
+    fields = ["责任人", "月周", "工作计划内容", "工时", "业务组", "计划来源"]
+    rows = []
+    for item in all_items:
+        row = [
+            [{"id": args.open_id}],
+            args.next_week,
+            item.get("content", ""),
+            item.get("hours"),
+            args.group,
+            item.get("source", "新增计划"),
+        ]
+        rows.append(row)
+
+    payload = json.dumps({"fields": fields, "rows": rows}, ensure_ascii=False)
+
+    result = subprocess.run(
+        [
+            "lark-cli", "base", "+record-batch-create",
+            "--base-token", config.BASE_TOKEN,
+            "--table-id", config.TABLE_IDS["周计划"],
+            "--json", payload,
+            "--as", "user",
+        ],
+        capture_output=True,
+        text=True,
+        timeout=30,
+    )
+
+    try:
+        data = json.loads(result.stdout)
+    except json.JSONDecodeError:
+        data = json.loads(result.stderr) if result.stderr else {"ok": False}
+
+    if data.get("ok"):
+        print(json.dumps({"ok": True, "created": len(rows)}, ensure_ascii=False))
+    else:
+        print(json.dumps({"ok": False, "error": data.get("error", {})}, ensure_ascii=False))
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/skills/sab-monthly-summary/scripts/generate_monthly_md.py

@@ -0,0 +1,91 @@
+#!/usr/bin/env python3
+"""按模板生成月总结 Markdown。
+
+用法: python3 generate_monthly_md.py --data '<json_from_collect>'
+输出: Markdown 文本到 stdout
+"""
+
+import json
+import sys
+import argparse
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--data", required=True)
+    args = parser.parse_args()
+
+    try:
+        data = json.loads(args.data)
+    except json.JSONDecodeError as e:
+        print("ERROR: invalid JSON: {}".format(e), file=sys.stderr)
+        sys.exit(1)
+
+    name = data.get("name", "")
+    month = data.get("month", "")
+    records = data.get("records", [])
+    temp_work = data.get("temp_work", [])
+    year = 2026
+
+    lines = []
+    lines.append("# 信息技术科 {}年{}月工作总结\n".format(year, month))
+    lines.append(name + "\n")
+
+    # 一、工作计划完成情况
+    lines.append("## 一、工作计划完成情况（包括计划外完成）\n")
+
+    table_rows = []
+    idx = 0
+
+    for rec in records:
+        idx += 1
+        completion = rec.get("completion_status", "")
+        remark = rec.get("remark", "")
+        follow_up = ""
+        if completion == "未完成":
+            follow_up = "移至下月继续跟进"
+
+        table_rows.append("| {} | {} | {} | {} | {} |".format(
+            idx, rec.get("content", ""), completion, remark, follow_up
+        ))
+
+    # 临时工作也插入表格
+    for tw in temp_work:
+        idx += 1
+        table_rows.append("| {} | {} | {} | {} | {} |".format(
+            idx, tw.get("content", ""), "（临时工作）", tw.get("content", "")[:50], "-"
+        ))
+
+    if table_rows:
+        lines.append("| 序号 | 内容 | 完成情况 | 原因说明 | 跟进措施 |")
+        lines.append("|------|------|---------|---------|---------|")
+        lines.extend(table_rows)
+        lines.append("")
+
+    # 二、重点工作回顾
+    lines.append("## 二、重点工作回顾\n")
+    completed = [r for r in records if r.get("completion_status") == "完成"]
+    if completed:
+        lines.append("<!-- AI: 从以下已完成项中提炼1-3个重点工作 -->")
+        for r in completed[:5]:
+            lines.append("<!--   - {} -->".format(r.get("content", "")))
+    lines.append("（待 AI 根据上述材料生成）\n")
+
+    # 三、存在问题及分析
+    lines.append("## 三、存在问题及分析\n")
+    undone = [r for r in records if r.get("completion_status") == "未完成"]
+    if undone:
+        lines.append("<!-- AI: 从以下未完成项汇总共性问题 -->")
+        for r in undone:
+            lines.append("<!--   - {}: {} -->".format(r.get("content", ""), r.get("remark", "")))
+    lines.append("（待 AI 根据上述材料生成）\n")
+
+    # 四、下月工作重点
+    lines.append("## 四、下月工作重点\n")
+    lines.append("（待 AI 根据上述材料生成）\n")
+
+    print("\n".join(lines))
+
+
+if __name__ == "__main__":
+    main()