rdmp-data-skill 0.0.0-stage → 1.0.0

package/.agents/skills/rdmp-data-skill/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: rdmp-data-skill
+description: 对已经拿到的 RDMP 数据做本地处理，覆盖数据理解、质量检查、基础分析、规范输出四项能力。当用户让你解读、检查、汇总、对比或规范呈现 RDMP 相关数据（项目计划、任务、审批、文件元数据、工时、项目洞察的入组/PD/SAE 聚合指标、Insight/BI 看板、EDC 报表），把表格或查询结果粘贴到对话里要你处理，说"帮我分析这份数据""检查数据有没有问题""算一下完成率/逾期情况""整理成规范报表"时，用这个技能。只处理对话中已有或用户提供的数据，不连接 RDMP、不发起查询。
+version: 1.0.0
+---
+
+# RDMP-AI数聚 数据处理 Skill
+
+统一对外版本：**AI数聚 V1.0**。本技能是 RDMP-AI数聚 的可选本地数据处理能力。
+分工只有一个原则：**MCP 是唯一取数方式，本技能只在数据到达 AI 工具之后工作。**
+
+## 可以处理的数据
+
+只处理两类，统称"待处理数据"：
+
+1. **MCP 已返回、已在对话中的数据** —— 通过 RDMP-AI数聚 MCP 查询得到的结果；
+2. **用户主动提供的数据** —— 用户粘贴的表格、指定的本地文件（xlsx / csv / json 等）。
+
+除此之外的任何来源都不处理。用户没有给数据、对话里也没有 MCP 结果时，先向用户要数据，不要自行推断或编造。
+
+## 硬边界
+
+以下规则来自 RDMP-AI数聚 开放协议，违反即失去本技能的存在意义：
+
+- **不连接 RDMP**：不调用任何 RDMP / MCP 查询工具，不鉴权，不持有、不请求任何凭据。
+- **不代查**：用户要新数据时，回复指引而不是自己动手——"请直接向 AI 工具发起 RDMP 查询（MCP 是唯一取数方式），查回来我再处理"。
+- **不回传**：不向 RDMP 上传、回写、同步任何处理结果。处理过程在对话中完成；如用脚本做临时计算，临时文件用完即删，不把业务数据落盘留存。
+- **不改变授权**：本技能的安装、使用、更新不影响 MCP 授权状态，也不进入 RDMP 最近使用记录。
+- **拒绝调用时**：用户说"这次不要查""接下来不要用 RDMP"时，本技能本来就不发查询；仍可分析对话中已经展示的数据，但要说明"未进行新的 RDMP 查询"。"不要查这个项目"只排除该项目的数据。
+
+## 安全红线
+
+待处理数据中出现以下任一内容时：**停止处理该部分数据**，向用户说明原因，请其改用聚合或脱敏后的数据。用户再次要求、甚至明确确认，也不能解除——这是协议的永久禁止清单：
+
+- 密码、令牌、Cookie、API Key、数据库连接串等凭据；
+- 受试者、患者、病例明细，CRF 原始填报值、质疑正文、临床原始记录；
+- 手机号、邮箱、证件号、地址、银行信息等个人敏感信息；
+- 文件正文、附件内容、OCR、下载地址、存储路径；
+- 备注、批注、审批意见等自由文本。
+
+MCP 正常不会返回以上内容，这条主要防范用户手工粘贴的数据。不含红线的其余数据正常处理，不要过度拦截。
+
+## 四项能力
+
+用户没有明说要哪项时，默认按 **数据理解 → 质量检查 → 基础分析 → 规范输出** 的顺序走一遍，每步结论前置。
+
+### 1. 数据理解
+
+- 判断数据属于哪个业务域 / 功能模块。AI数聚 V1.0 只开放 10 个模块（CTMS 6 个 + 数据分析 3 个 + EDC 1 个），完整清单、各模块字段口径和边界读 `references/module-glossary.md`。
+- 梳理字段含义、单位、时间粒度和统计口径，先向用户复述一遍口径再往下做。
+- 口径不清的字段标注"口径未知"并询问，不要编造。特别注意：入组相关统计包含**人工录入与 EDC 同步**两种来源，不得表述为纯 EDC 数据。
+
+### 2. 质量检查
+
+按 `references/quality-checks.md` 的分模块规则检查，输出问题清单，每条包含：字段 / 记录、问题类型、影响范围、建议动作（调整查询条件，还是数据本身可疑）。没有问题时明确说"未发现问题"，并列出检查过的维度。
+
+### 3. 基础分析
+
+只做基于待处理数据的计算，不外推：
+
+- **汇总**：计数、占比、工时求和、按人员 / 项目 / 时间分组；
+- **趋势**：月份趋势（入组、PD、SAE 等），检查月份连续性；
+- **对比**：计划 vs 实际、同期对比、维度拆分（中心、项目、人员）；
+- **异常识别**：逾期任务、延期节点、异常工时、入组延迟升高。
+
+指标公式以 `references/module-glossary.md` 的口径为准；RDMP 已算好的聚合指标（入组率、筛败率、脱落率等）直接引用返回值，不要用自造公式重算。数据不足以支撑结论时明说"数据不足"，不要硬给。
+
+### 4. 规范输出
+
+- 结论前置：第一句给结论 / 数字，过程和明细放后面。
+- **数据与分析分开**：RDMP 返回的原值直接呈现，不加推测；本技能计算或推断的部分明确标注为"分析"，不混入数据本身。
+- 表格呈现数值；本技能计算的指标用脚注标明口径（分母、时间范围、单位）。
+- 百分比保留 1 位小数；日期用 `YYYY-MM-DD`；缺失写"无数据"或"缺失"，不写 0。
+- 超过约 30 行的明细先聚合呈现，注明总条数；单页 MCP 上限 100 条，汇总前先确认是否覆盖全量。
+- 生成文件（报表 / 图表）时输出到用户指定位置或当前目录，并在对话中同步给出关键数字。
+
+## 处理 MCP 返回状态
+
+处理 MCP 结果时沿用协议的标准反馈语义：
+
+| 情况 | 处理方式 |
+| --- | --- |
+| 无结果 | "当前条件下没有符合的数据"，可建议调整条件，不编造 |
+| 部分成功 | 分开展示成功与失败模块，不把部分结果说成完整结果 |
+| 无权限 | 只说明当前无权查看，不推测不可见对象是否存在 |
+| 结果被分页截断 | 汇总前说明只覆盖已返回部分，提示可能不完整 |
+
+## 参考文件
+
+- `references/module-glossary.md` —— 10 个开放模块的能力、字段口径、指标定义与边界。做数据理解或计算指标前读。
+- `references/quality-checks.md` —— 通用检查 + 分模块质量检查规则。做质量检查前读。

