@v587d/capital-generation 2.7.2 → 2.7.4

package/selected-skills/claude-for-financial-services-cn/vertical-plugins/wealth-management/skills/china-investment-proposal/SKILL.md

@@ -0,0 +1,271 @@
+---
+name: china-investment-proposal
+description: Draft investment proposals for Chinese wealth management clients. Creates structured proposals with investment rationale, product recommendations, and risk disclosures. Adapted from the original investment-proposal skill for A-share products and Chinese regulatory requirements. Triggers on "A股投资建议书", "投资方案", "investment proposal China", "proposal for [client]", "investment recommendation A-share", or "build investment proposal".
+---
+
+# china-investment-proposal
+
+## Purpose
+
+Create professional **A股财富管理投资建议书** — structured proposals for Chinese wealth management clients.
+
+## Data Sources
+
+### Primary: iFind MCP (Tier-1 付费) / AkShare MCP (Tier-2 免费备选)
+
+```python
+get_index_data("000001")              → Market context
+get_index_data("399006")              → ChiNext context
+get_quote(ticker)                     → Security analysis
+get_fund_data(fund_code)              → Fund analysis
+get_industry_stocks(industry="...")    → Sector analysis
+```
+
+### Secondary Sources
+- Portfolio management system
+- Research team — market outlook
+- Product providers — fund/insurance data
+
+## Workflow
+
+### Step 1: Understand Client Needs
+
+**Discovery questions:**
+
+1. **Investment objective**: 保值增值 / 稳健增值 / 积极增值 / 收入型
+2. **Time horizon**: 短期(<1年) / 中期(1-5年) / 长期(>5年)
+3. **Risk tolerance**: 保守 / 稳健 / 积极 / 激进
+4. **Liquidity needs**: 高 / 中 / 低
+5. **Special considerations**: 税务, 遗产, 慈善, etc.
+
+### Step 2: Market & Strategy Overview
+
+**Current market assessment:**
+
+```
+市场展望 [Period]
+
+一、宏观经济
+   [GDP, policy, rates outlook]
+
+二、权益市场
+   - 估值水平: 沪深300 PE [Xx] (历史[X]%分位)
+   - 资金面: 北向资金, 两融余额
+   - 情绪指标: [Index]
+
+三、行业配置观点
+   超配 (Overweight): [Sectors] — [Rationale]
+   标配 (Neutral): [Sectors]
+   低配 (Underweight): [Sectors] — [Rationale]
+
+四、风险提示
+   [Key risks]
+```
+
+### Step 3: Investment Strategy
+
+**Strategy design:**
+
+| Component | Allocation | Rationale |
+|-----------|-----------|-----------|
+| A股权益 | XX% | Growth engine |
+| 基金 (主动) | XX% | Professional management |
+| 基金 (指数) | XX% | Low-cost beta |
+| 债券/固收+ | XX% | Stability, income |
+| 现金/货币基金 | XX% | Liquidity |
+| 另类 (REITs, 黄金) | XX% | Diversification |
+
+**A-share equity allocation:**
+
+| Sector | Weight | Thesis |
+|--------|--------|--------|
+| 消费 | XX% | [Rationale] |
+| 科技 | XX% | [Rationale] |
+| 医药 | XX% | [Rationale] |
+| 金融 | XX% | [Rationale] |
+| 新能源 | XX% | [Rationale] |
+| 其他 | XX% | [Rationale] |
+
+### Step 4: Product Recommendations
+
+**Recommended securities:**
+
+| # | Type | Security | Ticker | Allocation | Rationale | Risk Level |
+|---|------|----------|--------|-----------|-----------|------------|
+| 1 | A股个股 | | | | | |
+| 2 | 主动基金 | | | | | |
+| 3 | 指数基金 | | | | | |
+| 4 | 债券/理财 | | | | | |
+| 5 | 现金管理 | | | | | |
+
+**For each recommendation:**
+- Investment thesis (3-5 bullet points)
+- Expected return range
+- Risk assessment
+- Suitable for client profile
+- Minimum investment
+- Liquidity terms
+
+### Step 5: Risk Assessment & Disclosure
+
+**Risk factors (standard Chinese disclosures):**
+
+```
+风险揭示
+
+一、市场风险
+   投资有风险, 入市需谨慎。本投资方案涉及A股市场投资,
+   股票价格可能因市场因素大幅波动。
+
+二、流动性风险
+   部分投资品可能存在流动性限制, 赎回/卖出可能受
+   市场流动性影响。
+
+三、政策风险
+   国家政策、行业监管变化可能影响投资组合表现。
+
+四、信用风险
+   固定收益类产品存在发行人信用风险。
+
+五、汇率风险
+   [If applicable]
+
+六、其他风险
+   [Product-specific risks]
+```
+
+**Risk level match:**
+- Conservative (保守型): 低风险产品为主, 权益<30%
+- Balanced (稳健型): 中等风险, 权益30-60%
+- Growth (积极型): 较高风险, 权益60-90%
+- Aggressive (激进型): 高风险, 权益>90%
+
+### Step 6: Expected Returns & Scenarios
+
+**Return scenarios:**
+
+| Scenario | Probability | Expected Return | Portfolio Value (3Y) |
+|-----------|-------------|----------------|---------------------|
+| 乐观 | 25% | +XX% | ¥XXX万 |
+| 中性 | 50% | +X% | ¥XXX万 |
+| 悲观 | 25% | -X% | ¥XXX万 |
+
+### Step 7: Implementation Plan
+
+**Implementation steps:**
+
+| Step | Action | Timeline |
+|------|--------|----------|
+| 1 | 方案确认 | [Date] |
+| 2 | 账户开立/激活 | [Date] |
+| 3 | 建仓 (首批建仓) | [Date] |
+| 4 | 分批建仓 (如需) | [Date range] |
+| 5 | 首次复核 | [Date] |
+
+**建仓策略:**
+- 一次性建仓: 适合积极型, 市场低点
+- 分批建仓: 适合稳健型, 降低择时风险
+- 定投: 适合长期投资, 平滑成本
+
+### Step 8: Monitoring & Review
+
+**Review schedule:**
+
+| Review Type | Frequency | Content |
+|-------------|-----------|---------|
+| 日常监控 | Daily | Market alerts, significant moves |
+| 月度回顾 | Monthly | Performance, attribution |
+| 季度复盘 | Quarterly | Full review, rebalancing |
+| 年度规划 | Annual | Goal review, strategy update |
+
+### Step 9: Proposal Document
+
+**Standard proposal format:**
+
+```
+【投资建议书】
+客户名称：[Name]
+风险等级：[R1-R5]
+投资期限：[X年]
+建议日期：[Date]
+
+一、客户需求分析
+   [Goals, constraints, preferences]
+
+二、市场展望
+   [Current market assessment]
+
+三、投资策略
+   [Allocation strategy with rationale]
+
+四、产品推荐
+   [Detailed recommendations]
+
+五、风险评估
+   [Risk factors, suitability assessment]
+
+六、预期表现
+   [Return scenarios]
+
+七、实施方案
+   [Implementation plan]
+
+八、后续服务
+   [Review schedule, monitoring]
+
+九、声明
+   [Standard regulatory disclaimers]
+
+客户签字：_________ 日期：_________
+理财师签字：_________ 日期：_________
+```
+
+## China-Specific Considerations
+
+### Suitability (适当性管理)
+
+**China regulatory requirements:**
+- 风险等级匹配: Product risk ≤ Client risk tolerance
+- 投资者分类: 普通投资者 / 专业投资者
+- 信息披露: Full and fair disclosure
+- 冷静期: Cooling-off period for certain products
+- 录音录像: Recording for in-person sales
+
+### Common Investment Products (China)
+
+| Product | Risk | Return | Liquidity |
+|---------|------|--------|-----------|
+| 银行理财 | Low | 2-4% | Medium |
+| 货币基金 | Low | 1.5-2.5% | High |
+| 国债 | Very low | 2-3% | Medium |
+| 企业债 | Low-Medium | 3-5% | Medium |
+| A股个股 | High | Variable | Medium |
+| 主动基金 | Medium-High | Variable | Medium |
+| 指数基金/ETF | Medium | Variable | High |
+| 私募基金 | High | Variable | Low |
+| 信托 | Medium-High | 5-8% | Low |
+| 保险产品 | Low-Medium | Guaranteed + bonus | Low |
+
+### Client Segmentation
+
+| Type | Profile | Strategy |
+|------|---------|----------|
+| 保守型 | Risk-averse, capital preservation focus | Bonds, money market, blue chips |
+| 稳健型 | Balanced, moderate growth | Balanced allocation, dividend stocks |
+| 积极型 | Growth-oriented, can tolerate volatility | Growth stocks, sector funds |
+| 激进型 | High risk tolerance, return-seeking | Small-caps, thematic, alternatives |
+
+## Quality Checks
+
+Before delivering:
+- [ ] Client profile understood
+- [ ] Allocation aligned with risk tolerance
+- [ ] Products suitable and available
+- [ ] Risk disclosures complete
+- [ ] Expected returns realistic
+- [ ] Implementation plan clear
+- [ ] Regulatory disclosures included
+> **Data Source Mode Switch**: Set env var `IFIND_DATA_SOURCE_MODE` to control data source preference.
+> - `ifind-only` (strict): Use iFind only, error if unavailable
+> - `ifind-fallback` (default): iFind preferred, fallback to AkShare
+> - `akshare-only, wind-only (Wind only), wind-fallback (Wind first, fallback to iFind → AkShare)`: Skip iFind, use AkShare only

