name	ohmyflight-dev
description	ohmyflight 仓库内新增或修改工具的一般开发流程，适用于前端工具、Python 小工具、Excel 解析导出工具、业务规则实现、入口注册、spec 文档、测试和构建收尾。

Ohmyflight Dev

在本仓库新增或修改工具时使用本 skill。

开发参考

先读 AGENTS.md，再看仓库里同类型的成熟 app，不要从零臆造结构。
前端 Excel 工具优先参考 crew-flight-stats、hotel-bill-check、focus-crew。
文本解析工具优先参考 crew-extract-id、crew-match-name-id。
大型前端模块优先参考 training-workbench。
Python 工具优先参考 lock-entry-helper、flight-stats-helper、oa-read-helper。
工具入口看 src/tool/tools-data.ts，页面放 public/tool/app/<tool>/，源码放 src/tool/app/<tool>/。

实现原则

具体业务规则写进 spec/dev/<tool>/，用户操作方法写进 spec/user/<tool>/manual.md，不要写进 skill。
代码、测试、文档三位一体同步；三者有一个还在描述旧事实，任务就没完成。
业务逻辑和页面渲染分开：解析、统计、规则判断放可测试的逻辑模块，页面只负责上传、展示、导出和状态提示。
Excel 和文本处理优先按表头、字段名、结构化数据定位，不要写死文件名、sheet 名、列号或示例值，除非 spec 明确要求。
输出给人核对的文件必须保留必要结果、口径和异常说明，不要堆无用噪音。

验证原则

不要被页面表象迷惑。数据统计、Excel 解析、文本匹配、日期规则这类功能，正确性主要看核心逻辑测试、真实样本回放和导出结构检查。
在 PowerShell 里用 here-string 或管道临时运行 Node/Python 脚本时，中文字符串可能变成问号；验证中文路径、sheet 名、表头、分类名时，优先用文件扫描、索引、实际读取到的表头或 UTF-8 脚本文件，不要让命令文本里的中文成为关键定位条件。
真实浏览器只用于验证页面交互、资源加载、布局或必须依赖浏览器 API 的行为，不能替代核心逻辑测试。
UI 样式细节不作为核心测试对象；业务规则、解析规则、日期窗口、导出字段、曾经出错的回归点必须优先测试。
修改规则或修复回归时，优先把失败场景写进测试，再改实现。

收尾命令

按改动范围运行相关测试，然后收尾必须跑：

npm.cmd run build
npm.cmd run typecheck
npm.cmd test

如果只验证某个测试文件，可先跑：

npx.cmd vitest run tests/tool/<name>.test.ts

PowerShell 可能因为执行策略拦截 npm.ps1，本仓库内优先使用 npm.cmd 和 npx.cmd。

提交前

检查 git status --short。
只暂存本次任务相关文件。
不提交真实业务 Excel、Word、临时探测脚本、临时输出文件或无关脏改动。
提交信息按 AGENTS.md：简体中文，一句话，不分段不分行。

Más de este repositorio

mismo repositorio

personnel-report-check

luckymaomi/ohmyflight

核对人员结构统计和人员结构 Word 报告填充结果时使用。适用于人员信息 Excel、人员结构报告 docx、app.py 写回结果、统计口径闭合、资质代码映射和报告数据一致性核对。

2026-07-120

training-workbench

luckymaomi/ohmyflight

ohmyflight 培训皇帝/培训工作台专属开发引导。用于修改培训有效期、排班总览、模拟排班、CRM 年度核对、年度已培训人次、培训 Excel 解析导出、培训测试或培训 spec 时。

2026-07-120

read-flight-operations-manual

luckymaomi/ohmyflight

完整阅读、解释、定位和版本复核运行手册，覆盖手册与记录管理、运行组织、运行政策、机组资格和搭配、飞行时间值勤休息、飞行程序、签派与燃油、适航地面运行、安保、货物危险品、通信、性能载重平衡、紧急和恶劣天气、特殊运行、非计划运行、新辟航线及航站管理。用户询问真实航班运行规则、限制、职责、章节位置或要求核对新版运行手册时使用。

