# 弘讯Skill

**Repository Path**: mahaibing/hongxun-skill

## Basic Information

- **Project Name**: 弘讯Skill
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-06
- **Last Updated**: 2026-10-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 集中维护的可分发 Skill

本目录是 `D:\开发项目` 下所有自维护 Skill 的唯一实体目录，也保存可交给其他 Codex 工作区使用的压缩包。
当前包含五个按系统/职责拆分的 Skill：

2026-10-22：五个 Skill 已加入用户要求的密钥存储授权规则：未经明确允许，禁止使用 Windows 凭据管理器存储任何信息；同步修正 Python/UniBridge 的旧默认凭据要求，以及 MAUI 平台存储说明。规则文档更新不修改程序、认证流程或现有凭据。

同日进一步移除 Python/UniBridge 引用文档中的旧默认 Target 和历史凭据位置指引，密钥只从当前项目明确授权的来源读取。

2026-10-27：E10 操作规范补充顶部搜索导航、销售订单导入及主需求/MRP/APS 字段查询经验，新增[字段查询与模块速查](digiwin-e10-desktop/references/字段查询与模块速查.md)，并同步详细控件记录；业务参数及实际提交仍以当前任务授权为准。

2026-10-28：补充 E10 登录窗口重建、PaneControl 类型兼容及实际加载状态判据；Python RPA 规范新增[单份 XLSX 判重与保留规则](python-rpa-project/references/单份XLSX判重与保留规则.md)，明确人工维护入口、三个月保留边界、未完成记录保护和原子写入要求，不授权批量改造旧项目。

2026-10-29：E10 控件记录补充生产入库翻页、完整行可操作区域、审核菜单悬停及命令完成判据，保留本机验证与故障机待复验的边界。2026-10-30 续补采购到货单价直接输入、原生编辑框归属及放弃未保存更改的现场记录；这些记录不授权自动落账或批量修改现有业务。

```text
python-rpa-project\
digiwin-e10-desktop\
hitachi-box-plan-export\
unibridge-api\
dotnet-maui-app\
```

## 在本仓库中使用

在 `D:\开发项目` 下创建、修改、审查、测试或打包 Python 自动化程序时，项目范围内的
`AGENTS.md` 会强制先读取：

```text
D:\开发项目\1.Skill\python-rpa-project\SKILL.md
```

详细规则的引用文件也必须从该目录继续读取。Codex 和 Claude 用户 Skill 目录使用目录联接指向本目录，
不维护第二份副本；业务项目目录不再保留 Skill 兼容目录。

在本仓库选择、调用或封装 UniBridge 接口时，根 `AGENTS.md` 会同时强制读取：

```text
D:\开发项目\1.Skill\unibridge-api\SKILL.md
```

详细安装步骤也随压缩包保存在
`python-rpa-project\安装说明.md`；只拿到 ZIP 的使用者仍能完成安装和验证。

## 交给其他人使用

### 方式一：作为仓库规则使用（推荐）

把整个 `可分发Skills` 目录复制到对方项目仓库根目录，并在对方仓库根 `AGENTS.md` 中加入：

```text
本仓库涉及 Python 自动化/RPA 时，动手前必须先完整读取仓库根目录下的
可分发Skills\python-rpa-project\SKILL.md，再按该 Skill 的引用规则读取相关 references 文件。
本仓库涉及 UniBridge 接口时，还必须先完整读取仓库根目录下的
可分发Skills\unibridge-api\SKILL.md，再按该 Skill 的引用规则读取相关 references 文件。
```

这种方式不依赖对方安装全局 Skill，规则跟随仓库版本管理，最适合公司内部项目。

### 方式二：安装为用户 Skill

将 `python-rpa-project` 整个目录复制到：

```text
%USERPROFILE%\.codex\skills\python-rpa-project\
```

建议复制整个目录，不要只复制 `SKILL.md`，因为入口会引用 `references` 中的详细规则。
复制后新开 Codex 对话，再明确使用：

```text
使用 $python-rpa-project 按统一 RPA 规范创建或修改这个项目。
```

需要调用 UniBridge 时，将 `unibridge-api` 整个目录复制到：

```text
%USERPROFILE%\.codex\skills\unibridge-api\
```

复制后新开 Codex 对话，可明确输入：

```text
使用 $unibridge-api 选择并调用合适的 UniBridge 接口完成这项业务。
```

### 压缩包

同级的 `python-rpa-project.zip`、`digiwin-e10-desktop.zip`、`hitachi-box-plan-export.zip`、
`unibridge-api.zip` 和 `dotnet-maui-app.zip` 是可直接转交的压缩包。
解压后必须保持对应的顶层目录结构：

```text
python-rpa-project\
├─ SKILL.md
├─ agents\openai.yaml
└─ references\*.md
```

鼎捷 E10 和日立 HELC 分别解压到同级的 `digiwin-e10-desktop\`、`hitachi-box-plan-export\` 目录。
UniBridge 接口调用 Skill 解压到同级的 `unibridge-api\` 目录；使用时可明确输入
`使用 $unibridge-api 选择并调用合适的 UniBridge 接口`。

不要把压缩包直接解压成 `skills\SKILL.md`，也不要只抽出某一个引用文件。

## 维护规则

- 每个系统单独维护一个 Skill 文件夹：`python-rpa-project\` 管 Python RPA 项目规范（含统一的独立进程运行气泡和 `config.json` 桌面编辑器要求），
  `digiwin-e10-desktop\` 管鼎捷 E10 桌面系统和控件选择器，`hitachi-box-plan-export\` 管日立 HELC
  浏览器平台和选择器，`unibridge-api\` 管 UniBridge 接口选择、认证流程和请求契约，
  `dotnet-maui-app\` 管 MAUI 构建、Android 联调、输入和 APK 发布。
- `D:\开发项目\1.Skill` 是唯一维护源；用户 Skill 目录中的兼容路径只建立目录联接。
- 各 Skill 自己的 `SKILL.md` 和 `references\` 是对应规则的唯一维护源；E10 规则不再只放在
  `python-rpa-project\references\系统集成规则.md`，后者仅保留“何时读取哪个系统 Skill”的入口说明。
- 根 `AGENTS.md` 只保留“何时读取、从哪里读取、缺失时怎么办”等入口规则。
- 规则变更后重新运行各 Skill 校验，并重新生成五个对应 ZIP；系统 Skill 通过引用继承 Python RPA 通用规则，不复制气泡、日志或状态模板。
- 可以先运行 `python-rpa-project\scripts\validate_skill.ps1` 做无需第三方依赖的结构检查。
- 根 README 只保留索引和简要说明，不复制整套规则。
- Python 文件的项目归属和落盘目录统一遵循 `python-rpa-project`：包括临时诊断、探查和测试脚本在内的所有 `.py` 文件，只能写入所属项目目录，禁止写入仓库主目录。
- 不把密码、Secret、Token、真实业务附件或运行状态文件打进压缩包。

## 发布前检查

```text
1. SKILL.md、agents/openai.yaml、references 文件均存在。
2. SKILL.md 中的引用路径都能在当前目录解析。
3. 没有 TODO、占位符或敏感信息。
4. Skill 结构校验通过。
5. 各 ZIP 内仍保留对应的顶层 Skill 目录。
6. 根 AGENTS.md 和根 README.md 只记录入口与索引，不复制详细规则。
```