package/selected-skills/claude-for-financial-services-cn/vertical-plugins/wealth-management/skills/china-portfolio-rebalance/SKILL.md

@@ -0,0 +1,191 @@
+---
+name: china-portfolio-rebalance
+description: Portfolio rebalancing analysis for A-share wealth management portfolios. Analyzes allocation drift, generates rebalancing trades, and optimizes for tax efficiency. Adapted from the original portfolio-rebalance skill for Chinese portfolios. Triggers on "A股组合再平衡", "调仓", "rebalance China", "portfolio rebalance A-share", "rebalance portfolio", or "adjust allocation [client]".
+---
+
+# china-portfolio-rebalance
+
+## Purpose
+
+Perform **A股投资组合再平衡** — analyze allocation drift, generate rebalancing recommendations, and optimize trade execution.
+
+## Data Sources
+
+### Primary: iFind MCP (Tier-1 付费) / AkShare MCP (Tier-2 免费备选)
+
+```python
+get_quote(ticker)                     → Current prices for holdings
+get_historical_data(ticker)           → Tax lot / cost basis context
+```
+
+### Secondary Sources
+- Portfolio management system
+- Wind / Choice — market data
+- Tax rules — A-share tax treatment
+
+## Workflow
+
+### Step 1: Current Allocation
+
+**Portfolio snapshot:**
+
+| Asset Class | Target % | Current % | Drift | Market Value | Action |
+|-------------|----------|-----------|-------|--------------|--------|
+| | | | | | |
+
+**Within A-share equity:**
+
+| Sector | Target | Current | Drift | Action |
+|--------|--------|---------|-------|--------|
+| 消费 | XX% | XX% | ±X% | Buy/Sell/Hold |
+| 科技 | XX% | XX% | ±X% | Buy/Sell/Hold |
+| 医药 | XX% | XX% | ±X% | Buy/Sell/Hold |
+| 金融 | XX% | XX% | ±X% | Buy/Sell/Hold |
+| 新能源 | XX% | XX% | ±X% | Buy/Sell/Hold |
+| 其他 | XX% | XX% | ±X% | Buy/Sell/Hold |
+
+### Step 2: Identify Drift
+
+**Drift thresholds:**
+
+| Drift Level | Action |
+|-------------|--------|
+| ±2% | Monitor, no action |
+| ±3-5% | Consider rebalancing |
+| ±5%+ | Rebalance recommended |
+
+**Drift causes:**
+- Market price movements
+- Dividend reinvestment
+- Previous trades
+- Cash flows (contributions/withdrawals)
+
+### Step 3: Generate Rebalancing Trades
+
+**Rebalancing logic:**
+
+| Situation | Action |
+|-----------|--------|
+| Sector overweight + price up | Trim position |
+| Sector underweight + price down | Add to position |
+| Overweight + price down | Monitor (may converge) |
+| Underweight + price up | Monitor (may converge) |
+
+**Trade list:**
+
+| Action | Ticker | Security | Current % | Target % | Trade Amount | Est. Shares |
+|--------|--------|----------|-----------|----------|-------------|------------|
+| Buy | | | | | | |
+| Sell | | | | | | |
+| Hold | | | | | | |
+
+### Step 4: Tax Considerations
+
+**A-share tax treatment:**
+
+| Item | Tax Rate | Notes |
+|------|----------|-------|
+| 股票买卖价差 | 暂免 (temporarily exempt) | Capital gains on stocks |
+| 股息红利 | 20% (持股>1年减半/免征) | Dividend tax |
+| 基金分红 | 暂免 (some funds) | Fund distributions |
+| 买卖印花税 | 0.05% (seller only) | Stamp duty |
+
+**Tax-loss harvesting opportunities:**
+
+| Position | Cost Basis | Current Value | Unrealized Loss | Tax Benefit |
+|----------|-----------|--------------|-----------------|-------------|
+| | | | | |
+
+**Tax-efficient selling:**
+- Prioritize selling positions with losses
+- Consider holding period for dividend tax
+- Batch sales to minimize stamp duty impact
+
+### Step 5: Execution Plan
+
+**Trade sequencing:**
+
+| Priority | Trade | Rationale |
+|----------|-------|-----------|
+| 1 | | Tax loss harvesting |
+| 2 | | Largest drift correction |
+| 3 | | Smaller adjustments |
+
+**Execution considerations:**
+- Market impact (liquidity)
+- Trading costs (commissions, stamp duty)
+- Market timing (volatility)
+- Block trading for large positions
+
+### Step 6: Rebalancing Report
+
+**Standard rebalancing report:**
+
+```
+【组合再平衡报告】[Client] [Date]
+
+一、当前配置 vs 目标配置
+   [Allocation table with drift]
+
+二、再平衡建议
+   [Trade list]
+
+三、税务影响
+   [Tax implications]
+
+四、执行计划
+   [Sequencing and timing]
+
+五、预期效果
+   [Projected post-rebalance allocation]
+```
+
+## China-Specific Rebalancing Considerations
+
+### A-share Market Characteristics
+
+| Factor | Rebalancing Implication |
+|--------|------------------------|
+| 涨跌停限制 | May prevent immediate rebalancing |
+| T+1 settlement | Trade settlement timeline |
+| 印花税 | 0.05% on sell side |
+| 佣金 | Varies by broker (typically 0.02-0.03%) |
+| 最低手续费 | Minimum commission threshold |
+
+### Tax-Loss Harvesting (A-share)
+
+**China-specific TLH:**
+- Capital gains on stocks: currently tax-exempt (暂免)
+- Losses: can offset gains within the same asset class
+- 股息红利 tax: 20%, reduced to 10% for >1 year holding, 0% for >1 year (recent changes)
+- Fund distributions: tax treatment varies by fund type
+
+### Common Rebalancing Triggers
+
+| Trigger | Frequency | Action |
+|---------|-----------|--------|
+| Calendar rebalancing | Quarterly/Semi-annual | Systematic rebalance |
+| Drift threshold | When ±5% | Opportunistic rebalance |
+| Cash inflow | As received | Deploy to underweights |
+| Client request | Ad-hoc | Targeted rebalance |
+| Tax planning | Year-end | Harvest losses, reset cost basis |
+
+## Quality Checks
+
+Before executing:
+- [ ] Allocations calculated correctly
+- [ ] Trades aligned with policy
+- [ ] Tax implications assessed
+- [ ] Trading costs estimated
+- [ ] Client approval obtained
+- [ ] Execution plan sequenced
+
+After rebalancing:
+- [ ] Trades confirmed
+- [ ] Allocation updated
+- [ ] Tax lots recorded
+- [ ] Client notified
+> **Data Source Mode Switch**: Set env var `IFIND_DATA_SOURCE_MODE` to control data source preference.
+> - `ifind-only` (strict): Use iFind only, error if unavailable
+> - `ifind-fallback` (default): iFind preferred, fallback to AkShare
+> - `akshare-only`: Skip iFind, use AkShare only

