@yionr/plan-kit 1.0.0

package/skills/sab-monthly-summary/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-monthly-summary/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-monthly-summary/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-monthly-summary/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-weekly-plan/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: sab-weekly-plan
+description: >-
+  读写飞书多维表格"周计划"表，反馈本周周计划完成情况、创建下周周计划。
+  当用户说"写本周计划"、"反馈周计划"、"更新完成情况"时就使用此skill。
+---
+
+# SAB 周计划管理
+
+## 前置依赖
+
+- `lark-cli` 已安装并认证
+- Python 脚本位于本 skill 目录下的 `scripts/` 中
+
+## 重要规则
+
+1. **只操作用户自己的记录**
+2. **空完成情况必须逐条追问用户**，不允许自行推断或跳过
+3. **所有数据操作必须通过固化脚本**，不要直接拼接 lark-cli 命令
+4. **脚本路径**：本 skill 的 SKILL.md 所在目录下的 `scripts/`
+
+## 流程
+
+### 步骤 1：定位用户
+
+```bash
+python3 scripts/get_user_info.py
+```
+
+从输出 JSON 中获取 `open_id`、`name`、`group`。
+
+### 步骤 2：计算当前月周
+
+```bash
+python3 scripts/get_current_week.py
+```
+
+从输出 JSON 中获取 `this_week`、`next_week`。
+
+### 步骤 3：查询本周记录
+
+```bash
+python3 scripts/query_weekly_records.py --open-id <open_id> --week <this_week>
+```
+
+输出为 JSON 数组，每条含 `record_id`、`content`、`completion_status`、`remark`、`hours`、`week`。
+
+将记录展示给用户，逐条标注当前状态。
+
+### 步骤 4：与用户交互确认完成情况
+
+展示本周所有记录清单给用户，并逐条确认：
+
+```
+你本周共有 N 条工作计划：
+
+1. [完成] 内核升级（工时 4h）
+2. [空]   织带接口（工时 8h）  ← 请确认：这条完成了吗？
+3. [完成] 监控脚本（工时 2h）
+4. [空]   数据迁移（工时 6h）  ← 请确认：这条完成了吗？
+```
+
+**规则**：
+- 用户已明确提及的项，直接更新
+- 完成情况为空的项，必须逐条追问，不能跳过
+- 用户说明未完成原因时，记录到备注
+
+### 步骤 5：更新完成情况
+
+将确认后的结果构造为 JSON 数组，调用脚本：
+
+```bash
+python3 scripts/update_completion.py \
+  --records '[{"record_id":"rec_xxx","completion":"完成","remark":""},{"record_id":"rec_yyy","completion":"未完成","remark":"依赖的后端接口还没好"}]'
+```
+
+### 步骤 6：确认下周计划
+
+询问用户下周要做的新事项，以及未完成项的处置。
+
+### 步骤 7：创建下周记录
+
+将迁移项和新增项合并，调用脚本：
+
+```bash
+python3 scripts/create_next_week.py \
+  --open-id <open_id> \
+  --group <group> \
+  --next-week <next_week> \
+  --migrated '[{"content":"织带接口","hours":8}]' \
+  --new '[{"content":"批量导出功能","hours":8}]'
+```
+
+### 步骤 8：汇报结果
+
+向用户总结本次操作：更新了 N 条本周完成情况，创建了 M 条下周计划。
+
+## 字段参考
+
+| 字段名 | 类型 | 说明 |
+|--------|------|------|
+| 责任人 | user | 当前用户 open_id |
+| 月周 | select | 如"7月第4周" |
+| 工作计划内容 | text | 工作描述 |
+| 工时 | number | 单位: 时 |
+| 完成情况 | select | 完成/未完成/其他 |
+| 备注 | text | 未完成原因或补充说明 |
+| 计划来源 | select | 默认"新增计划" |
+| 业务组 | select | 从部门人员表查得 |

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