菜单
用于生成《统一运营系统》功能设计文档（.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 当前能够提供的文件。
正在显示 SKILL.md
在 Coze 聊天里需要把文件、图片、截图、图表、PDF、报告或任何可视化/二进制产物送达用户时使用——本地文件 (你刚生成的) 和群文件 (你从 `coze agent` 拿到群文件路径的) 两种来源都走这个技能。聊天默认纯文本, 生成的文件不会自动送达用户。触发: 用户明说要看 ("把图发我"、"send me the chart"); 隐式产出 (你刚生成 plot.png 用户在等结果); 主动展示 (做完该让用户看到的文件); 群文件转发 (你通过 `coze agent` 命令上传/获取到群文件路径后)。不适用于: 纯文本回答、短代码块、大于 50MB 的本地文件。
仅在 `<coze-context>` 标识为"群聊消息"且任务涉及该群组协作时使用——浏览群消息历史、查询群成员、读写编辑群项目文件、协调群里的多方协作、把协作产出衔接给用户。触发场景: 用户问"上次说啥/这次结论是啥"、"谁在群里/有谁的权限"; 用户让你"看一下/改一下/沉淀到"群文件; 用户让你基于群历史/群文件做产出。在"单聊消息"或与该群协作无关的一般性问答下不要使用。
4-agent AI advisory committee for strategic decisions. Runs CS, Marketing, Finance, and Tech agents in sequence to analyze proposals and deliver a majority-vote recommendation. Trigger: when you need help deciding strategy, prioritization, or whether to build something new.
基于 SOC 职业分类
| 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 等保三级合规规范引用节，从本文件中读取对应章节内容，按实际模块适用情况摘取并填入表格；不适用的行可删除。