package/selected-skills/investment-skills/UPSTREAM.md

@@ -5,8 +5,9 @@
 - Upstream commit: `7235d3411601036cc79137fa0aec0d587f2c8e19`
 - License: MIT; see `LICENSE` copied from upstream.
 - Imported content: complete upstream repository snapshot, including the Buffett framework skill and its references. Upstream scripts are retained as source material and are never executed by intake or activation.
+- Removed from the snapshot: the upstream ignore rules — `.gitignore` at the snapshot root (`__pycache__/`, `*.pyc`), plus the nested ones under `.tbd/` and `viz/vendor/`. Vendored snapshots do not carry ignore rules into this repo (`docs/dev/selected-skills.md` §8.6: an inherited ignore pattern can silently hide files when the snapshot is re-imported). Nothing committed was hidden by them. Note that `viz/vendor/.gitignore` used to hide two artifacts upstream fetches on demand (`elk.bundled.js`, `elkjs-license.txt` via `fetch-elk.sh`); neither exists in this repo, and `viz/` is excluded from the published package anyway.
 - Local modifications: one sentence, on the router block. Upstream wrote "Use the bundled deterministic router when a shell is available" and four `python3 scripts/framework.py …` examples; under Capital the root role has no shell (§1.6), so that conditional left a dead end with nothing to fall back to. The sentence now states the two preconditions (a shell **and** a reachable skill directory) and names the fallback: skip the router and open the `references/` file for the chosen module directly, since the router only picks which file to read. No card, workflow, or analytical text was touched; `scripts/framework.py` itself is unmodified. Recorded here per `docs/dev/selected-skills.md` §8.6, and enforced by `test/selected-skills-content.test.mjs` (a file may mention `python3 scripts/` only if it also carries the no-shell fallback). This record and the Capital selected-skill catalog are maintained by Capital Generation.