package/.agents/skills/rdmp-data-skill/references/module-glossary.md

@@ -0,0 +1,60 @@
+# AI数聚 V1.0 开放模块口径表
+
+来源：《RDMP 开放协议规则 V1.0_PRD》第 3 章。层级定义：**业务域 → 功能模块 → RDMP 正式功能/页签 → 开放数据能力**。
+
+## 10 个开放模块
+
+| 业务域 | 功能模块 | 开放数据能力 | 必要边界 |
+| --- | --- | --- | --- |
+| CTMS | 项目计划管理 | 里程碑、阶段计划、完成情况、延期节点 | 项目维度；统计需时间 |
+| CTMS | 任务管理 | 任务列表、状态、统计、逾期、责任人任务 | 项目或人员维度；统计需时间 |
+| CTMS | 项目配置 | 项目基本信息、成员、角色、阶段 | 只读 |
+| CTMS | 审批管理 | 审批记录、状态、待审批、审批时效 | 只查询 |
+| CTMS | 项目文件管理 | 文件目录、名称、类型、版本、上传人、更新时间 | 只返回元数据 |
+| CTMS | 工时管理 | 工时记录、统计、人员工时、项目工时、异常工时 | 项目或人员维度；统计需时间 |
+| 数据分析 | 项目洞察 | 项目进度、健康度、风险概览及关键指标；入组与受试者进度、受试者状态汇总、PD 数据、SAE 数据（见下） | 仅项目级、中心级和月份趋势汇总 |
+| 数据分析 | Insight 看板 | 指标、趋势、维度拆分、同期对比 | 需指定指标、时间、维度与口径 |
+| 数据分析 | BI 看板 | 看板指标、图表数据、筛选结果、汇总 | 不开放底层 SQL 和配置 |
+| EDC | EDC 数据报表 | EDC 正式报表及其授权范围内的数据 | 报表、项目与筛选条件 |
+
+## 模块边界（做数据理解和分析时的红线）
+
+- 项目文件管理只有元数据，没有正文、附件内容、下载地址。
+- 项目配置只读；审批管理只查询——分析结论里不要出现"建议代为审批/撤回"之类的动作。
+- Insight / BI 不涉及底层 SQL、数据源配置和权限配置。
+- EDC 数据报表只含正式报表；不出现受试者/患者明细、CRF 原始填报值、质疑正文、临床原始值。
+- 项目洞察中的 EDC 相关数据仅指入组/受试者状态、PD、SAE/SUSAR 的**聚合指标**，不得下钻到受试者、表单或事件明细。
+- **入组相关统计包含人工录入与 EDC 同步两种来源**，任何表述不得说成"纯 EDC 数据"。
+
+## 项目洞察指标口径
+
+RDMP 返回的是已算好的聚合值，直接引用，不要用自造公式重算。验算或本地补算时按以下口径：
+
+| 指标 | 口径 |
+| --- | --- |
+| 入组率 | 实际入组数 ÷ 计划样本量 |
+| 计划完成率 | 实际入组数 ÷ 计划入组数 |
+| 入组延迟率 | 以 RDMP 返回口径为准，口径未知时先问 |
+| 筛败率 | 筛败人数 ÷ 总筛选人数 |
+| 脱落率 | 退出人数 ÷ 入组人数 |
+| 完成率 | 完成人数 ÷ 入组人数 |
+| 受试者状态汇总 | 总筛选、筛败、入组、退出、完成五项人数 + 对应率 |
+| PD 数据 | 轻微 / 重大 / 待定分类计数及总数；发生率以 RDMP 返回口径为准 |
+| SAE 数据 | 普通 SAE、SUSAR、SAE 总数及发生率 |
+
+## 常用判定规则
+
+- **逾期任务**：未完成，且当前日期 > 计划结束时间。
+- **里程碑延期**：已完成的，实际完成时间 > 计划完成时间；未完成的，当前日期已过计划完成时间。
+- **审批时效**：从提交到当前（待审批）或到审批完成的时间跨度。
+- **异常工时**：负数、单日超长（如 > 12h，阈值可按用户口径调整）、同一人同一天跨项目重复填报。
+
+## 请求与返回特征
+
+以下特征可用于识别"这是 MCP 查回来的数据"：
+
+- 请求是结构化的：`module_id` + `filters`（`project_ref` / `person_ref` / `status` 等）+ `pagination` + `sort`。
+- `person_ref: current_user` 表示当前用户自己的数据。
+- 项目和人员通过不透明 `entity_ref` 引用（如 `ref_7f92...`），不是数据库主键。
+- 明细接口单页最多 100 条；常见排序字段如 `planned_end_time`。
+- 无权限对象与不存在对象的反馈相同，无法区分。

