# 学生会策划部工作包（Skills + MCP）

面向**南通理工学院·土木工程学院学生会策划部**的可迁移工作包：一套主 Skill、配套文档生产 Skill，
以及推荐的 MCP 连接器配置与说明。用于把"活动从立项到结项"的文档工作流整体搬到另一台机器。

## 目录结构

```
.
├── skills/
│   ├── su-planning-office/        ★ 主技能：公文起草/排版/预算/校规约束/交付自检
│   ├── minimax-docx/              Word（.docx）生成与编辑（OpenXML）
│   ├── minimax-xlsx/              Excel（.xlsx）生成、编辑与校验脚本
│   ├── pptx-generator/            PPT 生成（JSON 驱动）
│   ├── ppt-beautify/              PPT 美化/版式
│   ├── html-to-docx-cn-gotchas/   中文 HTML→DOCX 的坑与处置
│   ├── tencent-docs-mcp/          腾讯文档 MCP 用法与排错
│   └── tencent-survey/            腾讯问卷 MCP 用法
└── mcp/
    ├── README.md                  在 WorkBuddy / DSH 中如何启用
    ├── mcp.servers.example.json   推荐连接器定义（占位符，无凭据）
    └── connectors-recommended.md  推荐清单：优先级、用途、暂不建议项
```

## 主技能内容（skills/su-planning-office）

- `SKILL.md` —— 触发词、校规硬约束、工作流、硬性规则
- `references/document-catalog.md` —— 9 类文档的必备字段与骨架
- `references/regulations-ntpc.md` —— 校规摘录（第二课堂 / 请假权限 / 处分 / 综合测评）
- `references/doc-standards.md` —— 排版规范（以国标为准的落地表）
- `references/gbt-9704-2012.md` —— **GB/T 9704—2012《党政机关公文格式》全文** + 关键数值速查
- `references/budget-and-reimbursement.md` —— 科目、大小写金额、审批与报销附件
- `references/review-checklist.md` —— 交付前自检清单
- `assets/templates/*.md` —— 六类文档骨架（策划书、通知、纪要、新闻稿、总结、预算表）
- `assets/reference/GB-T-9704-2012.pdf` —— 国标原文（图 1—12 为图片，文本无法还原）
- `scripts/check_submission.py` —— 纯标准库交付自检，含第二课堂学时速算

## 安装

**WorkBuddy**：把 `skills/<名称>/` 整体复制到 `~/.workbuddy/skills/`，重启或刷新技能目录即可被发现。

**DSH / Claude 类环境**：复制到对应技能根目录（DSH 为 `~/.dsh/skills/`）。
跨工具复用时可建目录联接，避免同一份内容维护两遍：

```powershell
New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\skills\su-planning-office" `
         -Target "$env:USERPROFILE\.workbuddy\skills\su-planning-office"
```

## 快速验证

```bash
python skills/su-planning-office/scripts/check_submission.py 策划书-示例-20261015-v1.0-张三.docx
python skills/su-planning-office/scripts/check_submission.py --pu --activity 志愿服务
```

## 环境要求

- Python 3.9+（自检脚本仅用标准库；生成 Office 文件需 `python-docx` / `openpyxl` / `python-pptx`）
- Node ≥ 20（仅 CLI 型连接器，如创客贴）
- MCP 连接器见 `mcp/README.md`

## 出处与许可

- `su-planning-office`：本项目原创。
- 其余 Skill 来自技能市场（MiniMax、腾讯等），均保留各自目录内的 `LICENSE` / `_skillhub_meta.json`，
  版权归原作者；此处仅为随包分发以便复现工作流。
- `GB-T-9704-2012.pdf` 为国家标准原文，仅供本私有仓库内部查阅。