메뉴
用于生成《统一运营系统》功能设计文档（.md + .docx 双格式）。当用户提到"生成功能设计文档"、"新建某某功能的设计文档"、"按模板生成文档"、"更新现有功能设计文档"时，应使用本 skill。自动完成版本号管理（_vX.X 递增）、文档格式规范（宋体、1.5倍行距、淡蓝色表头）并同步输出两种格式。
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/egbertie/satisficing-lab --skill tongyiyunying-doc-gen명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SOC 직업 분류 기준
SKILL.md 표시 중
| name | tongyiyunying-doc-gen |
| description | 用于生成《统一运营系统》功能设计文档（.md + .docx 双格式）。当用户提到"生成功能设计文档"、"新建某某功能的设计文档"、"按模板生成文档"、"更新现有功能设计文档"时，应使用本 skill。自动完成版本号管理（_vX.X 递增）、文档格式规范（宋体、1.5倍行距、淡蓝色表头）并同步输出两种格式。 |
| allowed-tools | null |
| disable | true |
本 skill 服务于《统一运营系统》产品文档管理，负责按标准模板生成和维护功能设计文档。
所有文档默认输出到项目根目录的 tongyiyunying/doc/ 下，也可通过环境变量 DOC_DIR 指定自定义路径。
{文档名}_vX.X.md 和 {文档名}_vX.X.docx.md 中的「文档版本」字段读取，快照文件名版本号与文档内修订记录严格一致v0.1 开始统一运营系统-xxx功能设计.md）始终保持最新内容，作为工作源文件生成功能设计文档时，如涉及「导出」功能描述，需遵循以下命名规范：
{业务前缀}_{YYYYMMDD}_{HHMMSS}.xlsx车辆信息_20260405_103045.xlsx各模块业务前缀对照表：
| 模块 | 导出前缀 | 示例文件名 |
|---|---|---|
| 车辆信息管理 | 车辆信息 | 车辆信息_20260405_103045.xlsx |
| SIM卡信息管理 | SIM卡信息 | SIM卡信息_20260405_103045.xlsx |
| OBU信息管理 | OBU设备信息 | OBU设备信息_20260405_103045.xlsx |
| 摄像头管理 | 摄像头设备信息 | 摄像头设备信息_20260405_103045.xlsx |
导入模板文件名（固定名称，不带时间戳）：
| 模块 | 模板文件名 |
|---|---|
| 车辆信息管理 | 车辆信息批量导入模板.xlsx |
| SIM卡信息管理 | 批量导入模板.xlsx |
| OBU信息管理 | OBU导入模板.xlsx |
| 摄像头管理 | 摄像头导入模板.xlsx |
生成功能设计文档时，如涉及「导入」功能描述，需遵循以下逻辑规范：
核心原则：前置全量校验，有错不导入，全部通过才入库
| 阶段 | 处理逻辑 | 用户反馈 |
|---|---|---|
| 文件上传 | 校验文件格式（.xlsx）和大小（≤10MB） | 格式错误时Toast提示阻断 |
| 数据校验 | 逐行校验所有数据（必填/格式/长度/唯一性/关联数据/字典值） | 错误列表直接展示在页面（行号+列名+原因） |
| 导入执行 | 仅当全部数据校验通过后才执行导入 | 成功后Toast提示导入条数 |
校验类型清单：
错误提示格式：
第X行，【字段名】：错误原因第3行，SIM卡号：不能为空、第5行，手机号：格式不正确生成功能设计文档时，如涉及「删除」功能描述，需遵循以下规范：
核心原则：根据业务需要决定是否提供批量删除功能
| 模式 | 适用场景 | 实现方式 |
|---|---|---|
| 单条删除 | 数据敏感、操作不可逆、需严格控制的场景 | 列表不展示复选框，仅在行内操作列提供删除按钮 |
| 批量删除 | 数据量大、操作频繁、需提升效率的场景 | 列表展示复选框，工具栏提供批量删除按钮 |
| 项目 | 规范要求 |
|---|---|
| 删除入口 | 单条删除在每行数据的操作列提供"删除"按钮；批量删除在工具栏提供"删除"按钮 |
| 删除约束 | 已绑定/已入网/已启用等状态的数据，删除按钮灰化不可用 |
| 确认机制 | 点击删除后弹出确认弹窗，确认后才执行删除 |
注：具体项目可根据业务需求在文档中明确是否提供批量删除功能。
D9E1F2）scripts/gen_template.js生成模板文件（AI智能体-统一运营系统-xxxxx功能设计模板）的 .docx 和 .md 版本。
# 在项目根目录下运行（系统会自动找 tongyiyunying/doc/ 作为输出目录）
cd /your/project/root && /usr/local/bin/node ~/.workbuddy/skills/统一运营系统文档生成/scripts/gen_template.js
# 或者手动指定输出目录（推荐，路径不规范时使用）
export DOC_DIR=/your/project/root/tongyiyunying/doc
/usr/local/bin/node ~/.workbuddy/skills/统一运营系统文档生成/scripts/gen_template.js
scripts/gen_from_md.js ⭐ 主力脚本（推荐）直接解析 .md 源文件生成 .docx，内容与 .md 100% 一致，不依赖 hardcode build 函数。
版本号从源文件「文档版本」字段读取，快照文件名与文档内修订记录严格对齐。
# 只生成单个文档（推荐）
DOC_DIR=/your/project/root/tongyiyunying/doc \
/usr/local/bin/node ~/.workbuddy/skills/统一运营系统文档生成/scripts/gen_from_md.js --doc sim
# 同时生成多个文档（逗号分隔）
DOC_DIR=/your/project/root/tongyiyunying/doc \
/usr/local/bin/node ~/.workbuddy/skills/统一运营系统文档生成/scripts/gen_from_md.js --doc sim,obu
# 不传参数 = 生成全部文档
DOC_DIR=/your/project/root/tongyiyunying/doc \
/usr/local/bin/node ~/.workbuddy/skills/统一运营系统文档生成/scripts/gen_from_md.js
当前已注册的文档 key 对照表：
| key | 文档名 |
|---|---|
vehicle | 统一运营系统-车辆监控管理功能设计 |
homepage | 统一运营系统-首页概览功能设计 |
sim | 统一运营系统-SIM卡信息管理功能设计 |
obu | 统一运营系统-OBU信息管理功能设计 |
vehicle-info | 统一运营系统-车辆信息管理功能设计 |
car-type | 统一运营系统-车型字典管理功能设计 |
新增文档 key：只需在
gen_from_md.js末尾的ALL_DOCS映射表中追加一行'key': '文档名'即可，无需编写 build 函数。
scripts/gen_update_v1.js （旧版，保留备用）旧版脚本，依赖 hardcode build 函数生成 docx。新文档请使用 gen_from_md.js，此脚本仅保留作历史参考。
注意：两个脚本都依赖
docxnpm 包。运行前确认工作目录下有node_modules/docx，否则先执行npm install docx。
doc/ 目录下创建 统一运营系统-{功能名}功能设计.md，按十二章模板填写内容；封面写好文档版本（v0.1）和修订记录gen_from_md.js 的 ALL_DOCS 映射表中追加一行.md 源文件核心内容（章节结构、版本号、修订记录）呈现给用户，说明即将生成的文件名，请用户确认无误后再执行gen_from_md.js --doc new-key，自动输出 _v0.1.md 和 _v0.1.docx💡 注意：步骤 4 是推荐实践，不是强制流程。若用户在对话中已明确告知内容无误或主动要求直接生成，可跳过确认步骤。
统一运营系统-SIM卡信息管理功能设计.md）gen_from_md.js --doc <key>，脚本自动读取源文件版本号命名快照，旧快照归入 backup/💡 注意：若用户团队有「必须二次确认」的流程约定，请在项目级记忆（如 MEMORY.md）中记录，skill 本身不强制此行为。
references/功能设计文档模板.md：完整的十二章模板，含所有章节示例内容references/统一运营系统-等保三级通用安全要求.md：等保三级通用安全规范。生成或更新业务文档时，如需填写 §10.1 等保三级合规规范引用节，从本文件中读取对应章节内容，按实际模块适用情况摘取并填入表格；不适用的行可删除。