package/.agents/skills/rdmp-data-skill/references/quality-checks.md

@@ -0,0 +1,74 @@
+# 质量检查规则库
+
+先跑通用检查，再按数据所属模块跑分模块检查。输出问题清单，格式：
+
+```text
+| # | 字段/记录 | 问题类型 | 说明 | 建议动作 |
+```
+
+问题类型从这些里选：缺失、重复、格式、范围、逻辑、口径、截断、一致性。
+建议动作区分两种：**调整查询条件重新取数**（数据没问题，取法有问题）或 **数据可疑**（需要用户回 RDMP 核实）。
+
+## 通用检查（所有模块先过一遍）
+
+- **完整性**：空值、空行、关键列（项目、时间、状态）缺失；缺失写"缺失"，不当作 0。
+- **截断**：结果是否正好 100 条（单页上限）或明显不全——汇总前必须说明覆盖范围。
+- **重复**：主键或业务键（任务编号、文件路径+版本、人+日期+项目）重复。
+- **格式**：日期是否可解析、数值列是否混入文本、单位是否一致。
+- **范围**：比例 / 率应在 0–100%；工期、工时不应为负。
+- **一致性**：汇总数 = 分项之和；占比之和 ≈ 100%（允许四舍五入误差并注明）。
+- **口径**：率的分母是什么、时间范围是什么——不清楚就列为口径问题，不要猜。
+
+## CTMS · 项目计划管理
+
+- 里程碑时间顺序：计划开始 ≤ 计划结束；阶段之间不应重叠出负区间。
+- 延期节点判定见 module-glossary.md「常用判定规则」；已完成与未完成分开统计。
+- 同一里程碑多次记录时，以最新状态为准并注明。
+
+## CTMS · 任务管理
+
+- 逾期 = 未完成 且 当前日期 > 计划结束时间；已完成任务不参与逾期统计。
+- 状态枚举是否合法（如 overdue 等以返回数据为准）；未知状态列为口径问题。
+- 责任人为空的任务单独列出。
+- `person_ref: current_user` 的数据只代表当前用户，不要推广成全员结论。
+
+## CTMS · 项目配置
+
+- 成员、角色、阶段清单与项目基本信息是否自洽（如角色有成员、阶段有起止）。
+- 只读数据，检查结论里不出现修改配置类建议。
+
+## CTMS · 审批管理
+
+- 待审批时长 = 当前时间 − 提交时间；审批时效 = 审批完成时间 − 提交时间。
+- 状态与时间逻辑一致：已审批的必须有审批完成时间，待审批的不应有。
+
+## CTMS · 项目文件管理
+
+- 只有元数据：目录、名称、类型、版本、上传人、更新时间。出现正文类字段即触发安全红线。
+- 同一路径下版本号重复或回退；更新时间早于上传时间的记录单独列出。
+- 文件类型与扩展名一致性。
+
+## CTMS · 工时管理
+
+- 异常工时：负数、单日超长、同一人同一天跨项目重复日期段。
+- 人员工时 / 项目工时汇总与明细记录之和核对。
+- 统计必须带时间范围；无时间范围的工时统计列为口径问题。
+
+## 数据分析 · 项目洞察
+
+- 率与绝对数互相验算（两者都返回时）：入组率 × 计划样本量 ≈ 实际入组数，误差超过四舍五入范围列为一致性问题。
+- 月份趋势的月份是否连续，缺月注明是"无数据"还是"未返回"。
+- 中心级数据按中心分组核对与项目级总数的关系（注意口径可能是进度快照，不一定可加）。
+- 只应有项目级 / 中心级 / 月份趋势聚合；出现受试者级行即触发安全红线。
+
+## 数据分析 · Insight / BI 看板
+
+- 同名指标在不同维度 / 时间段下口径是否一致（分母、是否含某类排除）。
+- 同期对比的两期时间长度是否可比（如 30 天 vs 31 天）。
+- 维度拆分之和与总计核对，差异注明口径还是数据问题。
+
+## EDC · EDC 数据报表
+
+- 只应是正式报表数据；核对报表名、项目与筛选条件与用户所述一致。
+- 筛选条件本身要记录在输出脚注里，保证结果可复述。
+- 出现受试者/患者明细、CRF 原始值、质疑正文即触发安全红线。

