# Chinese Form Automation

> chinese-form-automation

- Skill: `yakeworld/chinese-form-automation` (Agent Skill, multi-file: 16 files)
- Install (CLI): `npx skillmds@latest add yakeworld/chinese-form-automation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yakeworld/chinese-form-automation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: yakeworld (https://skillmd.com/u/yakeworld)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/yakeworld/chinese-form-automation

---



## Operational Steps
1. 确认输入参数完整
2. 执行核心操作（参考本目录下的 scripts/ 或 references/）
3. 验证输出符合契约
4. 保存结果并报告

## Pitfalls
- 
- 

## Verification
- 
- 
- 
- 
1. 
2. 
3. 
## IO_CONTRACT

- **input**: `request: str, context: dict` — 用户请求描述、上下文信息
- **output**: `result: dict — 技能执行结果（结构因技能而异）`

> 对应原则：P2（机械原子暴露输入输出规范）

# Chinese Form Automation

自动填写中文政府/教育/学术申请表 — docx+xlsx模板填充。

详细内容请加载对应 references/ 目录下的参考文件。

## Environment Pitfalls

- **python-docx sandbox**: In Hermes sandbox (Python 3.12), `pip install python-docx` requires `--break-system-packages` flag (PEP 668). Python 3.11 environments do NOT need this flag. Always check Python version before pip install. If sandbox fails, use `terminal` tool directly.
- **markitdown docx**: Also requires `markitdown[docx]` extra for .docx conversion. Prefer direct `python-docx` library for reliability.

## User Preference Pitfalls

- User explicitly prefers **特色介绍** (highlight-based feature showcase) over **平台架构** (platform architecture). When asked to introduce Synthos or research capabilities, focus on distinctive/unique capabilities, not comprehensive platform overview. Do NOT create PPT unless explicitly requested — document (docx) is the default format.
- For file sending: Feishu requires specific chat_id format `feishu:oc_<id>` for direct messages, not bare `feishu`.
- NJJK (神经网络科技/脑机接口) 摸底模板：科技局标准调查表，按框架逐项填写。收到模板文件后直接按框架填充，不额外创建 PPT。

## References

- `templates/njjk-survey-template.md` — NJJK 摸底调查框架模板及 Synthos 填充指南
- `references/competition-application-workflow-2026-05-30.md`
- `references/competition-data-source-audit-2026-05-30.md`
- `references/hangzhou-medical-college-industry-mentor-2026.md`
- `references/researcher-profiling-via-notebooklm.md`

## 验证清单 · VERIFICATION

- [ ] 目标 docx/xlsx 模板文件存在且路径有效，python-docx 可直接打开解析
- [ ] 填写字段与数据键一一对应，无遗漏、无串位（逐项核对模板框架）
- [ ] NJJK/申报类模板按标准框架逐项填充完成，未额外生成 PPT
- [ ] 输出文档可重新打开，关键单元格内容与源数据一致（抽查校验）
- [ ] 文件经飞书发送时使用 `feishu:oc_<id>` 格式 chat_id，非裸 `feishu` 标识
- [ ] Python 3.12 环境下 pip 安装 python-docx 已带 `--break-system-packages`，未静默失败

## 约束规则 · RULES

1. **输入约束**: 参数类型、范围、格式必须校验
2. **输出约束**: 返回值结构、编码、命名必须一致
3. **异常约束**: 错误信息必须包含上下文和恢复建议
4. **安全约束**: 不执行未验证的任意代码，不暴露内部状态

## Golden 集合 · GOLDEN SET

- **Golden Input**: 标准输入样本（覆盖正常路径）
- **Golden Output**: 预期输出（精确匹配或格式校验）
- **Golden Error**: 预期错误信息（覆盖失败路径）

> Golden 集合是测试的单一真理来源。所有改进必须通过 golden 测试。

> 违反规则的操作视为不安全，必须拒绝或隔离。

> 每项验证必须可执行、可记录、可复现。验证失败时记录原因和修复。

## Genes (策略基因)

> 紧凑策略表示。条件→策略。需要深度时参考完整文档。

- **[CHIN-001]** 处理中文表格/表单自动化任务 → 优先使用 `python-docx` 库直接操作以确保可靠性，避免依赖 `markitdown` 转换
- **[CHIN-002]** 在 Python 3.12 沙箱环境安装 `python-docx` → 必须添加 `--break-system-packages` 标志以绕过 PEP 668 限制
- **[CHIN-003]** 用户请求介绍 Synthos 或研究能力 → 聚焦“特色介绍”（独特能力展示）而非“平台架构”，且默认输出 docx 文档而非 PPT
- **[CHIN-004]** 接收 NJJK（神经网络科技/脑机接口）摸底模板 → 直接按科技局标准框架逐项填充数据，不额外创建 PPT
- **[CHIN-005]** 通过飞书发送文件 → 必须使用 `feishu:oc_<id>` 格式的 chat_id 进行私聊发送，禁止使用裸 `feishu` 标识
- **[CHIN-006]** 执行核心操作前 → 严格校验输入参数、文件路径及上下文的完整性与有效性
- **[CHIN-007]** 处理异常或失败场景 → 错误信息必须包含具体上下文和明确的恢复指引，确保可复现和可记录