-- Packaging: a Capital-owned `.npmignore` beside these files excludes `images/` and `viz/` from the published npm package — 2.3 MB of upstream README artwork (the same four PNGs exist twice, in `images/` and `viz/out/`) plus the upstream visualization site; no skill body references either. The complete snapshot stays committed here, so `github:` installs and provenance review are unaffected.
+- Packaging: a Capital-owned `.npmignore` beside these files keeps only the runtime skill body and this record in the published npm package. Excluded: `images/` and `viz/` (2.3 MB of README artwork — the same four PNGs exist twice — plus the upstream visualization site), `.github/` (its CI), `.tbd/` and `docs/` (upstream roadmap/development notes), and `README*.md`. No skill body references any of them. Kept on purpose: `skills/buffett-investment-framework/scripts/framework.py` and `Makefile` — this skill's own prose names the deterministic router as a methodology entry point and carries the no-shell fallback, so shipping them as review material while never executing them (intake and activation only read documents) is the honest shape; see `docs/dev/selected-skills.md` §8.6 item 4. The complete snapshot stays committed here, so `github:` installs and provenance review are unaffected.
 - Maintenance snapshot (checked 2026-10-08): latest commit 2026-07-22; no later commits observed through the review date (78 days). See [GitHub commit history](https://github.com/finterm-ai/investment-skills/commits/main/).
 - Runtime status: `experimental` / explicit experiment. The skill remains disabled until explicitly selected in Capital settings and is registered only in a Capital root Agent's own scope. Its capability tags and warning are maintained in `selected-skills/catalog.js`.
 - Review status: imported for user-directed evaluation; not endorsed by Warren Buffett, Berkshire Hathaway, or Capital Generation. Its US-centric framework must not be treated as A-share rules. Validate all financial claims against primary evidence.

package/selected-skills/peter-lynch-skill/UPSTREAM.md

@@ -51,10 +51,11 @@
      `system-prompt.md` 本来就把取回的东西限定成"来自研究简报"。不为了套 InvestSkill 的改法新造上游没有的模板字段。
   复核方法：`git clone` 所钉 commit 后 `diff -r`，差异只应包含以上三类；
   `test/selected-skills-content.test.mjs` 扫正文**结果**、本文件记**理由**，两边任一漂回去都会红。
-- Packaging: 这颗**不带 `.npmignore`**——除 `README.md`（13 KB）之外全是运行时正文与溯源，包体积增量约 120 KB，
-  没有需要挡的成图、静态站或脚本目录（`china-stock-research-skills` 同样没挡）。
+- Packaging: 这颗带一份 `.npmignore`，只挡上游 `README.md`（13 KB，写给 GitHub 访客的仓库说明）——
+  其余全是运行时正文与溯源，正文一处也没引用那份 README。包体积增量约 107 KB。
   `package.json` 的 `files` 已逐仓库登记 `selected-skills/peter-lynch-skill`，
-  `test/packaging.test.mjs` 从 catalog 反查发布清单里的真实 `SKILL.md` / `LICENSE` / `UPSTREAM.md`。
+  `test/packaging.test.mjs` 从 catalog 反查发布清单里的真实 `SKILL.md` / `LICENSE` / `UPSTREAM.md`，
+  并反查 `.npmignore` 的每条规则（目录与文件名两类）确实生效。
 - Catalog 收录判断：`SKILL.md` 内部的 Quick / Deep 二选一**不算**"会接管会话路由的编排 skill"——
   它不跨 Agent、不改本插件的角色分流，只在本颗的两条工作流之间选择（`china-stock-research-orchestrator`
   与 InvestSkill 的 `full-report` 是另一类东西）。也不触发 §7（报告交付链路已删除）与 §6.1（出图只走

package/selected-skills/trading-skills/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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/trading-skills/UPSTREAM.md

@@ -0,0 +1,111 @@
+# Upstream Record
+
+- Project: Trading Skills —— 19 颗讲交易过程纪律的 skill：下单前的检查（催化剂排布、自选清单分诊、证据缺口、
+  论点压力测试、盈亏比结构、执行计划可操作性、组合集中度）与下单后的复盘学习（交易日志模式、单笔复盘），
+  外加 4 颗把它们串起来的 workflow、一颗仓位计算与一颗券商 API 执行面。
+- Repository: https://github.com/marian2js/trading-skills
+- Upstream commit: `f1ae7d481154b49192681187cb08d39d7e2d4524`（main，2026-03-16，"Run skill-doctor and improve skill triggers"）
+  - 全仓 31 次提交，全部落在 2026-03-06 至 2026-03-16 这十天里。上游版本文件 `VERSION` = `0.1.0-rc.1`，无 release、无 tag。
+- License: MIT；`LICENSE` 为上游原件、未改写。**注意其 `Copyright (c) 2026` 一行没有署名**（上游就是这么写的），
+  署名按仓库 owner 与 commit author 记为 `marian2js`；catalog 的 `owner` 用同一个值拼仓库链接。
+- Imported content: 该 commit 的完整文件树（`skills/` 下 19 颗 skill + 共享 python 模块 + 仓库级材料），55 个文件 / 约 460 KB。
+  上游带 `.gitignore`（`__pycache__/`、`.env`、`.venv/` 等）——见下面的本地改动 2。
+
+- Local modifications（三类，逐条可复核；口径与理由见 `docs/dev/selected-skills.md` §8.6 的接入必查清单）：
+
+  1. **平铺掉 `<domain>/` 一层。** 上游把 skill 按主题分成两层：`skills/<domain>/<name>/SKILL.md`
+     （`idea-discovery`、`market-context`、`position-oversight`、`review-learning`、`thesis-validation`、
+     `trade-construction`、`live-trade`、`workflows`）。DSH filesystem provider 只枚举 skills 根的**直接子项**，
+     指 `skills` 等于发现 0 颗；而 provider 与 `test/selected-skills-content.test.mjs`、`test/packaging.test.mjs`、
+     `test/persona.test.mjs`、`capital-config` 原文旁路五处都按 `<repo>/<skillsDir>/<name>/SKILL.md` 反查
+     （AGENTS.md §9.7 那一族：漂了不报错，只是"勾了那一格、技能永远不出现"）。所以快照里是
+     `skills/<name>/…`，`SELECTED_SKILL_SKILL_DIRS` 填 `'skills'`。
+     每颗 skill 的 markdown 链接**只指向自己目录内**的 `references/…` 与 `assets/…`（逐颗核过，无 `../`、无跨目录链接），
+     平铺后一条不破。原分组记在这里供核对：
+     `idea-discovery` → catalyst-map、watchlist-review；`market-context` → earnings-preview、macro-event-analysis、
+     market-regime-analysis；`position-oversight` → position-management；`review-learning` → journal-pattern-analyzer、
+     post-trade-review；`thesis-validation` → evidence-gap-check、thesis-validation；`trade-construction` →
+     execution-plan-check、portfolio-concentration、position-sizing、risk-reward-sanity-check；`live-trade` → etoro；
+     `workflows` → earnings-trade-prep、portfolio-risk-review、post-trade-debrief、pre-trade-check。
+     随之变旧的是上游 `catalog.json` 里的 `path` / `docs_path` 字段与 `docs/examples/` 的路径口径——
+     两者都不进 catalog、也不进发布包（见 Packaging），按"不进 catalog 的正文一律不动"原样保留。
+  2. **删除上游的 `.gitignore`。** 被排除的 ignore 规则会在本仓继续生效，并把"按 commit 重导"的快照
+     与所钉 commit 弄成两种样子（InvestSkill 那一轮就是三个文件被静默挡掉）。vendored 快照不把 ignore 规则带进宿主仓库。
+  3. **取数与执行面口径改写**：8 份 `SKILL.md` + 2 份 `references/calculation-helpers.md`，
+     共 17 处句子级改动（+34 / −13 行）。分析结论、判定档位词汇（`must-watch` / `fragile` / `too concentrated` 一类）、
+     输入清单、输出顺序与 `references/` 的框架、阈值文档一字未改。
+     本颗**没有** `web search` 与记忆回填那一族（`web search` 零命中；每颗都写"缺什么就点名缺、别编"，
+     `example-mode` 指使用者自带的示例数据并要求标注，不是逃生口），换的是另外三种形态：
+     - **谁去取数（6 处）**：`catalyst-map`、`watchlist-review`、`evidence-gap-check`、`thesis-validation`、
+       `execution-plan-check`、`portfolio-concentration` 各有一句 `Do not fetch live data unless the user
+       explicitly asks to pair this skill with …`。前半句的意图（别自己去堆一堆数据）保留，
+       后半句改成"确实缺一个日期或一个字段时，把标的、字段、as-of 日期写成 brief 交给宿主取数通道——
+       角色分流的宿主里就是负责检索与行情的角色——用回来的东西继续，剩下的照旧标为未知"。
+       顺带这三句原本点名的 `earnings-preview` / `macro-event-analysis` 不在可选清单里（见下面的收录判断）。
+     - **没有 shell 就算不了（2 + 2 处）**：`journal-pattern-analyzer:49` 与 `risk-reward-sanity-check:52` 的
+       `For agents that support code execution, use [references/calculation-helpers.md] …` 改成
+       "本插件的分析角色没有 shell，也不跑 helper 脚本：统计量交给宿主数据侧（角色分流的宿主里委派做统计与质量校验的角色），
+       三笔以内可以在答复里手算并把算式写出来，缺输入的条目留空不补默认值"；
+       两颗各自的 `references/calculation-helpers.md` 随之从"复用 `skills/_lib/calculations.py` 里的函数"
+       改写成"这些量是什么、怎么取"（公式按上游 `_lib/calculations.py` 的实现核对：
+       `risk_reward_ratio` = |target−entry| / |entry−stop| 每单位、`expectancy` = 胜率×均盈 − 败率×均亏，
+       `kelly_fraction` 只是参照值，不作为交给使用者的仓位）。
+     - **点名的下一步 skill 未必存在（7 处）**：`catalyst-map`、`watchlist-review`、`evidence-gap-check`、
+       `thesis-validation`、`journal-pattern-analyzer`、`execution-plan-check`、`portfolio-concentration` 的
+       `Next Skill` 清单原句保留，各加同一句前置条件与退路（InvestSkill 那轮的改法）：
+       点名的 skill 只有使用者显式开启才存在于会话里，本插件明确不提供的那两类（下单、给仓位）永远不存在，
+       只能说成选项、不能替使用者跑。
+     **没有新增 `Retrieval:` 出处档**：上游根本没有这个枚举（§8.6 第 3 条不适用），
+     不为了套前几颗的改法新造上游没有的模板字段。
+
+- 收录判断（19 颗里 9 颗进 catalog，10 颗留在快照里当可审查材料）：
+  - **进**：`catalyst-map`、`watchlist-review`、`evidence-gap-check`、`thesis-validation`、
+    `risk-reward-sanity-check`、`execution-plan-check`、`portfolio-concentration`、
+    `journal-pattern-analyzer`、`post-trade-review`。
+    `post-trade-review` 一字未动就过闸门（全文无取数、无脚本、无出图，只在 `references/review-rubric.md`
+    里举了一条"高冲击数据日把仓位减 25%"的过程规则例子 → `riskNote` 写明属于过程推演）。
+  - **不进 · 执行面**：`etoro`。它是券商公开 API 的操作手册：`SKILL.md:18` "**Keys (request from the user on install)**"
+    与逐步生成密钥的说明、`x-api-key` / `x-user-key` 请求头、`curl -X POST …/trading/execution/…market-open-orders/by-amount`
+    带 `"IsBuy": true, "Leverage": 1`、"Use **non-demo execution endpoints** for real trading"、按 `positionId` 平仓，
+    末尾还指到一个 MCP server。§8.6 第 4 条（执行面）与第 7 条（真实下单）双重排除；本插件不接券商、不下单、
+    凭据只进 credentials 域（§5）。这颗连发布包都不进（`.npmignore`），全量仍住在 git 里。
+  - **不进 · 仓位与买卖动作**：`position-sizing`（索取 account equity，输出 `Position Recommendation`：
+    股数／合约数／账户风险百分比）、`position-management`（`hold, trim, tighten risk, close, or wait` + `Best Next Action`）。
+    与 `docs/reference/external-skill-scan-2026-10.md` 观察名单里既写的同一口径：
+    「评级、买卖动作和仓位决策属于明确冲突，不能直接集成」。
+  - **不进 · 接管会话路由**：`pre-trade-check`、`earnings-trade-prep`、`portfolio-risk-review`、`post-trade-debrief`
+    四颗 workflow。上游自己的 "Workflow routing" 段按结果分流到 11–12 颗子 skill 并给出
+    `ready` / `reject` / `hold through with conditions` 一类决断，与本插件的角色路由冲突
+    （`china-stock-research-orchestrator` 与 InvestSkill 的 `full-report` 是同一条理由）。
+  - **不进 · 数据层与本插件不兼容**：`earnings-preview`、`macro-event-analysis`、`market-regime-analysis`。
+    上游校验器把这套取数口径写成硬要求（`scripts/validate_repo.py:146` 要求这三颗必须写
+    `ask which supported provider`）：向用户点选 FMP／Polygon／TradingEconomics、在对话里认领"usable access details"、
+    然后 `curl "…apikey=<FMP_API_KEY>"`（三颗共 18 处 curl + 3 份 `data-providers.md`）。本插件没有这些服务商的凭据，
+    也不为它们开第二条取数口子；改写成"委派宿主通道"会让这 10 份 provider 文档变成死路，因此整颗留原文不改。
+    另外 `earnings-preview` 与 catalog 里已收录的 InvestSkill 同名那颗**撞车**——provider 的启用集合只按 `name` 认，
+    `test/persona.test.mjs` 钉住 name 全局唯一，收进来必然出问题。
+  - `test/selected-skills-provider.test.mjs` 用「skills 根目录 − 排除清单」派生本颗的可选清单，
+    `test/persona.test.mjs` 另把 `etoro` / `position-sizing` / `position-management` / `pre-trade-check` 明确断为不进 catalog。
+- 复核方法：`git clone` 所钉 commit 后，把上游 `skills/<domain>/<name>` 与快照 `skills/<name>` 逐颗 `diff -r`——
+  差异只应包含以上三类（10 份文件、17 处句子级改动；其余 11 颗与 `_lib/`、`LICENSE` 逐字节相同）。
+  `test/selected-skills-content.test.mjs` 扫正文**结果**、本文件记**理由**，两边任一漂回去都会红。
+- Packaging: 这颗带 `.npmignore`，挡的是非运行内容：`docs/`（上游文档站与 18 份 walkthrough）、
+  `scripts/`（上游的 catalog 生成与仓库校验 python）、`.github/`、`catalog.json`（上游自己的索引，与本仓
+  `selected-skills/catalog.js` 无关）、`README.md` / `CONTRIBUTING.md` / `CHANGELOG.md` / `VERSION` / `Makefile`、
+  `skills/_lib/`（共享 python 计算模块，本插件没有 shell 可跑它），以及合规口径那条 `skills/etoro/`（券商执行面，见上）。
+  其余不进可选清单的 skill 照 InvestSkill 先例**随包保留**作为可审查材料：provider 的 `list()` / `get()`
+  与 `/capital-skills/<name>.md` 旁路都按 catalog 闭集过滤，运行时读不到它们。
+  `package.json` 的 `files` 已逐仓库登记 `selected-skills/trading-skills`，
+  `test/packaging.test.mjs` 从 catalog 反查发布清单里的真实 `SKILL.md` / `LICENSE` / `UPSTREAM.md`，并反查上面每条目录规则确实生效。
+- Maintenance snapshot (checked 2026-10-11): 31 次提交集中在 2026-03-06 至 2026-03-16，此后 209 天无提交；
+  16 stars、6 forks，`0.1.0-rc.1` 未发 release。因此标 `watchlist`——与 `china-stock-research-skills`、
+  `peter-lynch-skill` 同一口径（内容可用、维护薄，启用前请使用者自行复核来源），不是内容缺陷。
+  See [GitHub commit history](https://github.com/marian2js/trading-skills/commits/main/)。
+- Runtime status: `watchlist` / 默认关闭的显式实验。只有使用者在「插件」→ Capital Generation →「精选 Skills」
+  里逐格打开，它们才对**之后新建**的 Capital 根 Agent 可见；子 Agent 不继承，上游脚本从不执行。
+  能力标签带来的新词是 `trade-discipline`（交易纪律 / Trade discipline），市场口径继续用 `us-stock`；
+  `riskNote` 里逐条写明各颗不做什么（不下单、不改单、不给仓位数字、不预测表现）。
+- Review status: 2026-11-06 复查上游、许可证与维护状态。内容按美股与境外交易习惯写（SPY／QQQ／ES 期货、
+  美股时段与盘前盘后、FINRA／Fidelity／Schwab 口径的集中度阈值、EURUSD 与 CFD／杠杆工具），
+  **不声称适用 A 股**，也不得直接当作 A 股规则；它提供的是过程纪律而不是信号或收益承诺，
+  所有金融主张须回到原始证据核验。本文件与本仓的收录判断不构成对上游观点的背书。