package/LICENSE

@@ -0,0 +1,18 @@
+RDMP-AI数聚 数据处理 Skill（rdmp-data-skill）
+版权所有 © 2026 蓝气球（北京）医学研究有限公司
+
+一、授予许可。在遵守本许可的前提下，任何获得本软件包副本的个人或组织（"你"）被免费授予以下权利：
+
+1. 安装、使用本软件包及其包含的数据处理 Skill（以下简称"本 Skill"）；
+2. 以未经修改的完整副本形式复制、分发本软件包。
+
+二、限制。
+
+1. 你不得移除或修改本软件包中的版权声明、许可声明或完整性校验信息（checksums.json）；
+2. 你不得以修改后的版本以原名重新分发，或以可能引起混淆的方式使用 "RDMP"、"AI数聚" 等名称；
+3. 本许可不授予任何商标权。
+4. 本 Skill 仅对使用者自行提供或经合法授权获得的数据进行本地处理，不提供对 RDMP 系统的访问能力。使用者应遵守其所在组织及适用法律（包括个人信息与人类受试者数据保护相关规定）对数据处理的要求。
+
+三、按"现状"提供。本软件包按"现状"和"现有"基础提供，不作任何明示或默示的保证，包括但不限于适销性、特定用途适用性和不侵权。在任何情况下，版权人均不对因使用本软件包而产生的任何索赔、损害或其他责任负责。
+
+（本许可文本为发布占位版本，正式发布前请由法务确认或替换为最终文本。）

