@yionr/plan-kit 1.0.0

package/skills/sab-weekly-plan/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()

package/skills/sab-weekly-plan/scripts/get_current_week.py

@@ -0,0 +1,79 @@
+#!/usr/bin/env python3
+"""计算当前周和下周的月周值，输出 JSON 到 stdout。
+
+月周归属规则：
+- 以周一为周起始
+- 一周中在某个月天数 >= 4 天 → 归属该月
+- 该月第一周从归属该月的第一个周一开始编号
+
+用法: python3 get_current_week.py [--date YYYY-MM-DD]
+"""
+
+import json
+import sys
+from datetime import date, timedelta
+
+
+def get_monday(d):
+    """返回日期 d 所在周的周一。"""
+    return d - timedelta(days=d.weekday())
+
+
+def count_month_days(week_monday):
+    """统计一周在各个月的天数。"""
+    counts = {}
+    for i in range(7):
+        day = week_monday + timedelta(days=i)
+        counts[day.month] = counts.get(day.month, 0) + 1
+    return counts
+
+
+def get_yuezhou(week_monday):
+    """根据周一日期，计算对应的月周字符串。"""
+    counts = count_month_days(week_monday)
+    target_month = max(counts, key=counts.get)
+
+    if counts[target_month] < 4:
+        target_month = (week_monday + timedelta(days=3)).month
+
+    year = week_monday.year
+    first_day = date(year, target_month, 1)
+    cursor = get_monday(first_day)
+
+    week_num = 0
+    while cursor <= week_monday + timedelta(days=7):
+        cursor_counts = count_month_days(cursor)
+        assigned = max(cursor_counts, key=cursor_counts.get)
+
+        if assigned == target_month:
+            week_num += 1
+            if cursor == week_monday:
+                return "{}月第{}周".format(target_month, week_num)
+
+        cursor += timedelta(days=7)
+
+    return None
+
+
+def main():
+    specified_date = None
+    for i, arg in enumerate(sys.argv):
+        if arg == "--date" and i + 1 < len(sys.argv):
+            specified_date = date.fromisoformat(sys.argv[i + 1])
+            break
+
+    today = specified_date or date.today()
+    this_monday = get_monday(today)
+    next_monday = this_monday + timedelta(days=7)
+
+    result = {
+        "this_week": get_yuezhou(this_monday),
+        "next_week": get_yuezhou(next_monday),
+        "this_monday": this_monday.isoformat(),
+        "next_monday": next_monday.isoformat(),
+    }
+    print(json.dumps(result, ensure_ascii=False))
+
+
+if __name__ == "__main__":
+    main()

package/skills/sab-weekly-plan/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/skills/sab-weekly-plan/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/skills/sab-weekly-plan/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()