@zeyue0329/xiaoma-cli 1.20.0 → 1.21.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@zeyue0329/xiaoma-cli",
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "XiaoMa Universal AI Agent Framework",
   "keywords": [
     "agile",

package/src/xmc-skills/2-plan-workflows/xiaoma-prd-clarify/README.md

@@ -0,0 +1,74 @@
+# xiaoma-prd-clarify · 使用与维护说明
+
+> 面向人的说明文档。Claude 执行时读 `SKILL.md` 与 `references/`，本文件不参与运行。
+
+## 这个 Skill 做什么
+
+以**资深研发视角**审视 PRD，系统识别其中的缺失、模糊、歧义、矛盾，产出结构化的《需求澄清问题清单》（含 P0 / P1 / P2 分级与待确认项），并对 PRD 的**可开发成熟度**量化评分。定位为"需求澄清助手 / 质量守门员"——只提问、不替产品臆测补全。
+
+## 何时被触发
+
+在公司内网 Claude Code / 小码（XiaoMa）框架中，研发承接需求、需求评审、开发前对齐等环节随需触发。常见触发语：PRD 澄清、需求澄清、需求评审、需求看不懂、这个需求不清楚、帮我看看这份 PRD、需求文档哪些没说清楚、字段取值 / 边界 / 逻辑不明确、需求准入评估、PRD 质量检查。也可显式调用，如"用 xiaoma-prd-clarify 帮我澄清这份需求"。
+
+## 怎么用
+
+1. 触发后，向它提供 PRD：上传文件、给出文件路径、或直接粘贴文本（支持 `.docx` / `.md` / `.pdf` / `.txt`）。
+2. 可选补充上下文：所属业务域、关联系统、已有数据字典或字段规范，以提升检查针对性。
+3. 它会按七维逐项扫描，输出澄清清单 + 成熟度评分，并逐条定位到 PRD 原文。
+4. 支持多轮：可针对某条目继续追问，或在补充产品答复后请求重新评估。
+
+## 目录结构
+
+```text
+xiaoma-prd-clarify/
+├── SKILL.md                      # 主指令：触发说明 + 工作流 + 关键约束
+├── README.md                     # 本文件：面向人的使用与维护指引
+├── references/
+│   ├── checklist.md              # 七维（A~G）检查清单规则库
+│   ├── scoring.md                # 可开发成熟度评分模型与权重
+│   └── output-template.md        # 澄清清单 + 评分报告输出模板
+├── examples/
+│   └── example-clarification.md  # 完整示例：PRD 片段 → 清单 + 评分
+└── scripts/
+    └── export_to_excel.py        # 可选：将澄清清单导出为 .xlsx（纯标准库，内网可用）
+```
+
+## 渐进式披露
+
+三层加载，避免 context 膨胀：
+
+1. **元信息**（`SKILL.md` frontmatter 的 `name` + `description`）常驻，用于判断是否触发。
+2. **`SKILL.md` 正文**在触发后加载，给出执行框架与关键约束。
+3. **`references/`** 下的检查清单、评分模型、输出模板，由 Claude 在对应步骤按需读取。
+
+## 如何维护规则（非开发人员也能改）
+
+- **加检查点**：把历史高频模糊点补进 `references/checklist.md`（对应维度下追加一条，写清"检查要点"）。
+- **调评分**：在 `references/scoring.md` 改维度**权重表**（保持合计 100%）、**标尺**或**准入门槛**。
+- **改输出**：在 `references/output-template.md` 调整字段与呈现格式。
+- **按业务域沉淀**：在 `checklist.md` 末节追加票据 / 信贷等专属检查片段。
+- 改完即生效，无需改动 `SKILL.md` 主流程。
+
+## 接入与试点
+
+**接入小码（XiaoMa）/ Claude Code：**
+
+- 随小码框架一同安装：随项目安装后，技能目录平铺到用户项目的 `.claude/skills/xiaoma-prd-clarify/`（`SKILL.md` + `references/` + `examples/` + `scripts/` 全部 verbatim 落地），无需额外配置。
+- 三种触发：① 自然语关键词自动触发（见"何时被触发"）；② 菜单码 `PC`（在 `xiaoma-help` 菜单中）；③ 显式调用，如"用 xiaoma-prd-clarify 帮我澄清这份需求"。
+- 输出语言默认中文；若项目 `_xiaoma/xmc/config.yaml` 配了 `communication_language` 则跟随。
+
+**试点方法（验证 P0 / P1 召回率 ≥ 80%）：**
+
+1. 选取若干份**真实**且已上线 / 已评审过的 PRD 作为样本。
+2. 由资深研发**人工**标注每份 PRD 的 P0 / P1 澄清点，作为基准答案。
+3. 对同一份 PRD 运行本技能，将其产出的澄清清单与人工基准比对，统计 P0 / P1 召回率与误报情况。
+4. 召回率达标即可推广；未达标时，把漏检的高频模糊点**回填进 `references/checklist.md`** 对应维度，迭代规则库后重测。
+5. 按业务域（票据 / 信贷等）分别试点，沉淀专属检查片段。
+
+## 安全与合规
+
+运行于公司内网 Claude Code 环境，PRD 文档不离开受控环境；本 Skill 不引入任何将文档内容外发至不受控外部服务的行为。导出脚本为纯标准库实现，无需联网或额外依赖。
+
+## 边界
+
+帮助开发更快读懂并澄清需求，**而非替产品经理编写或臆测补全 PRD**。无法从原文判断的内容，一律以"待确认提问"呈现。

package/src/xmc-skills/2-plan-workflows/xiaoma-prd-clarify/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: xiaoma-prd-clarify
+description: PRD 需求澄清技能——以资深研发视角审视产品需求文档(PRD),从业务逻辑、字段与数据、边界与异常、交互与显示、接口与集成、权限与安全合规、非功能性七个维度系统识别缺失、模糊、歧义、矛盾,生成带 P0/P1/P2 分级的结构化需求澄清问题清单,并对 PRD 的可开发成熟度评分。Use when the user wants to clarify, review, or assess a PRD before development —— 当用户提到 PRD 澄清、需求澄清、需求评审、需求看不懂、这个需求不清楚、帮我看看这份 PRD、需求文档哪些没说清楚、字段取值/边界/逻辑不明确、需求准入评估、PRD 质量检查。
+---
+
+# PRD 需求澄清（PRD Clarify）
+
+你是一位资深研发（senior engineer），以"如果现在就要按这份 PRD 写代码"的视角审视产品需求文档，系统性识别其中的**缺失、模糊、歧义、矛盾**，产出可定位、可回填的《需求澄清问题清单》，并对 PRD 的可开发成熟度量化评分。你**只提问、不臆测**，不替产品经理编写或补全 PRD。
+
+## 适用场景
+
+- 研发承接 PRD、需求评审准入、开发前对齐、PM 提交前自检。
+- **不适用：** 编写 / 臆测补全 PRD，或在缺乏原文依据时替产品做决定——这些一律转为"待确认提问"。
+
+## 根本准则
+
+对 PRD 的每个内容点自问：**"如果我现在就要按这份 PRD 写代码，我能不能下手？哪里下不了手、为什么？"** 凡会导致开发无法确定地写出实现的点，都识别为一条澄清问题。
+
+## Conventions
+
+- 引用文件以本 skill 根目录解析，**按需读取、不要一次性全部载入**：`references/checklist.md`（七维规则库）、`references/scoring.md`（评分模型）、`references/output-template.md`（输出模板）、`examples/example-clarification.md`（示例）。
+- 输出语言默认中文；若 `{project-root}/_xiaoma/xmc/config.yaml` 指定了 `communication_language` / `document_output_language`，则遵循之（读取失败不阻塞，回退中文）。
+
+## 执行流程
+
+1. **定位并读取 PRD。** 接受三种来源：用户上传的文件、指向的文件路径、直接粘贴的文本；支持 `.docx` / `.md` / `.pdf` / `.txt`（复用框架既有的文件读取与解析能力）。解析时**保留原文定位**（章节 / 段落 / 表格行 / 图号），确保每条问题可回溯出处。先通读一遍掌握整体结构与业务域；若缺少业务域、关联系统、已有数据字典等上下文，可向用户简要索取以提升针对性（非阻塞）。
+2. **逐维度检查。** 读取 `references/checklist.md`，按 A~G 七个维度**逐条核对**，识别四类问题：缺失 / 模糊 / 歧义 / 矛盾。逐维度、逐检查点扫描，不要跳维。
+3. **生成澄清条目并分级。** 为每个问题生成一条结构化条目（字段见 `references/output-template.md`），按 P0 / P1 / P2 判级，并简述判定依据。
+4. **可开发成熟度评分。** 读取 `references/scoring.md`，输出整体评分、A~G 各维度分项得分与短板说明、以及"是否达到可开发准入门槛"的结论与改进建议。
+5. **按模板输出。** 读取 `references/output-template.md`，在对话中结构化呈现《需求澄清问题清单》+《成熟度评分报告》；若用户需要，写出为 `.md` 文件归档，或调用 `scripts/export_to_excel.py` 导出 `.xlsx`。多版本管理交由 Git / 框架完成。
+
+## 检查方法
+
+- 以 `references/checklist.md` 为规则库基线，逐维度逐条核对；首次执行可参考 `examples/example-clarification.md` 校准输出粒度与风格。
+- 四类问题判别：**缺失**＝该说未说；**模糊**＝说了但不可执行（无取值 / 无规则）；**歧义**＝存在多种合理理解；**矛盾**＝前后或图文不一致。
+- 重点把关项：金额 / 利率 / 费用公式、取整与小数位、单位与币种、状态流转闭环、边界与异常、空值、并发与幂等。
+
+## 分级与评分方法
+
+- **P0 阻塞：** 不澄清则相关功能无法开始开发（如核心公式缺失、关键字段取值未定义）。
+- **P1 重要：** 影响主要逻辑或存在明显返工风险（如异常分支未定义、状态流转不完整）。
+- **P2 一般：** 边角或体验类（如个别提示文案、默认排序未说明）。
+- 分级须**可解释**——每条附简要判定依据。评分模型与维度权重见 `references/scoring.md`，可按团队 / 业务域配置。
+
+## 输出格式约束
+
+读取 `references/output-template.md` 并严格遵循其字段与结构：对话内默认以 Markdown 表格呈现澄清清单（精简列），并给出完整字段的可归档记录与评分报告。优先呈现 P0 / P1，避免低价值噪音淹没关键问题。
+
+## 核心原则与注意事项
+
+- 逐条定位到 PRD 原文出处（章节 / 段落 / 表格行 / 图号），并引用原文摘录。
+- 只提问、不臆测补全；无法从原文判断的，以"待确认项"呈现，不替产品做决定。
+- 金额 / 利率 / 取整、状态流转、边界与异常、空值与并发幂等为重点把关项。
+- 金融票据等强合规场景，对取值与边界保持额外审慎。
+
+## 多轮澄清
+
+支持用户针对某一条目继续追问、细化，或在补充信息（如产品答复、数据字典）后请求重新评估并刷新评分。

package/src/xmc-skills/2-plan-workflows/xiaoma-prd-clarify/examples/example-clarification.md

@@ -0,0 +1,61 @@
+# 示例：PRD 片段 → 澄清清单 + 评分
+
+用于校准输出粒度与风格。下面是一段含典型问题的 PRD 片段，以及按本 skill 应产出的澄清清单与评分报告。
+
+## 输入 PRD 片段（示意）
+
+```text
+3.2 放款金额计算
+放款金额 = 授信金额 × 比例。审核通过后系统自动放款。
+
+4.1 单据列表
+单据状态：待审核、审核中、已放款、已作废。
+列表支持按状态筛选。
+
+5.3 批量导入
+支持通过 Excel 批量导入放款申请。
+```
+
+## 输出：需求澄清问题清单（精简表）
+
+| 编号 | 章节定位 | 问题类型 | 等级 | 问题描述 | 澄清建议 / 待确认项 |
+| --- | --- | --- | --- | --- | --- |
+| Q1 | 3.2 放款金额计算 | 字段与数据 | P0 | 「比例」无取值范围与来源；金额是否取整、保留几位小数、币种均未定义，无法据此计算。 | 明确比例来源与取值范围；金额取整规则（建议保留 2 位小数、四舍五入）；币种。 |
+| Q2 | 3.2 放款金额计算 | 业务逻辑与流程 | P0 | 「审核通过后系统自动放款」未说明放款失败（如银行返回失败 / 超时）如何处理、状态如何流转。 | 明确放款失败 / 超时的处理与重试，失败后单据状态去向。 |
+| Q3 | 4.1 单据列表 | 交互与显示 | P1 | 状态枚举含「已作废」，但未说明进入条件；与 3.x 状态流转是否一致未知，疑似矛盾。 | 补充「已作废」的进入条件、能否在列表筛选、作废后能否恢复。 |
+| Q4 | 5.3 批量导入 | 边界与异常 | P1 | 未说明单次导入条数上限，及部分记录校验失败时的处理方式。 | 明确单批上限；失败记录策略（整批回滚 / 跳过失败项并返回失败清单）。 |
+| Q5 | 4.1 单据列表 | 交互与显示 | P2 | 列表默认排序字段与方向未说明。 | 明确默认排序（建议按创建时间倒序）。 |
+
+## 输出：某条目的完整记录（展开示例）
+
+```text
+### Q1 · P0 · 字段与数据
+- 章节定位：3.2 放款金额计算
+- 原文摘录：「放款金额 = 授信金额 × 比例」
+- 问题性质：模糊（缺取值与取整规则）
+- 问题描述：未说明比例的取值范围与来源，金额是否取整、保留几位小数、币种。
+- 澄清建议 / 待确认项：明确比例来源与范围；金额取整规则（建议保留 2 位小数、四舍五入）；币种。
+- 产品答复：
+- 状态：待确认
+```
+
+## 输出：可开发成熟度评分
+
+- 总体评分：**46 / 100** —— 结论：**未达准入**（存在 P0，须补充后重评）。
+- 维度得分：
+
+  | 维度 | 得分 | 短板说明 |
+  | --- | --- | --- |
+  | A 业务逻辑与流程 | 4/10 | 放款失败 / 自动放款异常分支缺失。 |
+  | B 字段与数据 | 3/10 | 核心金额公式取值、取整、币种全缺（P0）。 |
+  | C 边界与异常 | 4/10 | 批量导入上限与失败处理未定义。 |
+  | D 交互与显示 | 6/10 | 作废状态来源不清、默认排序缺失。 |
+  | E 接口与集成 | 5/10 | 放款依赖的外部银行接口未描述。 |
+  | F 权限与安全合规 | 5/10 | 放款 / 作废操作权限与留痕未说明。 |
+  | G 非功能性 | 6/10 | 导入数据量与性能未说明。 |
+
+- 问题统计：P0 2 条 · P1 2 条 · P2 1 条。
+- 改进建议（按优先级）：
+  1. （先 P0）补全放款金额计算的完整规则（比例来源 / 范围 / 取整 / 币种）。
+  2. （先 P0）定义自动放款的失败 / 超时分支与状态流转。
+  3. （再 P1）澄清「已作废」状态来源与批量导入的上限及失败策略。

package/src/xmc-skills/2-plan-workflows/xiaoma-prd-clarify/references/checklist.md

@@ -0,0 +1,99 @@
+# 七维需求澄清检查清单（A~G）
+
+本文件是 `xiaoma-prd-clarify` 的**规则库主体**，由 Claude 在执行"逐维度检查"步骤时按需读取。七个维度构成基线，可按业务域扩展（见末节）。
+
+## 如何使用本清单
+
+- **逐维度、逐检查点核对**：从 A 到 G 不跳维；每个检查点都对照 PRD 原文判断"是否说清、能否据此写代码"。
+- **四类问题判别**：
+  - **缺失**＝该说未说（检查点在 PRD 中找不到对应说明）；
+  - **模糊**＝说了但不可执行（无具体取值、无规则、无公式）；
+  - **歧义**＝存在多种合理理解；
+  - **矛盾**＝前后文、正文与原型 / 表格 / 状态图之间不一致。
+- **逐条定位**：每命中一条，记录其 PRD 出处（章节 / 段落 / 表格行 / 图号）与原文摘录。
+- **判级**：按 P0 / P1 / P2（判定准则见 `scoring.md`）。
+- 命中即生成一条澄清条目（字段见 `output-template.md`）；未命中不强行造问题，避免噪音。
+
+## A 业务逻辑与流程
+
+**核心关注：** 主流程是否完整闭环，异常与逆向路径是否覆盖。
+
+- 主流程（happy path）是否端到端描述清楚，每一步的输入、处理、输出是否明确。
+- **异常分支与逆向流程**：失败、驳回、撤销、退回、作废、超时等分支是否定义；能否回退、回退到哪一步。
+- **状态机**：是否列全所有状态、状态间的合法流转、每次流转的触发条件与操作人；是否存在到达不了或出不去的状态（死状态）。
+- **规则触发条件**：每条业务规则的生效前提、优先级、互斥 / 叠加关系是否说明；多规则冲突时如何裁决。
+- **跨系统 / 跨模块依赖**：流程是否依赖外部系统或上游数据；依赖不可用时如何处理。
+- **时序与先后约束**：步骤是否有强制先后顺序、并行可能、定时触发。
+
+## B 字段与数据
+
+**核心关注：** 每个字段能否被唯一确定地实现。
+
+- **基本属性**：类型、长度、精度（小数位）、是否必填、默认值是否逐字段说明。
+- **枚举穷尽**：枚举值是否列全、是否含"其他 / 未知"、各枚举的业务含义；枚举是否与状态流转、筛选项一致。
+- **计算公式**：金额 / 利率 / 费用 / 比例等公式是否给全；**取整规则、保留小数位、舍入方式（四舍五入 / 向下取整）、单位、币种**是否明确；中间值精度是否说明。
+- **字段来源**：派生 / 带出字段的数据来源、计算时机（实时 / 落库）、与源字段的同步规则。
+- **校验规则**：格式校验、值域校验、唯一性、关联校验、跨字段一致性校验是否定义；校验失败的提示与处理。
+- **数据字典对齐**：若已有数据字典 / 字段规范，PRD 字段定义是否与之一致。
+
+## C 边界与异常
+
+**核心关注：** 极端与异常情况是否覆盖。
+
+- **数值边界**：上下限、最小步长、是否含端点（开 / 闭区间）、超界处理。
+- **非法 / 越界取值**：负数、零、超出范围、错误格式等非法输入的拒绝与提示（如利率 / 比例为 0 或负、金额越界、日期早于今日）。
+- **空值与缺省**：null / 空字符串 / 0 / 未选择 的区分与各自表现。
+- **时间边界**：起止时间含否端点、时区、跨天 / 跨月 / 跨年、节假日、生效与失效时点。
+- **数据量与规模**：列表 / 导入 / 导出的条数上限、分页、超大数据量下的表现与降级。
+- **并发与幂等**：重复提交、并发修改同一数据、按钮重复点击的去重 / 加锁 / 幂等键；接口重试是否安全。
+- **失败与超时**：外部调用失败、超时、部分成功（批量中部分失败）的处理：整批回滚 / 跳过失败项并返回失败清单 / 重试。
+
+## D 交互与显示
+
+**核心关注：** 界面行为是否明确、图文是否一致。
+
+- **显隐 / 置灰 / 只读**：字段或按钮在不同状态 / 角色 / 条件下的可见性、可用性、可编辑性规则。
+- **联动**：字段间联动、级联选择、选项随上文变化的规则与默认。
+- **默认值与初始态**：进入页面 / 新建 / 编辑时各字段的默认值与默认选中。
+- **排序 / 筛选 / 分页**：默认排序字段与方向、可筛选项、分页大小。
+- **提示文案**：成功 / 失败 / 校验 / 二次确认 文案是否给出，还是仅写"给出提示"。
+- **图文一致**：正文描述与原型图 / 交互稿是否一致（字段、按钮、状态、布局），不一致处需澄清以哪个为准。
+
+## E 接口与集成
+
+**核心关注：** 系统间交互是否清晰可实现。
+
+- **上下游接口**：依赖哪些接口、谁提供、入参出参、字段映射是否给全。
+- **同步 / 异步**：调用方式、回调 / 轮询机制、异步结果如何回写与通知。
+- **幂等 / 重试 / 补偿**：接口幂等性、失败重试策略、补偿 / 对账机制。
+- **对账与一致性**：跨系统数据如何保证最终一致、对账周期与差异处理。
+- **协议与鉴权**：接口协议、鉴权方式、限流约定（如涉及）。
+
+## F 权限与安全合规
+
+**核心关注：** 谁能在什么条件下做什么、数据如何受控。
+
+- **功能 / 数据 / 操作权限**：各角色可见的功能、可访问的数据范围（行 / 列级）、可执行的操作是否说明。
+- **数据隔离**：多机构 / 多租户 / 多组织下的数据隔离与共享规则。
+- **审计留痕**：关键操作（创建、修改、审批、作废、导出）是否需要留痕及留痕内容。
+- **脱敏 / 加密**：敏感字段（证件、账号、金额等）的展示脱敏与存储加密要求。
+- **行业合规**：金融票据、信贷等场景的监管与合规要求（额度、风控、双录、留痕等）是否覆盖。
+
+## G 非功能性
+
+**核心关注：** 落地的工程约束是否说明。
+
+- **性能**：响应时间、吞吐、关键操作的性能预期。
+- **数据量与增长**：存量与增量规模、增长预估对方案的影响。
+- **兼容性**：浏览器 / 终端 / 版本兼容范围，新老数据兼容。
+- **数据迁移**：是否涉及存量数据迁移、迁移规则与回滚。
+- **可用性与回滚**：灰度、降级、回滚预案；故障时的业务表现。
+
+## 按业务域扩展规则
+
+七维为通用基线。可在不改主流程的前提下，向本文件追加业务域专属检查片段，例如：
+
+- **票据**：票据状态机（出票 / 背书 / 贴现 / 质押 / 提示付款 / 拒付）闭环、金额与到期日计算、要素一致性校验、监管留痕。
+- **信贷**：授信 / 用信 / 还款 的额度计算与占用释放、利率与计息规则、逾期与罚息、风控准入。
+
+> 维护方式：将历史高频模糊点沉淀为新的检查点，附"业务域 / 触发场景 / 检查要点"，持续提升识别准确率。

package/src/xmc-skills/2-plan-workflows/xiaoma-prd-clarify/references/output-template.md

@@ -0,0 +1,73 @@
+# 输出模板：澄清清单 + 评分报告
+
+由 Claude 在执行"按模板输出"步骤时按需读取。对话内默认用 Markdown 表格呈现；用户需要时写出为文件归档。
+
+## 澄清问题条目字段（完整记录）
+
+每条澄清问题包含以下字段，作为可归档 / 可流转 / 可回填的标准记录：
+
+| 字段 | 说明 |
+| --- | --- |
+| 编号 | 全局唯一，如 Q1、Q2…… |
+| 所属模块 / 章节定位 | PRD 中的章节号 + 标题，必要时到段落 / 表格行 / 图号 |
+| 原文摘录 | 触发问题的 PRD 原文片段（可截断，保留关键句） |
+| 问题类型 | A~G 七维之一 |
+| 问题性质 | 缺失 / 模糊 / 歧义 / 矛盾 |
+| 严重等级 | P0 / P1 / P2 |
+| 问题描述 | 哪里下不了手、为什么 |
+| 澄清建议 / 待确认项 | 需要产品确认什么；可给倾向性建议，但不替产品决定 |
+| 产品答复 | **留空**，供产品回填 |
+| 状态 | 待确认 / 已澄清 / 已关闭（默认待确认） |
+
+## 对话内呈现：精简表格
+
+对话中默认用精简列表格，先 P0 再 P1 再 P2，同级按章节先后：
+
+| 编号 | 章节定位 | 问题类型 | 等级 | 问题描述 | 澄清建议 / 待确认项 |
+| --- | --- | --- | --- | --- | --- |
+| Q1 | 3.2 放款金额计算 | 字段与数据 | P0 | …… | …… |
+
+> 当某条目需要展开时，再以"完整记录"字段呈现（含原文摘录、问题性质、产品答复、状态）。
+
+## 可归档记录（写出文件时）
+
+写出 `.md` 文件时，每条按完整字段成块呈现，便于产品逐条回填，例如：
+
+```text
+### Q1 · P0 · 字段与数据
+- 章节定位：3.2 放款金额计算（表格第 2 行）
+- 原文摘录：「放款金额 = 授信金额 × 比例」
+- 问题性质：模糊（缺取值与取整规则）
+- 问题描述：未说明比例的取值范围与来源，金额是否取整、保留几位小数、币种。
+- 澄清建议 / 待确认项：明确比例来源与范围；金额取整规则（建议保留 2 位小数、四舍五入）；币种。
+- 产品答复：
+- 状态：待确认
+```
+
+导出 Excel：调用 `scripts/export_to_excel.py`，将上面的精简表格写出为 `.xlsx`（详见 `scripts/` 说明）。
+
+## 评分报告结构
+
+澄清清单之后追加成熟度评分报告：
+
+```text
+## 可开发成熟度评分
+
+- 总体评分：NN / 100 —— 结论：达到准入 / 有条件准入 / 未达准入
+- 维度得分：
+  | 维度 | 得分 | 短板说明 |
+  | --- | --- | --- |
+  | A 业务逻辑与流程 | N/10 | …… |
+  | …… | …… | …… |
+- 问题统计：P0 n 条 · P1 n 条 · P2 n 条
+- 改进建议（按优先级）：
+  1. （先 P0）……
+  2. （再 P1）……
+```
+
+## 排序与呈现规则
+
+- 清单按 **P0 → P1 → P2** 排序，同级按 PRD 章节先后。
+- 每条**必须可定位原文**；不确定内容只作"待确认项"，不臆测补全。
+- 优先暴露 P0 / P1，避免被低价值 P2 噪音淹没。
+- **聚合条目须拆子问题**：若一条条目同时涉及多个子问题（如金额同时缺取整、币种、运费规则），在"问题描述"与"澄清建议 / 待确认项"中**逐一列出每个子问题**，避免产品回填时遗漏其中之一。

package/src/xmc-skills/2-plan-workflows/xiaoma-prd-clarify/references/scoring.md

@@ -0,0 +1,73 @@
+# 可开发成熟度评分模型
+
+由 Claude 在执行"可开发成熟度评分"步骤时按需读取。模型与权重均可在本文件中配置，便于按团队 / 业务域调整，**改文件即生效，无需改主流程**。
+
+## 评分总览
+
+- 对 PRD 输出一个 **0~100** 的整体"可开发成熟度"分数。
+- 由 A~G 七个维度的分项得分（各 0~10）按权重加权汇总得到。
+- 同时给出"是否达到可开发准入门槛"的结论。
+
+## 维度权重（可配置）
+
+下表为默认权重（合计 100%）。金融票据 / 信贷等强逻辑场景下，业务逻辑与字段数据权重最高，可按需调整。
+
+| 维度 | 名称 | 默认权重 |
+| --- | --- | --- |
+| A | 业务逻辑与流程 | 25% |
+| B | 字段与数据 | 25% |
+| C | 边界与异常 | 15% |
+| D | 交互与显示 | 10% |
+| E | 接口与集成 | 10% |
+| F | 权限与安全合规 | 8% |
+| G | 非功能性 | 7% |
+
+## 单维度评分标尺（0~10）
+
+| 分段 | 含义 |
+| --- | --- |
+| 9~10 | 该维度关键检查点基本说清，可直接据此开发，无 P0、至多个别 P2。 |
+| 7~8 | 主体清楚，存在少量 P1 或多个 P2，澄清后即可开发。 |
+| 4~6 | 存在多个 P1 或结构性模糊，需较多澄清与回填才能开发。 |
+| 1~3 | 关键信息大量缺失 / 矛盾，存在 P0，基本无法据此开发。 |
+| 0 | 该维度在 PRD 中几乎未涉及。 |
+
+> 硬约束：**任一维度只要存在 P0，该维度得分不高于 4 分**。
+
+## 总分计算
+
+总分 ＝ Σ（各维度得分 ÷ 10 × 该维度权重），结果四舍五入到整数，范围 0~100。
+
+> **计算纪律**：总分必须先给出 A~G 各维度分项得分，再用上式逐项加权现场算出，并展示加权过程；**不得先凭整体印象给一个总分**，避免分数漂移。
+
+> 示例：A=6、B=4、C=5、D=8、E=7、F=8、G=8，按默认权重
+> ＝ 6/10×25 + 4/10×25 + 5/10×15 + 8/10×10 + 7/10×10 + 8/10×8 + 8/10×7
+> ＝ 15 + 10 + 7.5 + 8 + 7 + 6.4 + 5.6 ＝ **59.5 → 60**。
+
+## 可开发准入门槛
+
+| 总分 | 且 | 结论 |
+| --- | --- | --- |
+| ≥ 85 | 无 P0 | **达到准入**：可直接进入开发。 |
+| 70 ~ 84 | 无 P0 | **有条件准入**：先澄清全部 P0 / P1 再开工。 |
+| < 70 或 | 存在任一 P0 | **未达准入**：补充后重新评估。 |
+
+## P0 / P1 / P2 判定准则
+
+- **P0 阻塞**：不澄清则相关功能无法开始开发——核心公式 / 关键字段取值 / 主流程关键分支缺失或矛盾。
+- **P1 重要**：影响主要逻辑或有明显返工风险——异常分支未定义、状态流转不完整、重要校验缺失。
+- **P2 一般**：边角或体验类——个别提示文案、默认排序、非关键默认值未说明。
+- 每条分级须附**简要判定依据**（为什么是这个级别）。
+
+## 评分报告应包含
+
+1. **整体成熟度评分**（NN/100）与准入结论（达到 / 有条件 / 未达）。
+2. **各维度分项得分**（A~G，各 N/10）与**短板说明**（该维度主要缺什么）。
+3. **改进建议**：按"先 P0 后 P1"的优先级，给出最能提升可开发性的若干项。
+4. **问题统计**：P0 / P1 / P2 各多少条。
+
+## 配置说明
+
+- 调整**权重表**即可改变各维度对总分的影响（保持合计 100%）。
+- 调整**标尺**或**门槛**可适配不同团队对"可开发"的尺度要求。
+- 业务域专属的加严规则（如票据对金额 / 到期日 0 容忍）可在此追加说明。

package/src/xmc-skills/2-plan-workflows/xiaoma-prd-clarify/scripts/export_to_excel.py

@@ -0,0 +1,156 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""将《需求澄清问题清单》的 Markdown 表格导出为 .xlsx。
+
+纯 Python 标准库实现（仅用 zipfile / xml），无需 openpyxl 或联网，
+适配公司内网 / 信创环境。
+
+用法:
+    python3 export_to_excel.py 清单.md                 # 输出 清单.xlsx
+    python3 export_to_excel.py 清单.md -o 澄清清单.xlsx
+    cat 清单.md | python3 export_to_excel.py -          # 从标准输入读取
+
+行为:
+    读取输入中的第一张 Markdown 表格（以 | 分隔的行），
+    将其原样写入一个 .xlsx 工作表（单元格用 inlineStr，兼容 Excel / WPS / LibreOffice）。
+"""
+
+import argparse
+import os
+import re
+import sys
+import zipfile
+
+_SEP_CELL = re.compile(r"^:?-+:?$")
+
+
+def parse_markdown_table(text):
+    """从文本中提取第一张 Markdown 表格，返回二维字符串列表（含表头行）。"""
+    rows = []
+    in_table = False
+    for raw in text.splitlines():
+        line = raw.strip()
+        if line.startswith("|"):
+            in_table = True
+            cells = [c.strip() for c in line.strip("|").split("|")]
+            # 跳过分隔行，如 | --- | :--: |
+            if cells and all(_SEP_CELL.match(c or "-") for c in cells):
+                continue
+            rows.append(cells)
+        elif in_table:
+            # 表格结束（遇到第一张表之后的非表格行）
+            break
+    return rows
+
+
+def _col_letter(idx):
+    """0 -> A, 25 -> Z, 26 -> AA ..."""
+    letters = ""
+    idx += 1
+    while idx:
+        idx, rem = divmod(idx - 1, 26)
+        letters = chr(65 + rem) + letters
+    return letters
+
+
+def _xml_escape(value):
+    return (
+        str(value)
+        .replace("&", "&")
+        .replace("<", "&lt;")
+        .replace(">", "&gt;")
+        .replace('"', "&quot;")
+        .replace("'", "&apos;")
+    )
+
+
+def _build_sheet_xml(rows):
+    parts = [
+        '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>',
+        '<worksheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main">',
+        "<sheetData>",
+    ]
+    for r_idx, row in enumerate(rows, start=1):
+        parts.append('<row r="%d">' % r_idx)
+        for c_idx, cell in enumerate(row):
+            ref = "%s%d" % (_col_letter(c_idx), r_idx)
+            text = _xml_escape(cell)
+            parts.append(
+                '<c r="%s" t="inlineStr"><is><t xml:space="preserve">%s</t></is></c>'
+                % (ref, text)
+            )
+        parts.append("</row>")
+    parts.append("</sheetData></worksheet>")
+    return "".join(parts)
+
+
+_CONTENT_TYPES = (
+    '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+    '<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">'
+    '<Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>'
+    '<Default Extension="xml" ContentType="application/xml"/>'
+    '<Override PartName="/xl/workbook.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml"/>'
+    '<Override PartName="/xl/worksheets/sheet1.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml"/>'
+    "</Types>"
+)
+
+_ROOT_RELS = (
+    '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+    '<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">'
+    '<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="xl/workbook.xml"/>'
+    "</Relationships>"
+)
+
+_WORKBOOK = (
+    '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+    '<workbook xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" '
+    'xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">'
+    '<sheets><sheet name="澄清清单" sheetId="1" r:id="rId1"/></sheets>'
+    "</workbook>"
+)
+
+_WORKBOOK_RELS = (
+    '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
+    '<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">'
+    '<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet" Target="worksheets/sheet1.xml"/>'
+    "</Relationships>"
+)
+
+
+def write_xlsx(rows, out_path):
+    sheet_xml = _build_sheet_xml(rows)
+    with zipfile.ZipFile(out_path, "w", zipfile.ZIP_DEFLATED) as zf:
+        zf.writestr("[Content_Types].xml", _CONTENT_TYPES)
+        zf.writestr("_rels/.rels", _ROOT_RELS)
+        zf.writestr("xl/workbook.xml", _WORKBOOK)
+        zf.writestr("xl/_rels/workbook.xml.rels", _WORKBOOK_RELS)
+        zf.writestr("xl/worksheets/sheet1.xml", sheet_xml)
+
+
+def main(argv=None):
+    parser = argparse.ArgumentParser(description="将需求澄清清单的 Markdown 表格导出为 .xlsx")
+    parser.add_argument("input", help="输入的 Markdown 文件路径；用 - 表示从标准输入读取")
+    parser.add_argument("-o", "--output", help="输出的 .xlsx 路径（默认与输入同名）")
+    args = parser.parse_args(argv)
+
+    if args.input == "-":
+        text = sys.stdin.read()
+        default_out = "clarification.xlsx"
+    else:
+        with open(args.input, "r", encoding="utf-8") as fh:
+            text = fh.read()
+        default_out = os.path.splitext(args.input)[0] + ".xlsx"
+
+    rows = parse_markdown_table(text)
+    if not rows:
+        sys.stderr.write("未在输入中找到 Markdown 表格（以 | 分隔的行）。\n")
+        return 1
+
+    out_path = args.output or default_out
+    write_xlsx(rows, out_path)
+    sys.stdout.write("已导出 %d 行到 %s\n" % (len(rows), out_path))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/src/xmc-skills/module-help.csv

@@ -18,6 +18,7 @@ XiaoMa Method,xiaoma-product-brief,Create Brief,CB,An expert guided experience t
 XiaoMa Method,xiaoma-prfaq,PRFAQ Challenge,WB,Working Backwards guided experience to forge and stress-test your product concept to ensure you have a great product that users will love and need through the PRFAQ gauntlet to determine feasibility and alignment with user needs. alternative to product brief.,,-H,1-analysis,,,false,planning_artifacts,prfaq document
 XiaoMa Method,xiaoma-prd,Create Edit and Review PRD,PRD,"Facilitated PRD workflow — create a new PRD via coached discovery, update an existing one against a change signal, or validate a finished PRD against a checklist with an HTML findings report.",,,2-planning,xiaoma-product-brief,,true,planning_artifacts,prd
 XiaoMa Method,xiaoma-ux,Create UX,CU,"Guidance through realizing the plan for your UX, strongly recommended if a UI is a primary piece of the proposed project.",,,2-planning,xiaoma-prd,,false,planning_artifacts,ux design
+XiaoMa Method,xiaoma-prd-clarify,Clarify PRD,PC,"以资深研发视角审视 PRD，从七个维度识别缺失/模糊/歧义/矛盾，生成带 P0/P1/P2 分级的需求澄清问题清单并对可开发成熟度评分。用于研发承接需求、需求评审准入、开发前对齐。",,,2-planning,xiaoma-prd,,false,planning_artifacts,clarification list and maturity score
 XiaoMa Method,xiaoma-create-architecture,Create Architecture,CA,Guided workflow to document technical decisions.,,,3-solutioning,,,true,planning_artifacts,architecture
 XiaoMa Method,xiaoma-create-epics-and-stories,Create Epics and Stories,CE,,,,3-solutioning,xiaoma-create-architecture,,true,planning_artifacts,epics and stories
 XiaoMa Method,xiaoma-check-implementation-readiness,Check Implementation Readiness,IR,Ensure PRD UX Architecture and Epics Stories are aligned.,,,3-solutioning,xiaoma-create-epics-and-stories,,true,planning_artifacts,readiness report