package/README.md

@@ -1,3 +1,85 @@
-# Temporary Holding Version
+# RDMP-AI数聚 数据处理 Skill
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![npm version](https://img.shields.io/npm/v/rdmp-data-skill.svg)](https://www.npmjs.com/package/rdmp-data-skill)
+
+RDMP-AI数聚 的可选本地数据处理能力。统一对外版本：**AI数聚 V1.0**（与 skill 版本 1.0.0 对应）。
+
+> 分工原则：**MCP 是唯一取数方式，本 skill 只在数据到达 AI 工具之后工作。**
+> 本包不连接 RDMP、不发起查询、不鉴权、不持有任何凭据；安装与更新不影响 MCP 配置、凭据和授权有效期。
+
+## 四项能力
+
+| 能力 | 做什么 |
+| --- | --- |
+| 数据理解 | 识别数据属于哪个开放模块（CTMS 6 个 + 数据分析 3 个 + EDC 1 个），梳理字段口径与统计口径 |
+| 质量检查 | 完整性、一致性、时间逻辑、重复、分页截断、指标口径核对，输出带建议动作的问题清单 |
+| 基础分析 | 汇总统计、月份趋势、计划 vs 实际、同期对比、维度拆分、异常识别（逾期任务、延期节点、异常工时） |
+| 规范输出 | 结论前置、数据与分析分开、口径脚注、缺失不写 0、大表先聚合 |
+
+## 安装
+
+任选一条路线。安装完成后重启 AI 工具或新开会话即可生效；不安装本 skill 也可正常使用 MCP 查询 RDMP 数据。也可以直接把安装命令发给 AI 工具，由它执行。
+
+**路线一：skills CLI**（需要 [vercel-labs/skills](https://github.com/vercel-labs/skills) 支持的 AI 工具；`<owner>` 为官方 GitHub 组织名，以 RDMP「接入配置」页面展示的命令为准）
+
+```bash
+npx skills add <owner>/rdmp-data-skill            # 最新版
+npx skills add <owner>/rdmp-data-skill#v1.0.0     # 固定版本（# 指定 git tag）
+```
+
+注意：`skills` CLI 中 `@` 是"选择仓库内哪个 skill"，**不是版本号**；固定版本用 `#`。
+
+**路线二：npm 直装**（需要 Node.js ≥ 16；零依赖、不联网、安装前校验 SHA-256）
+
+```bash
+# 通用目录（ZCode 等，推荐）
+npx rdmp-data-skill install
+
+# 指定 AI 工具
+npx rdmp-data-skill install --target zcode    # ~/.zcode/skills/
+npx rdmp-data-skill install --target claude   # ~/.claude/skills/
+
+# 仅安装到当前项目
+npx rdmp-data-skill install --project
+
+# 更新（覆盖安装，不影响 MCP 授权）
+npx rdmp-data-skill install --force
+```
+
+## 输入 / 输出规范
+
+**只接受两类输入**：
+
+1. RDMP-AI数聚 MCP 已返回、已在对话中的数据；
+2. 用户主动提供的数据（粘贴的表格、本地 xlsx / csv / json 文件）。
+
+**输出遵循**：
+
+- 结论前置；RDMP 返回的原值直接呈现，不加推测；skill 计算或推断的部分明确标注为分析；
+- 本 skill 计算的指标用脚注标明口径（分母、时间范围、单位）；百分比 1 位小数；日期 `YYYY-MM-DD`；
+- 缺失写"无数据"或"缺失"，不写 0；超过约 30 行的明细先聚合呈现并注明总条数；
+- 处理过程不回传 RDMP，不进入 RDMP 最近使用记录。
+
+**安全红线（不可解除）**：待处理数据中出现凭据、受试者/患者明细、CRF 原始填报值、个人敏感信息、文件正文、审批意见等自由文本时，拒绝处理该部分数据。
+
+## 完整性与供应链
+
+- 安装器零依赖、不联网、不采集任何用户或设备信息；
+- 每个文件随包发布 SHA-256 清单（`checksums.json`），安装前强制校验，清单外文件一律拒装；
+- npm 制品按版本不可变；只提供当前正式版，不提供历史版本降级；
+- 可校验已安装包完整性：`node node_modules/rdmp-data-skill/bin/install.js --check-only`。
+
+## 版本对照
+
+| AI数聚 统一版本 | skill / npm 版本 |
+| --- | --- |
+| V1.0 | 1.0.0 |
+
+## 更多信息
+
+- 能力与边界详情见包内 `SKILL.md` 与 `references/`；
+- 在 RDMP 工作台顶栏「AI数聚」入口可获取 MCP 配置与本 skill 的最新安装方式。
+
+## 许可
+
+© 2026 蓝气球（北京）医学研究有限公司。见 [LICENSE](LICENSE)。

package/bin/install.js

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+/**
+ * RDMP-AI数聚 数据处理 Skill 安装器。
+ * 约束（来自 RDMP 开放协议 9.6）：不联网、不采集任何用户/设备信息、
+ * 不触碰 MCP 配置与授权；安装/更新 = 校验 SHA-256 后覆盖复制文件。
+ */
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const crypto = require('node:crypto');
+const os = require('node:os');
+
+const PKG_ROOT = path.resolve(__dirname, '..');
+const SKILL_DIR = path.join(PKG_ROOT, '.agents', 'skills', 'rdmp-data-skill');
+const SKILL_NAME = 'rdmp-data-skill';
+
+function usage() {
+  return `RDMP-AI数聚 数据处理 Skill 安装器 (v${pkgVersion()})
+
+用法:
+  npx rdmp-data-skill install [选项]
+
+选项:
+  --target <agents|zcode|claude>   安装目标（默认 agents）
+      agents   → ~/.agents/skills/${SKILL_NAME}/        （通用，ZCode 等推荐）
+      zcode    → ~/.zcode/skills/${SKILL_NAME}/
+      claude   → ~/.claude/skills/${SKILL_NAME}/
+  --project                        安装到当前目录 .agents/skills/ 下（仅本项目可用）
+  --path <dir>                     直接指定安装目录（将创建或覆盖该目录）
+  --force                          目标已存在时覆盖安装（更新即覆盖）
+  --check-only                     只校验包内文件 SHA-256，不安装
+  --version                        显示包版本
+  -h, --help                       显示本说明
+
+安装和更新不会改变 MCP 配置、凭据和授权有效期。`;
+}
+
+function pkgVersion() {
+  try {
+    return require(path.join(PKG_ROOT, 'package.json')).version;
+  } catch {
+    return 'unknown';
+  }
+}
+
+function fail(msg) {
+  console.error(`错误: ${msg}`);
+  process.exit(1);
+}
+
+function sha256(file) {
+  const h = crypto.createHash('sha256');
+  h.update(fs.readFileSync(file));
+  return h.digest('hex');
+}
+
+function walk(dir) {
+  const out = [];
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) out.push(...walk(full));
+    else if (entry.isFile()) out.push(full);
+  }
+  return out;
+}
+
+function loadManifest() {
+  const manifestPath = path.join(PKG_ROOT, 'checksums.json');
+  if (!fs.existsSync(manifestPath)) fail('缺少 checksums.json，包不完整，拒绝安装。');
+  return JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+}
+
+function verify() {
+  const manifest = loadManifest();
+  const problems = [];
+  for (const [rel, expected] of Object.entries(manifest.files || {})) {
+    const abs = path.join(PKG_ROOT, rel);
+    if (!fs.existsSync(abs)) {
+      problems.push(`${rel}: 文件缺失`);
+      continue;
+    }
+    const actual = sha256(abs);
+    if (actual !== expected) problems.push(`${rel}: SHA-256 不匹配（期望 ${expected}，实际 ${actual}）`);
+  }
+  // 反向检查：技能目录里的文件必须都在清单里，防止夹带未登记内容
+  for (const abs of walk(SKILL_DIR)) {
+    const rel = path.relative(PKG_ROOT, abs);
+    if (!(rel in (manifest.files || {}))) problems.push(`${rel}: 不在 checksums.json 清单中`);
+  }
+  if (problems.length) {
+    console.error('完整性校验失败:');
+    for (const p of problems) console.error('  - ' + p);
+    process.exit(1);
+  }
+  return manifest;
+}
+
+function copyTree(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const abs of walk(src)) {
+    const rel = path.relative(src, abs);
+    const target = path.join(dest, rel);
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    fs.copyFileSync(abs, target);
+  }
+}
+
+function parseArgs(argv) {
+  const opts = { action: 'install', target: 'agents', project: false, force: false, checkOnly: false, path: null };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === 'install') continue;
+    else if (a === '--target') opts.target = argv[++i];
+    else if (a === '--project') opts.project = true;
+    else if (a === '--path') opts.path = argv[++i];
+    else if (a === '--force') opts.force = true;
+    else if (a === '--check-only') opts.checkOnly = true;
+    else if (a === '--version') { console.log(pkgVersion()); process.exit(0); }
+    else if (a === '-h' || a === '--help') { console.log(usage()); process.exit(0); }
+    else fail(`未知参数: ${a}\n\n${usage()}`);
+  }
+  if (opts.target && !['agents', 'zcode', 'claude'].includes(opts.target)) {
+    fail(`无效的 --target: ${opts.target}（可选 agents / zcode / claude）`);
+  }
+  return opts;
+}
+
+function destDir(opts) {
+  if (opts.path) return path.resolve(opts.path);
+  if (opts.project) return path.join(process.cwd(), '.agents', 'skills', SKILL_NAME);
+  const home = os.homedir();
+  const roots = { agents: '.agents', zcode: '.zcode', claude: '.claude' };
+  return path.join(home, roots[opts.target], 'skills', SKILL_NAME);
+}
+
+function main() {
+  const opts = parseArgs(process.argv.slice(2));
+  if (!fs.existsSync(path.join(SKILL_DIR, 'SKILL.md'))) fail('包内缺少 SKILL.md，包不完整。');
+
+  const manifest = verify();
+  if (manifest.version && manifest.version !== pkgVersion()) {
+    fail(`checksums.json 版本(${manifest.version})与 package.json(${pkgVersion()})不一致，请先运行 npm run manifest。`);
+  }
+
+  if (opts.checkOnly) {
+    console.log(`完整性校验通过：${Object.keys(manifest.files).length} 个文件，SHA-256 全部匹配。`);
+    return;
+  }
+
+  const dest = destDir(opts);
+  if (fs.existsSync(dest) && !opts.force) {
+    fail(`目标目录已存在: ${dest}\n更新请加 --force 覆盖安装（不会影响 MCP 配置与授权）。`);
+  }
+
+  copyTree(SKILL_DIR, dest);
+
+  const files = walk(SKILL_DIR).map((f) => path.relative(SKILL_DIR, f));
+  console.log(`安装完成: RDMP-AI数聚 数据处理 Skill v${pkgVersion()}（AI数聚 V1.0）`);
+  console.log(`位置: ${dest}`);
+  for (const f of files) console.log(`  - ${f}`);
+  console.log('重启 AI 工具或新开会话后生效；本次安装不改变 MCP 配置、凭据和授权有效期。');
+}
+
+main();