2026-07-120

read-flight-technical-management-manual

luckymaomi/ohmyflight

完整阅读、解释、定位和版本复核飞行技术管理手册，覆盖飞行训练组织、技术检查、航线资格、副驾驶与机长等级、教员和考试员聘任、执照、技术资料、技术档案、岗位胜任力、资质管理及全生命周期信息。用户询问飞行人员技术等级变化、进入条件、经历门槛、训练检查、资格获取保持恢复、章节位置，或要求核对新版飞行技术管理手册时使用。

2026-07-120

read-flight-training-program

luckymaomi/ohmyflight

完整阅读、解释、定位和版本复核飞行人员训练大纲，覆盖新雇员、副驾驶与机长转机型、航线和型别教员、检查员、重新获得资格、应急生存、英语、特殊机场、高原、CRM、PBN、EDTO、极地、EBT及其他专项训练。用户询问进入条件、训练课时、课程科目、考试、运行经历、资格获取保持恢复、某章是否适用，或要求核对新版训练大纲时使用。

2026-07-120

jobskill-dev

luckymaomi/ohmyflight

维护 ohmyflight 内的 Jobskill 业务技能子站。用户要求新增、删除、重命名或调整飞行部日常 Skill，修改 Jobskill 页面、导航、Markdown、图片附件、维护指南或索引时使用。

2026-07-120

Ohmyflight Dev

在本仓库新增或修改工具时使用本 skill。

开发参考

先读 AGENTS.md，再看仓库里同类型的成熟 app，不要从零臆造结构。

前端 Excel 工具优先参考 crew-flight-stats、hotel-bill-check、focus-crew。

文本解析工具优先参考 crew-extract-id、crew-match-name-id。

大型前端模块优先参考 training-workbench。

Python 工具优先参考 lock-entry-helper、flight-stats-helper、oa-read-helper。

工具入口看 src/tool/tools-data.ts，页面放 public/tool/app/<tool>/，源码放 src/tool/app/<tool>/。

实现原则

具体业务规则写进 spec/dev/<tool>/，用户操作方法写进 spec/user/<tool>/manual.md，不要写进 skill。

代码、测试、文档三位一体同步；三者有一个还在描述旧事实，任务就没完成。

业务逻辑和页面渲染分开：解析、统计、规则判断放可测试的逻辑模块，页面只负责上传、展示、导出和状态提示。

Excel 和文本处理优先按表头、字段名、结构化数据定位，不要写死文件名、sheet 名、列号或示例值，除非 spec 明确要求。

输出给人核对的文件必须保留必要结果、口径和异常说明，不要堆无用噪音。

验证原则

不要被页面表象迷惑。数据统计、Excel 解析、文本匹配、日期规则这类功能，正确性主要看核心逻辑测试、真实样本回放和导出结构检查。

在 PowerShell 里用 here-string 或管道临时运行 Node/Python 脚本时，中文字符串可能变成问号；验证中文路径、sheet 名、表头、分类名时，优先用文件扫描、索引、实际读取到的表头或 UTF-8 脚本文件，不要让命令文本里的中文成为关键定位条件。

真实浏览器只用于验证页面交互、资源加载、布局或必须依赖浏览器 API 的行为，不能替代核心逻辑测试。

UI 样式细节不作为核心测试对象；业务规则、解析规则、日期窗口、导出字段、曾经出错的回归点必须优先测试。

修改规则或修复回归时，优先把失败场景写进测试，再改实现。

收尾命令

按改动范围运行相关测试，然后收尾必须跑：

npm.cmd run build npm.cmd run typecheck npm.cmd test

如果只验证某个测试文件，可先跑：

npx.cmd vitest run tests/tool/<name>.test.ts

PowerShell 可能因为执行策略拦截 npm.ps1，本仓库内优先使用 npm.cmd 和 npx.cmd。

提交前

检查 git status --short。

只暂存本次任务相关文件。

不提交真实业务 Excel、Word、临时探测脚本、临时输出文件或无关脏改动。

提交信息按 AGENTS.md：简体中文，一句话，不分段不分行。