@yionr/plan-kit 1.0.0

package/cli.mjs

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { execSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const HOME = process.env.HOME || process.env.USERPROFILE || '/tmp';
+
+const program = new Command();
+
+program
+  .name('plan-kit')
+  .description('伟星SAB股份大洋数字化发展部周计划/月总结工具')
+  .version('1.0.0');
+
+program
+  .command('setup')
+  .description('交互式安装周计划/月总结 skill')
+  .action(async () => {
+    console.log(chalk.blue.bold('\n伟星SAB股份大洋数字化发展部周计划/月总结工具\n'));
+
+    // Step 1: 检查飞书 CLI 安装与认证
+    console.log(chalk.cyan('▸ 检查飞书 CLI...'));
+    let hasLarkCli = false;
+    let hasAuth = false;
+    try {
+      execSync('lark-cli --version 2>&1', { encoding: 'utf8', timeout: 10000 });
+      hasLarkCli = true;
+      console.log(chalk.green('  ✓ lark-cli 已安装'));
+    } catch {
+      console.log(chalk.yellow('  ✗ lark-cli 未安装'));
+    }
+
+    if (!hasLarkCli) {
+      const { installLark } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'installLark',
+        message: '是否现在安装飞书 CLI？（将运行 npx @larksuite/cli@latest install）',
+        default: true,
+      }]);
+      if (installLark) {
+        console.log(chalk.cyan('\n正在启动飞书 CLI 安装向导...\n'));
+        execSync('npx @larksuite/cli@latest install', { stdio: 'inherit' });
+        hasLarkCli = true;
+      } else {
+        console.log(chalk.red('未安装飞书 CLI，无法继续。'));
+        process.exit(1);
+      }
+    }
+
+    // 检测认证状态（auth status 直接输出 JSON，无 --as 参数）
+    console.log(chalk.cyan('▸ 检查飞书 CLI 认证状态...'));
+    try {
+      const authResult = execSync('lark-cli auth status 2>&1', { encoding: 'utf8', timeout: 10000 }).trim();
+      const authJson = JSON.parse(authResult);
+      const userIdentity = authJson.identities && authJson.identities.user;
+      if (userIdentity && userIdentity.status === 'ready' && userIdentity.tokenStatus === 'valid') {
+        hasAuth = true;
+        const userName = userIdentity.userName || '(未知)';
+        console.log(chalk.green(`  ✓ 已认证（${userName}）`));
+      } else {
+        throw new Error('not logged in');
+      }
+    } catch {
+      console.log(chalk.yellow('  ✗ 未认证或认证已过期'));
+    }
+
+    if (!hasAuth) {
+      // 飞书 CLI 的 config init 和 auth login 是交互式 TUI，
+      // 嵌套在 execSync 中可能导致键盘输入卡住（尤其 Windows）。
+      // 改为引导用户在独立终端中手动执行。
+      console.log(chalk.yellow('\n⚠ 飞书 CLI 未认证，请在新终端中运行以下命令完成配置：\n'));
+      console.log(chalk.cyan('  # 1. 初始化应用配置（需要 App ID 和 App Secret）'));
+      console.log(chalk.cyan('  lark-cli config init --new'));
+      console.log(chalk.cyan(''));
+      console.log(chalk.cyan('  # 2. 登录认证'));
+      console.log(chalk.cyan('  lark-cli auth login'));
+      console.log(chalk.cyan(''));
+      console.log(chalk.yellow('  配置完成后，按任意键继续安装 skill...\n'));
+
+      // 等待用户按键
+      process.stdin.setRawMode(true);
+      await new Promise(resolve => {
+        process.stdin.once('data', () => {
+          process.stdin.setRawMode(false);
+          resolve();
+        });
+      });
+
+      // 重新检测认证
+      try {
+        const recheck = execSync('lark-cli auth status 2>&1', { encoding: 'utf8', timeout: 10000 }).trim();
+        const recheckJson = JSON.parse(recheck);
+        const recheckUser = recheckJson.identities && recheckJson.identities.user;
+        if (recheckUser && recheckUser.status === 'ready' && recheckUser.tokenStatus === 'valid') {
+          hasAuth = true;
+          console.log(chalk.green('  ✓ 认证成功！\n'));
+        } else {
+          console.log(chalk.yellow('  ⚠ 仍检测到未认证，继续安装但脚本可能无法正常工作。\n'));
+        }
+      } catch {
+        console.log(chalk.yellow('  ⚠ 认证检测失败，继续安装但脚本可能无法正常工作。\n'));
+      }
+    }
+
+    // Step 2: 选择 Code Agent
+    const { agentDirs } = await inquirer.prompt([{
+      type: 'checkbox',
+      name: 'agentDirs',
+      message: '选择要安装到哪些 Code Agent 的 skills 目录：',
+      choices: [
+        { name: `Claude Code  (${path.join(HOME, '.claude/skills/')})`, value: path.join(HOME, '.claude/skills') },
+        { name: `Cursor       (${path.join(HOME, '.cursor/skills/')})`, value: path.join(HOME, '.cursor/skills') },
+        { name: `Codex        (${path.join(HOME, '.codex/skills/')})`, value: path.join(HOME, '.codex/skills') },
+        { name: '自定义路径（稍后输入）', value: '__custom__' },
+      ],
+      validate: (a) => a.length > 0 || '请至少选择一个',
+    }]);
+
+    let installDirs = agentDirs.filter(d => d !== '__custom__');
+    if (agentDirs.includes('__custom__')) {
+      const { customDir } = await inquirer.prompt([{
+        type: 'input',
+        name: 'customDir',
+        message: '请输入自定义 skills 目录路径：',
+        validate: (i) => i.trim().length > 0 || '路径不能为空',
+      }]);
+      installDirs.push(customDir.trim());
+    }
+
+    // Step 3: 选 Skill（周计划为必装，月总结可选）
+    console.log(chalk.cyan('\n▸ 安装 Skill'));
+    console.log(chalk.gray('  周计划 (sab-weekly-plan) — 默认必装'));
+
+    const { installSummary } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'installSummary',
+      message: '是否同时安装月总结 (sab-monthly-summary)？',
+      default: true,
+    }]);
+
+    const selectedSkills = ['sab-weekly-plan'];
+    if (installSummary) {
+      selectedSkills.push('sab-monthly-summary');
+    }
+
+    // Step 4: 安装 Skills（每个 skill 目录 = SKILL.md + scripts/）
+    for (const dir of installDirs) {
+      console.log(chalk.cyan('\n▸ 安装 Skill 到'), dir, '...');
+      fs.mkdirSync(dir, { recursive: true });
+
+      for (const skillName of selectedSkills) {
+        const skillSrc = path.join(__dirname, 'skills', skillName);
+        const dstDir = path.join(dir, skillName);
+        if (fs.existsSync(dstDir)) {
+          fs.rmSync(dstDir, { recursive: true });
+        }
+        fs.cpSync(skillSrc, dstDir, { recursive: true });
+        console.log(chalk.green('  ✓'), skillName, '(含 scripts/)');
+      }
+    }
+
+    console.log(chalk.green.bold('\n✓ 安装完成！\n'));
+    console.log('使用方式：');
+    console.log('  - 对 Claude 说「写本周计划」或「反馈本周完成情况」');
+    console.log('  - 对 Claude 说「生成X月工作总结」生成月总结');
+    console.log('');
+  });
+
+program.parse();

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@yionr/plan-kit",
+  "version": "1.0.0",
+  "description": "伟星SAB股份大洋数字化发展部周计划/月总结工具",
+  "bin": {
+    "plan-kit": "cli.mjs"
+  },
+  "files": [
+    "cli.mjs",
+    "scripts/",
+    "skills/",
+    "templates/"
+  ],
+  "dependencies": {
+    "commander": "^12.0.0",
+    "inquirer": "^9.0.0",
+    "chalk": "^5.0.0"
+  },
+  "license": "UNLICENSED",
+  "private": false
+}

package/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/scripts/config.py

@@ -0,0 +1,38 @@
+"""共享配置"""
+
+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
+]

package/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/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/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()