package/bin/manifest.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+/**
+ * 生成 checksums.json：对技能目录内全部文件计算 SHA-256。
+ * 任何技能文件改动后、发布前都必须重新运行（npm run manifest）。
+ */
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const crypto = require('node:crypto');
+
+const PKG_ROOT = path.resolve(__dirname, '..');
+const SKILL_DIR = path.join(PKG_ROOT, '.agents', 'skills', 'rdmp-data-skill');
+const pkg = require(path.join(PKG_ROOT, 'package.json'));
+
+function walk(dir) {
+  const out = [];
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) out.push(...walk(full));
+    else if (entry.isFile()) out.push(full);
+  }
+  return out;
+}
+
+const files = {};
+for (const abs of walk(SKILL_DIR)) {
+  const rel = path.relative(PKG_ROOT, abs);
+  const h = crypto.createHash('sha256');
+  h.update(fs.readFileSync(abs));
+  files[rel] = h.digest('hex');
+}
+
+const manifest = {
+  name: pkg.name,
+  version: pkg.version,
+  aiShujuUnifiedVersion: (pkg.aiShuju && pkg.aiShuju.unifiedVersion) || null,
+  algorithm: 'sha256',
+  generatedAt: new Date().toISOString(),
+  files,
+};
+
+fs.writeFileSync(path.join(PKG_ROOT, 'checksums.json'), JSON.stringify(manifest, null, 2) + '\n');
+console.log(`checksums.json 已生成：${Object.keys(files).length} 个文件（版本 ${pkg.version}）。`);

