@v587d/capital-generation 2.7.8 → 2.7.9

package/preset/capital-generation/agent.patch.yml

@@ -250,6 +250,7 @@
                 不读文件、不碰 capital-data 下的任何路径（那是原始行与 Dataset 的边界）；
                 时间窗仍优先 resolve_data_time_range，不自行把日期算成毫秒。
                 输出只留结论数字（原始行与中间数据不进回传），并注明算法与口径。
+                输入只敲标量（≤20 个）、逐数核对再算，不整行复制。
 
               toolFilter:
                 allow:

package/preset/capital-generation/skills/capital-data-protocol/SKILL.md

@@ -269,6 +269,10 @@ node -e 'const a=98.2,b=120.5; console.log(((b-a)/a*100).toFixed(2))'   # 区间
 python3 -c "print((120.5/98.2)**(252/60)-1)"                            # 年化
 ```
 
+- **只敲最终参与计算的标量，一次 ≤20 个**：不整行/整表复制原始数字进脚本（2026-10-10 真机：
+  两次 bash 把整段聚合行逐数敲进去，转写出笔误又花 7.2K 字符发更正）；从工具回执到脚本的每个
+  数字**逐一核对**再执行，算完抽查 1-2 个对得上来源。要算的数超过 20 个就拆几批。
+
 **不许做的**（这是纪律，不是沙箱限制——沙箱只拦写，不拦读与网络）：
 
 | 不许 | 为什么 | 正确做法 |

package/preset/capital-generation/skills/capital-equity-research/SKILL.md

@@ -16,7 +16,7 @@ description: Use when the user requests a complete research report or comprehens
 
 ## 2. 证据计划：完整覆盖，按需取证
 
-先列出要回答的核心问题和最小证据集，按对结论的影响排序：先核对最近可得财报、必要的结构化财务与行情、最相关的公司公告，再决定同业、行业或更早历史是否真的会改变判断。缺关键证据时优先核对该缺口，而不是继续扩展边缘材料；重复的时间序列或同一份文件不重复获取。下表是报告的覆盖检查表，不是工具调用配额。
+先列出要回答的核心问题和最小证据集，按对结论的影响排序：先核对最近可得财报、必要的结构化财务与行情、最相关的公司公告，再决定同业、行业或更早历史是否真的会改变判断。缺关键证据时优先核对该缺口，而不是继续扩展边缘材料；重复的时间序列或同一份文件不重复获取。下表是报告的覆盖检查表，不是工具调用配额。委派外部事实核查同样按影响分级：核心事实（审计意见、商誉、质押、现金流背离等）≤10 条逐条核验，外围事实一句话清单，异常线索触发才深挖（口径见 `capital-web-protocol` §5）。
 
 | 维度 | 最少回答什么 | 主要证据与不能越过的边界 |
 |---|---|---|

package/preset/capital-generation/skills/capital-orchestration/SKILL.md

@@ -100,6 +100,11 @@ A 角色的请求投给 B 角色。官方机制是 **`list_agents` 即权威 id
 - 多个角色都要时并行委派，但每个角色都必须先按第 2 节复用或创建，各记清单，等结算通知齐了再综合
   （齐不齐按 §6.1 的对账表逐行判定，不靠"看起来都回了"）。
 - 主 Agent 给 collector 的问题写清标的、时间范围、证据用途和所需新鲜度，由 collector 按实际目录选足相关能力，不预设“只取一个”或固定上限。
+- 给 `web_retriever` 的事实核查委派**分级写需求**：核心事实（直接改变结论或风险判断的——审计意见、
+  商誉、质押/担保/资金占用、现金流与利润背离、有息负债、再融资/重组等）≤10 条逐条核验、每条一行
+  来源；外围事实（分红方案、互动平台问答、媒体花絮）一句话清单即可。不预设"每条 URL+日期+原文/
+  转述双分类"的审计级格式；发现质押、商誉、现金流异常再对该项深挖（回传格式同口径，见
+  `capital-web-protocol` §5）。
 - 主 Agent 不自行调用任何网络检索/抓取/搜索类工具；外部检索入口只有 `web_retriever` 的回传。
 - 三个已定义角色禁止用通用 `subagent` 创建替代实例；通用委派只用于本 preset 没有专用角色的
   新任务，且同样必须先做本轮预检。

package/preset/capital-generation/skills/capital-visualization-protocol/SKILL.md

@@ -122,9 +122,9 @@ prepare_chart_source({ dataset_id, task_id })
 
 只使用工具返回的 `chart_source_ref`。不要自己构造 token、路径或 `raw.json` 地址。
 
-**一张图一个 token，且 token 有 15 分钟 TTL**：先定好要出哪几张图、每张用哪份 Dataset，
-再一次性签发；**不要**因为改了视图方案就为同一个 dataset 重签（实测代价：多花 8.3K 字符思考，
-还把剩下的窗口压得更短）。
+**token 有 15 分钟 TTL，同一 task_id + dataset_id 重复签发幂等返回同一个 token**：仍建议先定好
+要出哪几张图、每张用哪份 Dataset，再一次性签发（省往返）；万一改了视图方案再签一次也无妨——
+工具层已保证不会签出第二个 token（2026-10-10 前的版本会重签并浪费一轮大思考）。
 
 传给 visualization_specialist 的内容只能包括：
 
@@ -145,12 +145,12 @@ prepare_chart_source({ dataset_id, task_id })
 
 **分工硬规则：spec 由 specialist 组装，data_junior 只交"要什么视图"。** `kind` / `x` / `series` /
 `markers` / `title` 的取值由 specialist 读 `capital-chart-protocol` 决定；data_junior 的 prompt 只写
-视图角色（主视图/辅助视图）、目标窗口与关心的字段名。实测偏离这条要付两笔账：一次 8.3K 字符的
-思考（在替 specialist 算 spec 与标记位置），以及为同一个 dataset 重签 token。
+视图角色（主视图/辅助视图）、目标窗口与关心的字段名。实测偏离这条要付一笔大账：一次 8.3K 字符的
+思考（在替 specialist 算 spec 与标记位置）。
 
-**协议排除的视图要记为 limitation，不要改方案重签。** 需要"归一化对比 / 多源叠加"（例如个股与
+**协议排除的视图要记为 limitation，不要改方案。** 需要"归一化对比 / 多源叠加"（例如个股与
 指数同图）时：当前能力不支持，按"图表跟着 Dataset 一对一"拆成各自独立的单源图，并在回传的
-`warnings` 里写明「归一化叠加对比不支持，已拆为 N 张单源图」。不要为此重新 `prepare_chart_source`，
+`warnings` 里写明「归一化叠加对比不支持，已拆为 N 张单源图」。不要为此重新规划整套图，
 也不要自造归一化序列。
 
 ## 3. visualization_specialist 选图规则

package/preset/capital-generation/skills/capital-web-protocol/SKILL.md

@@ -123,7 +123,14 @@ Wind 结构化查询同样是**花积分的**：先看 `data_collector` 的免
 
 ## 5. 回传格式（每条证据都要有来源）
 
-- 回传的证据/情报逐条编号（情报1、情报2……），编号后紧跟来源标注。
+- **核查分级，不是每条都审计级**（2026-10-10 真机：逐条 URL+日期+双分类的全量核验产出 18 条情报、
+  39K 输出 tokens，拖慢主结论）：**核心事实**——直接影响结论或风险判断的（审计意见、商誉、
+  质押/担保/资金占用、现金流与利润背离、有息负债、再融资/重组、被监管调查等）——逐条编号、
+  每条一行来源，一般 ≤10 条；**外围事实**（分红方案、互动平台问答情况、媒体花絮等不改变判断的）
+  合并成一句话清单，来源在清单末一次性标注即可，不逐条取原文、不逐条贴 URL+日期。
+- **深挖只在触发时做**：核心事实里出现质押、商誉减值、现金流恶化、审计非标等异常线索，
+  才对该单项升级为公告全文级核验；不要开局就把全部条目按审计标准核一遍。
+- 回传的核心证据/情报逐条编号（情报1、情报2……），编号后紧跟来源标注。
 - 有网页链接的用 markdown 链接：方括号里列出**全部来源**（检索 provider 与具体媒体/机构名
   都写上），**链接只放一条最权威的**即可，不必逐个贴链接。示例：
   `情报1：公司今日召开临时股东会审议借款议案。[AnySearch, 新浪财经, 证券之星](https://…)`
@@ -132,8 +139,8 @@ Wind 结构化查询同样是**花积分的**：先看 `data_collector` 的免
   `wind_docs` 返回体内自带链接字段时可用那个链接；**不得编造链接**。
 - 来源标注要区分：候选来源（搜索摘要，未点开）、已获取正文（fetch 过）、wind_docs 官方文档
   （来源：Wind）。**无来源的信息不得作为证据回传**；不编造来源。
-- 失败项与未核验项同样编号列出并注明原因，不与已证实证据混排；同一来源服务多条情报时逐条
-  重复标注，不要用"同上"。
+- 失败项与未核验项同样编号列出并注明原因，不与已证实证据混排；核心事实同一来源服务多条时逐条
+  重复标注，不要用"同上"（外围清单可整段合标）。
 - 主 Agent 向用户呈现时保留这些来源标注；网页数字只能标"媒体转述旁证"。
 - `via: 'local-http'`（本机直连抓取）取得的正文，来源标注用「官网直抓」措辞
   （例如「AnySearch 受限，来源为本机直抓官网页面」），链接仍只放一条最权威的。

package/selected-skills/catalog.js

@@ -20,6 +20,11 @@ export const SELECTED_SKILL_SKILL_DIRS = Object.freeze({
   // 上游就是扁平的 skills/<name>/SKILL.md（48 颗一层到底，frontmatter name 与目录名逐颗一致，
   // 正文链接全部落在自己目录内），所以前六颗踩过的套一层 / 平铺 / 多根取一都不用做。
   financeskills: 'skills',
+  // 第八颗（Howard-Jerry/quant-agent-skills）：上游把三颗 skill 直接放在**仓库根**，而这三颗都是
+  // 自述的编排器、正文指挥公开版不附带的私有数据层，一颗都不能进可选清单（判据见该快照 UPSTREAM.md）。
+  // 快照因此另起一个 skills/ 根，里面只放本仓自持的那一颗入口；上游三颗完整住在 git、由快照自己的
+  // .npmignore 挡在发布包之外，provider 的 skills 根里根本没有它们，list()/get() 也谈不上过滤。
+  'quant-agent-skills': 'skills',
 })
 
 // Selected-skill metadata owned by Capital Generation. Upstream snapshots remain unchanged.
@@ -1299,6 +1304,29 @@ export const SELECTED_SKILL_CATALOG = Object.freeze([
       en: 'Cold-start experiment; upstream last moved on 2026-10-01, so review the sources before use. Only the first-digit test can run on published statements; the rest of this skill\u0027s paths — bank statements, employee-versus-vendor matching, internal ERP systems — require the user to supply the accounting detail, since this plugin connects to no corporate system and holds no such source. What it returns is a list of leads, not a fraud finding, and neither an audit nor a legal opinion; a Benford test on too small a sample is void, and the sample thresholds in the text stand.',
     },
   },
+  // 第八颗（Howard-Jerry/quant-agent-skills）：上游三颗正文都是自述的**编排器**、且指挥公开版
+  // 根本不附带的私有数据层（实测三颗 SKILL.md 点名的本地路径一个都不在仓里），一颗都不进可选清单；
+  // 逐条判据与 132 处闸门命中的分布见该快照 UPSTREAM.md。这里开放的是本仓自持的一颗入口，
+  // 它只挂载上游那两份零执行面、零私有引用的跨市场选线口径（逐字复制，非改写）。
+  {
+    key: 'crossMarketListingChoice',
+    name: 'cross-market-listing-choice',
+    label: { zh: '跨市场选线（A/H · ADR/HK）', en: 'Cross-Market Listing Choice' },
+    description: {
+      zh: '同一家公司在多个市场各有上市线时，选一条来持有、加仓或观察：A/H 溢价与币种股息税、流动性与通道、ADR 换算比例与披露文件路径。公司层面只研究一次——A 与 H 是同一家公司的两条线，变的只有价差、税、币种和你能不能买到。',
+      en: 'Picks which listing of a single issuer to hold, add, or watch: A/H premium and currency/dividend withholding, liquidity and channel access, ADR conversion ratios and filing paths. The company is researched once — A and H are two lines of the same business, so what changes is spread, tax, currency and whether you can reach it.',
+    },
+    owner: 'Howard-Jerry',
+    repository: 'quant-agent-skills',
+    status: 'watchlist',
+    lastCommit: '2026-08-05',
+    reviewBy: '2026-11-15',
+    tags: ['a-share', 'us-stock', 'portfolio', 'risk'],
+    riskNote: {
+      zh: '冷启动实验：上游五次提交全落在 2026-08-05 同一天，之后无维护，作者声明正文来自其私有量化系统（数据层尚未开源）。这颗只做选线，不重做公司研究——公司本身的结论交给既有研究路径。本插件没有现成的 A/H 溢价或 ADR 平价条目：溢价必须由两条线同一 as-of 交易日的收盘价加上当日汇率现算，这三项任一项取不到就不给溢价数字，只报告缺哪一项；汇率条目按次消耗上游积分，凭据缺失、限流与后端错误一律不重试，也不许用记忆里的近似汇率补数。本插件不持有使用者的成交账本，持仓与成本价只能按你在对话里当场给出的信息回答，回答完就放下，不持久化。价差是当天的事实，"折价的那条线会涨回来"不是这颗的结论，历史价差区间只是参照、不是目标。本插件不提供交易执行界面，不构成投资建议，动哪条线与动多少由使用者自己决定并自己执行。',
+      en: 'Cold-start experiment: all five upstream commits landed on 2026-08-05 with nothing since, and the author states the text comes from a private quant system whose data layer is not yet open. This skill only picks a listing — it never re-runs the company research, which stays with the existing paths. This plugin has no ready-made A/H premium or ADR parity entry: the premium must be computed from both lines\u0027 closes on the same as-of trading day plus that day\u0027s FX, and if any of the three is missing you report which one instead of publishing a premium. FX entries consume upstream quota; missing credentials, throttling and backend errors are never retried, and an approximate rate from memory is not a substitute. This plugin holds no user trade ledger — position and cost basis can only be answered from what the user states in the conversation, and nothing is persisted. A spread is a same-day fact; "the cheaper line will converge" is not a conclusion of this skill, and a historical range is a reference, not a target. No trading interface is provided and nothing here is investment advice: which line to take, and how much, stays with the user.',
+    },
+  },
 ])
 
 export const SELECTED_SKILL_TAG_LABELS = Object.freeze({

package/selected-skills/quant-agent-skills/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jerry Wang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/selected-skills/quant-agent-skills/UPSTREAM.md

@@ -0,0 +1,111 @@
+# Upstream Record
+
+- Project: Quant Agent Skills（三颗**自述为编排器**的量化研究 skill：`concept-research` 概念/题材、
+  `industry-research` 行业、`stock-research` 个股；A 股 / 港股 / 美股三市场分册 + A/H 与 ADR/HK 两条 overlay）
+- Repository: https://github.com/Howard-Jerry/quant-agent-skills
+- Upstream commit: `03677d216320f7f80ebf1f4d6d3106d41f72d333`（main，2026-08-05 20:27 +0800，作者 Jerry Wang）
+  - **全仓五次提交，全部落在 2026-08-05 同一天**（`f65c549` v1.0.0 → `03677d2` examples）。无 release、无 tag、无 CI。
+  - 上游 README 与 `docs/adaptation-guide.md` 自己写明：正文来自作者的**本地私有 SSoT**，经
+    `scripts/publish.sh` 同步发布，数据层（`collect-data`、候选队列）要到 **v1.1 才开源**；
+    贡献约定还规定"不要直接改 skill 正文再提交 PR"。frontmatter 里 `stock-research` 自报
+    `version: 2.46.0` —— 那个版本号是私有系统的历史，不代表公开版的成熟度。
+- License: MIT；`LICENSE` 为上游原件（`Copyright (c) 2026 Jerry Wang`），未改写。
+  **MIT 没有 Apache-2.0 第 4(b) 条那份"被改文件要带显著声明"的义务**，所以本颗不新增声明行
+  （与 `claude-for-financial-services-cn` 那一颗的区别正在这里，不是遗漏）。
+  上游 README 另带一句免责：仅供研究与教育用途、不构成投资建议、仓库不含任何实盘持仓数据。
+- Imported content: 所钉 commit 的完整文件树（三颗 skill 目录、`docs/`、`examples/`、`scripts/`、
+  `template/`、`README.md`、`CHANGELOG.md`、`LICENSE`），约 233 KB，**随 git 保留供复核**。
+  **随包发布的只有**：`LICENSE`、本文件，以及 `skills/cross-market-listing-choice/`
+  （一颗我们自持的入口 + 两份逐字复制的上游口径文件）。排除口径与理由写在快照自己的 `.npmignore`。
+
+## Local modifications（四类，逐条可复核；判据见 `docs/dev/selected-skills.md` §8.6）
+
+1. **新建一颗本仓自持的入口 skill** `skills/cross-market-listing-choice/SKILL.md`。
+   这不是上游正文的改写，而是本仓第一次在外部快照里放一颗自己写的正文——原因是一条结构事实：
+   provider 只把 `<skills 根>/<name>/SKILL.md` 认作可发现单位，而上游那三颗都不能进 catalog
+   （判断见下节），它们携带的两份**跨市场选线口径**因此没有可挂载的运行时入口。
+   入口正文全部由本仓撰写，口径来源只有那两份 overlay 文件与宿主既有纪律（委派取数、
+   不用记忆回填、不承诺收益、不代下单），没有从上游编排器里搬任何一句指令。
+2. **套了一层 `skills/`。** 上游把三颗 skill 直接放在**仓库根**，provider 的 `customSkillDirs`
+   与五处反查都按 `<repo>/<skillsDir>/<name>/SKILL.md` 走（peter-lynch 是同一类先例）。
+   `SELECTED_SKILL_SKILL_DIRS` 因此填 `'skills'`。
+3. **两份 `references/` 是逐字复制，不是移动**：`ah-overlay.md`、`adr-hk-overlay.md` 的原件仍住在
+   `stock-research/references/overlays/`（随 git 保留、不进发布包）。副本与上游**逐字节相同**，核对方式：
+   ```text
+   cmp skills/cross-market-listing-choice/references/ah-overlay.md \
+       <上游 commit>/stock-research/references/overlays/ah-overlay.md
+   ```
+   挑这两份（而不是 `markets/a-share.md` 那族）的唯一判据是**零执行面**：实测两份 overlay 正文
+   只含 ```text 围栏、零跨文件相对链接、零 `{{QUANT_ROOT}}` / `scripts/` / `*.py` / `collect-data`
+   一类私有栈引用，闸门 26 条模式零命中。`markets/a-share.md` 那份虽然 0 模式命中，但里面有
+   `PYTHONPATH={{QUANT_ROOT}} python data_platform/research_report_collector.py …` 这样的命令块，
+   指向公开版根本不附带的脚本——按第 4 条它要么整段删掉（就成了改上游正文），要么原样发出去
+   （就成了教 Agent 跑一条不存在的命令）。两条都不做，所以它不进包。
+4. **删除上游的 `.gitignore`**（只带 `.DS_Store` 与 `.env` 两条）。它会在本仓继续生效，
+   而 git 在被排除的父目录之下无法再 include（§8.6 那条实测教训）。
+
+**上游三颗正文一字未改**：不进 catalog 的正文不动也不扫（§8.6 开头那句），它们随 git 完整保留。
+
+## 收录判断：三颗编排器为什么一颗都不进 catalog
+
+按第 1、4、5、6 条逐条实测，不是印象：
+
+- **第 6 条（接管会话路由）**：三颗的 `description` 自报"编排器 / orchestrator"，正文是 Conductor
+  按步骤加载 `steps/*.skill.md`、并行派生 5–6 个 agent 再做 Debate 裁决——与本插件的角色路由正面冲突
+  （`china-stock-research-orchestrator`、InvestSkill 的 `full-report`、trading-skills 的四颗是同一类）。
+- **第 4 条（执行面）**：三颗都声明 `allowed-tools: Bash, Read, Write, Edit, EnterWorktree, ExitWorktree`
+  （后两个是 Claude Code 专属，DSH 运行时没有）。更硬的一条是**它们指挥的东西不在仓里**：
+  三颗 `SKILL.md` 点名的本地路径实测 **10 / 32 / 16 个，公开版一个都不存在**（`trade_history.json`、
+  `portfolio_state.json`、`research_verdicts.json`、`scripts/generate_bridge.py`、
+  `auto_research/quality_gate_check.py`、`sleeve/concept_heat.py`、`scripts/concept_radar.py` 等）。
+  把这种正文发给使用者，得到的是"教 Agent 去撞一堵墙"。
+- **第 1 条（第二条取数通道）**：`stock-research/steps/02-data-collection.skill.md` 写着
+  "**所有 DB 和 API 数据采集必须通过 `collect-data` skill 完成，禁止绕过 collect-data 直接调 API**"，
+  下面整张表是 Tushare / AkShare / yfinance / FRED / 东财 ReportAPI → 本地 SQLite + FTS5。
+  本插件的取数入口只有委派一个（§1.1），且原始 rows 永不出工具层。
+- **第 5 条 + `AGENTS.md` §7**：`04-output-delivery` 与 `references/output-contract.md` 要求产出
+  **五文件包**（`README.md` / `深度研究.md` / `财务数据.md` / `研报索引.md` / `跟踪框架.md`）
+  加一堆机器可读文件与 "Vault SHA 同步"。报告交付链路 2026-09-17 已整条删除、禁止以任何形式恢复。
+- **闸门实测**：全仓 51 份 `.md` 命中 **132 处**，分布极不均匀——三颗 `SKILL.md` 只有 **1 处**、
+  `steps/*` **109 处**、`agents/*` 9 处、我们真正取用的那族纯方法论 **1 处**（就是 `us-equity.md`
+  里的 AkShare 一词，而它不进包）、`detailed-workflows.md` 10 处。命中族是
+  71 个 ```python 围栏、40 个 `get_*(` 伪工具调用、17 个 AkShare、1 个 `ak.stock_news_em(`、1 个慧博。
+  **注意"1 处"不等于干净**：`python auto_research/quality_gate_check.py <research_dir>` 这类指令
+  现有 26 条模式一条都不认（第 10 条只认 `node|bash scripts/`）——这是"违规形状搬家"的又一次重演。
+- **还有一个架构级不兼容，值得单独记**：它整套结论都建立在**持有者的成交账本**上
+  （`Ledger reality`、`BLOCKED_LEDGER_MISSING_TRADE`、`current_new_money_pct`）。本插件从不持有
+  使用者的账本，只有自选股（观察清单），所以凡依赖账本的规则都落不了地。
+  `cross-market-listing-choice` 的正文因此明写"没有使用者的成交账本"这一条限制。
+
+## 已知未收、留给后续轮次的东西
+
+这几条按 catalog 现算的 67 颗 / 133 份 `.md` 实测是**空白**，且质地都好，但它们全部住在
+不能进 catalog 的编排器正文里，要接必须另起一轮重写：
+
+- **预期差闸门**：`delta_class=BEAT|IN_LINE|MISS|AMBIGUOUS` + "**公告披露不是叙事加速的充分条件**，
+  `IN_LINE` 不得直接升级 L3 / 龙头排序 / 入场线 / 仓位 / trigger，`BEAT` 也只能触发进一步验证"
+  （`concept-research/SKILL.md:58`、`industry-research/SKILL.md:52` 各一种措辞）。
+- **概念/题材叙事生命周期**：形成 → 加速 → 扩散 → 退潮 + 真龙/假龙（有业绩兑现 vs 纯叙事）。
+  本插件**数据面已经就绪**（`index_catalog` 概念板块目录、`index_constituents`、
+  `eastmoney_sector_rotation`、`eastmoney_cashflow_rotation`），缺的只是方法论面。
+- **check-first**：研究同一只票之前先读已有结论，并让使用者在"增量刷新 / 重做 / 只读复核"里选。
+- **境内券商评级结构性偏多**（"rating count is not a bullish thesis"）与
+  **A 股新股首日无涨跌幅 5 日**那一条（`markets/a-share.md`，含锁定期阶梯与招股书回退路径）。
+
+顺带一条数据面线索（不是 skill 问题）：它的 `report_rc` 对应 Tushare 的券商研报预测条目
+（前瞻 EPS / 目标价 / **上调下调方向**）。本插件的结构化面没有这一族，唯一的一致预期是
+`web_retriever` 的 `ths_eps_forecast`（机构数 / 最小 / 均值 / 最大 / 行业平均，且已带
+"机构数 <3 须一并披露"的纪律）。要不要补第二个来源，走 §10 数据源验收纪律另开。
+
+- Maintenance snapshot (checked 2026-10-13): 2 星、五次提交全在同一天、之后 70 天无提交、
+  0 issue、单人仓库，作者已声明数据层要到 v1.1 才开源。因此 catalog 标 `watchlist`——
+  是**维护薄**，不是那两份口径的内容缺陷。
+- Packaging: `.npmignore` 用七条目录规则 + 两条文件规则挡掉三颗编排器与上游工程材料；
+  `package.json` 的 `files` 登记 `selected-skills/quant-agent-skills`。
+  `test/packaging.test.mjs` 从 catalog 反查发布清单里的 `SKILL.md` / `LICENSE` / `UPSTREAM.md`，
+  并逐条反查 `.npmignore` 确实生效（目录与文件名两类都问）。
+- Runtime status: `watchlist` / 默认关闭。使用者在「插件」→ Capital Generation →「精选 Skills」
+  打开后，对之后的 Capital 会话可见；子 Agent 不继承。上游随 git 保留的脚本与编排器正文
+  **从不执行、也从不被 provider 读取**（skills 根里没有它们）。
+- Review status: 2026-11-15 复查上游、许可证与维护状态。届时若上游 v1.1 真的放出数据层，
+  重读上面"已知未收"那四条的可行性；不要在没有账本能力的前提下把它的 closeout 契约搬过来。

package/selected-skills/quant-agent-skills/skills/cross-market-listing-choice/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: cross-market-listing-choice
+description: 同一家公司在多个市场各有上市线（A+H 双上市、中概股的美股 ADR 与港股两条线）时，如何在**不重做公司研究**的前提下选一条来持有、加仓或观察：溢价与币种股息税、流动性与通道、披露文件路径。当且仅当问题问的是"同一家公司选哪条线"时使用；单一上市线的个股研究、比较两家公司、问公司本身好不好——都不走这颗。
+---
+
+# 跨市场选线（同一公司多条上市线）
+
+> 口径出处：`references/ah-overlay.md` 与 `references/adr-hk-overlay.md`，逐字取自上游
+> [Howard-Jerry/quant-agent-skills](https://github.com/Howard-Jerry/quant-agent-skills)
+> （MIT，commit `03677d2`）。那颗快照的三颗正文是自述的编排器、不进可选清单，随包只带这两份
+> 零执行面的口径文件；为什么这么切、改了什么，见本快照根的 `UPSTREAM.md`。
+
+## 什么时候用，什么时候不用
+
+用：公司结论已经有了（或本次不打算重做），剩下的问题是**这次动哪一条线**——A 股还是 H 股、
+ADR 还是港股、已持有的那条线要不要换成另一条。
+
+不用：只有一条上市线的公司；比较两家不同公司；问"这家公司值不值得研究"。那些是本插件
+其他研究路径的事，这颗一行都不接。**它不重做公司研究，只做选线。**
+
+## 一条铁律
+
+**公司层面只研究一次。** A 与 H、ADR 与港股，是同一家公司的两条线：现金流、竞争力、资产负债表
+**完全相同**，不同的只有执行、价差、税、流动性、货币和你能不能买到。
+
+由此得到两条禁止：
+
+- **不得因为一条线更便宜，就上调公司层面的结论。** 折价是选线理由，不是"这家公司更值得拥有"的理由。
+- **不得让包装层的便宜，盖掉公司层面缺失的证据。** 公司研究没做完，就先没有选线可言。
+
+这两句是这颗的核心，其余都是把它们变成可检查动作的细节。
+
+## 要拿的东西（一律走委派，本插件从不让分析角色自己伸手取数）
+
+向宿主的数据面要，一次把三项写全，缺哪一项就点名哪一项并停止依赖它的判断：
+
+1. **两条线在同一 as-of 交易日的收盘价**。币种分开写清楚：A 股那条是人民币，港股那条是港元，
+   ADR 是美元。**不许拿实时快照与历史收盘混算**——溢价是"同一天两个价格的比"。
+2. **同一天的汇率**（CNY 每 HKD，或 USD 每 HKD，按你对比的两条线取）。汇率取不到就是取不到：
+   本插件的汇率条目按次消耗上游积分，凭据缺失、限流或后端报错一律不重试，也不许用记忆里的
+   "大概 0.92"补一个数进去。
+3. **窗口是否干净**：两条线各自最近的拆股、送转、供股、大股东减持、回购注销有没有落在
+   你取的那段价格里。任一窗口被公司行动污染，就换到干净的后续窗口再比。
+
+股息代扣税、通道可用性（港股通 / 直接开户 / 券商能不能买）这类**规则性**事实会改，
+不向数据面要，按 `capital-web-protocol` 委派检索通道，把要核的问题、现行规则和时点写进 brief。
+
+## 溢价怎么算
+
+把算式写进答复里，让读者能复核——不要只给一个百分比。
+
+```text
+A/H 溢价 = (A_price_cny / fx_cny_per_hkd) / h_price_hkd - 1
+ADR/HK 平价 = (adr_price_usd / adr_ratio) / (hk_price_hkd * fx_hkd_per_usd) - 1
+```
+
+- `fx_cny_per_hkd` 是**一港元合多少人民币**，方向写反等于把溢价倒过来。
+- ADR 那条必须先除以 `adr_ratio`（一份 ADR 对应几股普通股），比例随公司行动变过就要重新确认。
+- 两个式子用的都必须是同一个 as-of 日的收盘与同一天汇率；日期不一致就分别标注并说明差距有多大。
+- 派生算术量大就交给宿主数据侧（委派 `data_junior`），少量数字在答复里把算式摊开即可。
+  本插件的分析角色不自己跑脚本。
+
+## 输出形状
+
+```text
+公司结论：<沿用已完成的那次研究，不在这里重做>
+若触发行动，优先哪条线：<A / H / ADR / 不换>
+理由：<价差 / 币种与股息税 / 流动性 / 通道 / 披露路径>，各一句
+```
+
+三份理由各归各位，不许混成一段"综合来看"。**价差只是其中一条**：一条线折价 30% 但你的账户
+买不到，那它对这个人没有意义；港股通额度、停牌规则、涨跌停（A 侧有、港侧无）都属于通道与执行。
+
+## 各市场要单独看的点
+
+- **A/H**：A 侧有涨跌停与 T+1，H 侧没有；H 侧还要看港股通通道与股息代扣。具体口径见
+  `references/ah-overlay.md`。
+- **ADR/HK**：ADR 是**存托凭证不是股票**——要看换算比例、能不能跨市场转托管（fungibility）、
+  退市与监管风险、以及**披露文件路径不同**：美国本土公司走 `10-K/10-Q/8-K`，外国私人发行人走
+  `20-F/6-K`。一条线的公告在另一条线的检索面里可能根本不存在，这是**市场边界，不是数据缺口**；
+  别把"这条线查不到"写成"这家公司没披露"。具体见 `references/adr-hk-overlay.md`。
+
+## 出处块
+
+分析结束时按本插件的统一形状交代出处，把每一项证据的来路写全：
+
+```text
+Data & Sources
+  - <事实或数字>：来源=<Dataset 引用 / 披露文件名 / 网页标题与日期>
+    as-of=<YYYY-MM-DD>
+    Retrieval:  <delegated retrieval | web/tool retrieval | pasted by user>
+```
+
+`Retrieval` 只能是这三档之一。**"我记得大概是这个汇率"不是一档取数途径。**
+
+## 这颗做不到什么（先说清楚，别到时候编）
+
+- **本插件没有使用者的成交账本。** 这颗不持久化你的持仓、成本价与已实现盈亏。上文"已持有
+  的那条线要不要换"只能按你在对话里当场给出的信息回答，回答完就放下；也不要假装查过账户。
+- **没有现成的 A/H 溢价或 ADR 平价条目。** 溢价必须自己按两条线的收盘与当日汇率算出来，
+  这三项里任何一项取不到，就不要给溢价数字，只报告缺哪一项。
+- **不承诺收益，不预测价差收敛。** "A 比 H 贵 40%"是当天的事实，"所以 H 会涨"不是这颗的结论。
+  历史价差区间可以作为参照，但要写明它是参照、不是目标。
+- **不构成投资建议，也不代使用者下单。** 本插件不提供交易执行界面；最终动哪条线、动多少，
+  由使用者自己决定并自己执行。

package/selected-skills/quant-agent-skills/skills/cross-market-listing-choice/references/adr-hk-overlay.md

@@ -0,0 +1,45 @@
+# ADR / HK Overlay
+
+Use when the same company trades as a U.S. ADR and Hong Kong share, or when a
+U.S.-listed ADR has a related HK primary/secondary listing.
+
+## Principle
+
+Research the company once. The overlay chooses the better security wrapper for
+execution and risk control.
+
+## Required Checks
+
+- Alias coverage for ADR ticker, HK ticker, Chinese name, English name, and
+  historical names.
+- Share ratio:
+  - ADR-to-ordinary share conversion ratio;
+  - price parity after FX and ratio adjustment.
+- Currency:
+  - USD vs HKD;
+  - FX basis date.
+- Listing and regulatory risk:
+  - HFCAA/delisting risk if applicable;
+  - primary vs secondary listing status;
+  - fungibility and conversion constraints.
+- Liquidity and trading access:
+  - U.S. session vs HK session;
+  - spread and average daily value;
+  - available account/channel.
+- Filing path:
+  - U.S. domestic forms (`10-K/10-Q/8-K`) vs foreign private issuer forms
+    (`20-F/6-K`);
+  - company IR fallback when local SEC collector does not yet cover forms.
+
+## Output Rule
+
+Write:
+
+```text
+Company verdict: <WAIT/BUY/HOLD/...>
+Preferred security if action triggers: <ADR/HK/no-switch>
+Wrapper reason: <parity, liquidity, filing, regulatory, FX, channel>
+```
+
+Do not let wrapper cheapness override missing company-level evidence.
+

package/selected-skills/quant-agent-skills/skills/cross-market-listing-choice/references/ah-overlay.md

@@ -0,0 +1,44 @@
+# A/H Overlay
+
+Use when the same company has both A-share and H-share listings. This overlay
+answers which security is better for execution after the company thesis is
+already researched.
+
+## Principle
+
+Company-level research is done once. A vs H does not change the company's cash
+flows. It changes execution, valuation spread, tax, liquidity, currency, and
+access.
+
+## Required Checks
+
+- Alias coverage for A code, H code, Chinese name, English name, short names,
+  and common variants.
+- A/H premium:
+  - compute with consistent price dates;
+  - convert currency: `(A_price / FX_CNY_per_HKD) / H_price - 1`;
+  - use a clean post-split/post-corporate-action window when old data is
+    polluted.
+- Currency and dividend tax:
+  - CNY vs HKD basis;
+  - HK Stock Connect dividend withholding when relevant.
+- Liquidity and channel:
+  - A-share liquidity/limit-up-down/microstructure;
+  - HK liquidity, southbound access, borrow/short availability if relevant.
+- Portfolio reality:
+  - current held line;
+  - trade ledger currency and cost basis;
+  - whether switching lines is operationally possible.
+
+## Output Rule
+
+Write the overlay as:
+
+```text
+Company verdict: <WAIT/BUY/HOLD/...>
+Preferred listing if action triggers: <A/H/no-switch>
+Reason: <premium, currency, tax, liquidity, channel>
+```
+
+Never upgrade a weak company-level EV just because one line is cheaper.
+