package/checksums.json

@@ -0,0 +1,12 @@
+{
+  "name": "rdmp-data-skill",
+  "version": "1.0.0",
+  "aiShujuUnifiedVersion": "1.0",
+  "algorithm": "sha256",
+  "generatedAt": "2026-10-16T10:02:49.765Z",
+  "files": {
+    ".agents/skills/rdmp-data-skill/SKILL.md": "88b5480ad54f7b844088c2130472e8217b29b918c340077459b99aefbb03fe0c",
+    ".agents/skills/rdmp-data-skill/references/module-glossary.md": "ce35dcf2e3a0f52be0beef1766bb9e546748222b813ca868a84f27c762408332",
+    ".agents/skills/rdmp-data-skill/references/quality-checks.md": "08c9ece41c3af30d000e694e387c490255413f6243ba6d05df0a684180160a5b"
+  }
+}

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "rdmp-data-skill",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "RDMP-AI数聚 数据处理 Skill：对已获取的 RDMP 数据做本地处理，覆盖数据理解、质量检查、基础分析、规范输出。只处理用户提供或 MCP 已返回的数据，不连接 RDMP、不发起查询。",
+  "keywords": [
+    "rdmp",
+    "ai数聚",
+    "skill",
+    "agent-skills",
+    "skills",
+    "mcp",
+    "data-processing",
+    "ctms",
+    "edc",
+    "clinical-trial",
+    "claude-code",
+    "zcode"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "files": [
+    ".agents/skills/rdmp-data-skill",
+    "bin",
+    "checksums.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "rdmp-data-skill": "bin/install.js"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "scripts": {
+    "manifest": "node bin/manifest.js",
+    "verify": "node bin/install.js --check-only",
+    "prepublishOnly": "node bin/install.js --check-only"
+  },
+  "aiShuju": {
+    "product": "RDMP-AI数聚",
+    "unifiedVersion": "1.0",
+    "skillName": "rdmp-data-skill"
+  }
+}