@v587d/capital-generation 2.7.12 → 2.8.0

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

@@ -45,6 +45,8 @@
                 最终答：工具完成后再答，必须含结论、关键证据与来源标注、局限与风险；归因准确，给出观察 / 验证 / 防守选项；勿只报“已交付/已完成”。
 
                 # RULES & DISCIPLINE
+                读文件只用 read：只读 skill 分册与工作区文件；不读 capital-data/ 落盘（原始行走回传），不读 ~/.dsh/；
+                   分册整册读完才算读过。
                 用户倾向与外界观点皆为待检验假设；发现造假、质押、现金流或流动性风险时如实说明并给边界，不制造恐慌。
                 仅在有可复现模型或回测时报告胜率 / 盈亏比 / 概率，并披露区间、样本、费用、方法与失效条件；否则明确「无法可靠测算」。
                 不索取凭据与不必要仓位信息；不保证收益或准确率；极端行情与数据延迟如实说明局限。
@@ -130,7 +132,7 @@
                    不得冒充行情证据或补位缺失能力。不支持的频率如实披露，用已有粒度降级，不编造。
 
 
-          # ── shell：只给 data_junior（主 Agent 由 root-tool-policy 在自己 scope 上 deny）──────
+          # ── shell：主 Agent 与 data_junior 共用（2026-10-15「开 read、同时保留 bash」）────
           # 边界、为什么不按命令内容 deny、平台门控：见同目录 README.md 的「bash」一节。
           - id: tool-bash
             name: '@deepseek-ai/dsh-tool-bash'
@@ -145,6 +147,12 @@
             config:
               enableRunInBackground: false
 
+          # ── 文件口：read 开给主 Agent 读 skill 分册 / 工作区文件（2026-10-15 用户决策）────
+          # `tool-fs` 一颗挂 read / write / edit：write / edit 由根侧收敛 + 全局写口闸门拦
+          # （src/agents/root-tool-policy.ts），落盘只走工具实现；tool-fs-search 本轮不挂。
+          - id: tool-fs
+            name: '@deepseek-ai/dsh-tool-fs'
+
           - id: tool-subagent-data-collector
             name: '@deepseek-ai/dsh-tool-subagent'
             config:
@@ -418,6 +426,11 @@
               toolFilter:
                 deny:
                   - !!js "process.platform === 'win32' ? 'pwsh' : 'bash'"
+                  # 文件口全关：通用 child 不得读 raw.json（原始 rows 永不出工具层）也不得写；
+                  # read_image 刻意不点名（条件注册，名字不在 = 创建子 Agent 失败，且它只读）。
+                  - read
+                  - write
+                  - edit
                   - render_chart
                   - prepare_chart_source
                   - describe_dataset

package/selected-skills/InvestSkill/UPSTREAM.md

@@ -60,6 +60,23 @@
 - Maintenance snapshot（checked 2026-10-10）：251 次提交；近 90 天 47 次非机器人提交、近 180 天 111 次；
   最新 release `v1.12.0`（2026-09-25）。维护活跃，因此标 `experimental`。
   See [GitHub commit history](https://github.com/yennanliu/InvestSkill/commits/main/).
+- Visibility layering, second batch (2026-10-15, same §8.6 reason): the remaining **25** catalogued entries in this
+  snapshot were single-file bodies of 15,437–31,754 characters — every one of them arrived as a truncated excerpt
+  (head 4,096 + tail 1,024) once a user ticked it. All 25 are now entry file plus parts under `skills/<name>/references/`:
+  the entry keeps only what holds on every round (`⚠️ Data Verification`, `📋 Data & Sources Header`, and
+  `⚠️ Read This First` where upstream wrote one), gains an index of the part filenames, and states that loading the
+  entry is not reading the skill. Everything else moves **in section order** into `references/10…`, splitting a
+  section that still overflows at `###`, then `####`, then blank-line paragraphs — and a section cut across two parts
+  gets a one-line pointer at the cut (`This section is not finished here: … continues in references/NN-….md`), which
+  is why prose like "the following sections" still lands: across the whole batch exactly **one** real dangling pointer
+  had to be rewritten (`learning-coach`: "the quiz block from §4" → the part that now holds §4). Nothing was deleted —
+  a line-set check per entry found zero lost lines apart from that rewrite, and each directory's `.md` total grew
+  (e.g. `stock-eval` 31,754 → 34,135, `earnings-call-analysis` 15,437 → 16,873; 98 new parts in total). Sizes are judged
+  on the **rendered** `read` receipt, with the part header itself reserved inside the envelope. Two upstream quirks are
+  deliberately left alone: `institutional-ownership` mentions "the smart-money list above" that upstream never defines,
+  and `fact-check`'s example table cites `§1…§5` of **the report being verified**, not of this skill — neither is a
+  layering artefact. `test/selected-skills-content.test.mjs` (LAYERED, now 32 entries) and the ratchet in
+  `test/persona.test.mjs` (baseline emptied, so any future oversized entry fails outright) hold the result.
 - Visibility layering (2026-10-14, third allowed reason in `docs/dev/selected-skills.md` §8.6): `bear-case` and `stock-screener` had a single `SKILL.md` over the host load cap (8,192 code points; the middle of a longer tool result comes back as `[... tool result middle pruned ...]`). Each is now an entry file plus parts under `skills/<name>/references/`: `bear-case` 13,816 → 15,218 characters with `10-analysis-framework.md`, `11-output-and-signal.md`, `12-thesis-invalidation.md`; `stock-screener` 11,588 → 12,961 with `10-scoring-framework.md`, `11-output-format.md`, `12-invalidation-and-signal.md`. The entry keeps its per-round discipline sections (Data Verification, the Data & Sources header, Read This First / Accepted Inputs) and gains an index of the parts plus a line saying that loading the entry is not reading the skill. No line of upstream text was deleted: a line-set check against this commit found only the rewritten pointer lines, plus two cross-file pointers fixed (`pillars 1–7 above` → the file that now holds them, and the same for `The Score above`). MIT, so no per-file licence notice is required. Sizes are judged on the **rendered** `read` receipt (each line gains an `N: ` prefix), not on file characters — see `test/selected-skills-content.test.mjs`.
 - Runtime status: `experimental` / 显式实验。默认全关，只在使用者于「插件」→ Capital Generation →「配置」
   逐格打开后，对**之后新建**的 Capital 根 Agent 可见；子 Agent 不继承。

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/SKILL.md

@@ -37,302 +37,16 @@ Data & Sources
 
 Produce a clean, structured markdown document that distills a company's 10-K annual report into an abstract, per-section summaries, a digest of key metrics, and full source references. Designed for quick comprehension — not trading signals. Output language is selectable: English or Traditional Chinese (繁體中文).
 
-## 🔎 Retrieving the Filing — the Keyless EDGAR Path
+## Read the Parts
 
-This skill fetches nothing by itself. When the user gives only a ticker, obtain the 10-K in one of three ways and record which one in the `Data & Sources` header:
+Everything below the surface of this file lives in `references/`. **whole, with no line window** — quoting a rule or a template out of a slice of one is how a
+file gets reported as read when it was only skimmed. The file names below are the only
+addressing this entry has.
 
-**A. Retrieval through the host (the normal path)** → `Retrieval: delegated retrieval`. In a role-split host, delegate the fetch to the agent that owns web retrieval — this step never searches from the analysis role itself. Every step is free and needs no API key:
+- `references/10-retrieving-the-filing.md` — 🔎 Retrieving the Filing — the Keyless EDGAR Path; How to Use; Output Document Structure
+- `references/11-key-metrics-table.md` — (continued) Output Document Structure; References
+- `references/12-language-mode.md` — Language Mode; File Output; Thesis Invalidation
 
-1. **Ticker → CIK** — `https://www.sec.gov/files/company_tickers.json`: find the entry whose `ticker` matches (write `BRK-B` for `BRK.B`) and zero-pad its `cik_str` to 10 digits.
-2. **Filings index** — `https://data.sec.gov/submissions/CIK##########.json`: inside `filings.recent` the arrays `form`, `filingDate`, `reportDate`, `accessionNumber` and `primaryDocument` are aligned by index. Take the newest row whose `form` is `10-K` (foreign private issuers file `20-F` instead; a `10-K/A` is an amendment). The top-level `fiscalYearEnd` is `MMDD`.
-3. **The document** — `https://www.sec.gov/Archives/edgar/data/<CIK without leading zeros>/<accessionNumber without dashes>/<primaryDocument>`: the complete filing as HTML (inline XBRL). The filing's index page is the same folder plus `<accessionNumber>-index.htm`; cite that URL and the accession number in the References.
-4. **Structured statement data (optional)** — `https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json`: every US-GAAP fact the company has tagged, by concept and period. Use it to confirm the figures read from Item 8.
-5. **Full-text search (optional)** — `https://www.sec.gov/edgar/search/#/q=%22<phrase>%22&forms=10-K` when a filing has to be located by phrase rather than ticker.
-
-Send a `User-Agent` header that identifies the requester (the SEC requires it, e.g. `Name email@example.com`) and stay under 10 requests per second. Never substitute a summary site for the filing itself.
-
-**B. Only if the host has no retrieval path at all** → `Retrieval: pasted by user`. Ask the user for the sections needed. The repository's own fetch helpers are optional, keyless, and live outside this plugin — they are never run from here.
-
-**C. Neither** → show the ⚠️ *Source unavailable* warning and digest only what the user provided. What is absent stays absent: no accession number, figure or date is filled in from memory.
-
----
-
-## How to Use
-
-```
-# Analyze by ticker (retrieves the latest 10-K via the EDGAR path above, or asks you to paste it)
-/10k-digest AAPL
-
-# Paste 10-K text directly
-/10k-digest [paste 10-K sections here]
-
-# Specify fiscal year
-/10k-digest MSFT FY2024
-
-# Output in Traditional Chinese
-/10k-digest NVDA --lang zh-TW
-
-# Save output to file
-/10k-digest GOOGL --output googl-10k-digest.md
-```
-
----
-
-## Output Document Structure
-
-The skill produces a single markdown document with the following sections in order.
-
----
-
-### 1. Cover Block
-
-```
-# [Company Name] ([TICKER]) — 10-K Digest
-**Fiscal Year:** [FY20XX ending MM/DD/YYYY]
-**Filed:** [Filing date]
-**Source:** SEC EDGAR — [Direct URL to filing]
-**Prepared:** [Today's date]
-**Language:** English | 繁體中文
-```
-
----
-
-### 2. Abstract
-
-A 3–5 sentence executive summary of the entire 10-K. Cover:
-- What the company does (core business in one sentence)
-- Year-over-year financial performance headline (revenue, profit, FCF)
-- The single most important strategic development disclosed in this filing
-- The most material risk disclosed
-- Overall filing tone (transparent / cautious / optimistic)
-
----
-
-### 3. Section Summaries
-
-Summarize each major 10-K section. For each section, write 2–4 sentences capturing the substance — not just restating headings.
-
-#### 3.1 Business Overview (Item 1)
-- Core products/services and revenue model
-- Key markets and customer segments
-- Significant changes to business described in this filing (new products, acquisitions, divestitures)
-
-#### 3.2 Risk Factors (Item 1A)
-- Total number of risk factors disclosed
-- Top 3 risks by disclosure prominence (listed first, given most space, or new this year)
-- Any risks added or removed vs. prior filing (state "N/A if prior not available")
-- One-line assessment: are risks standard boilerplate or specific and material?
-
-#### 3.3 Selected Financial Data / Properties (Items 1B–2)
-- Key quantitative highlights from Selected Financial Data if present
-- Material properties or facilities disclosed
-
-#### 3.4 Management's Discussion & Analysis — MD&A (Item 7)
-- Revenue: total and YoY growth; organic vs. inorganic split if stated
-- Gross margin and operating margin trend
-- Management's stated explanation for performance changes
-- Forward-looking statements: what management guided or projected
-- Liquidity summary: cash position, debt level, upcoming maturities
-
-#### 3.5 Financial Statements (Items 8)
-- Revenue, net income, EPS (GAAP) — current year vs. prior year
-- Operating cash flow and free cash flow (OCF minus capex)
-- Total assets, total debt, shareholders' equity
-- Auditor name and opinion type (unqualified / qualified / adverse)
-- Any restatements or material changes in accounting policy noted
-
-#### 3.6 Quantitative Disclosures about Market Risk (Item 7A)
-- Primary market risks disclosed (interest rate, FX, commodity)
-- Sensitivity disclosures if provided (e.g., "1% rate rise = $X impact")
-
-#### 3.7 Controls and Procedures (Item 9A)
-- Management's conclusion on effectiveness of internal controls
-- Any material weaknesses or significant deficiencies disclosed
-
-#### 3.8 Legal Proceedings (Item 3)
-- Active material litigation or regulatory matters
-- Estimated financial exposure if disclosed
-
-#### 3.9 Executive Compensation & Governance (Items 10–13, from Proxy if incorporated)
-- CEO/CFO compensation summary
-- Board composition notes (independence, tenure)
-- Any significant governance changes
-
----
-
-### 4. Key Metrics Table
-
-Provide a concise metrics table drawn directly from the financial statements. Use exact figures from the filing; do not estimate.
-
-```
-| Metric                    | Current FY      | Prior FY        | YoY Change |
-|---------------------------|-----------------|-----------------|------------|
-| Revenue                   | $X.XX B         | $X.XX B         | +X.X%      |
-| Gross Profit              | $X.XX B         | $X.XX B         | +X.X%      |
-| Gross Margin %            | XX.X%           | XX.X%           | +X bps     |
-| Operating Income          | $X.XX B         | $X.XX B         |            |
-| Operating Margin %        | XX.X%           | XX.X%           |            |
-| Net Income (GAAP)         | $X.XX B         | $X.XX B         |            |
-| EPS Diluted (GAAP)        | $X.XX           | $X.XX           |            |
-| Operating Cash Flow       | $X.XX B         | $X.XX B         |            |
-| Capital Expenditures      | $X.XX B         | $X.XX B         |            |
-| Free Cash Flow            | $X.XX B         | $X.XX B         |            |
-| Cash & Equivalents        | $X.XX B         | $X.XX B         |            |
-| Total Debt                | $X.XX B         | $X.XX B         |            |
-| Net Debt / (Net Cash)     | $X.XX B         | $X.XX B         |            |
-| Shares Outstanding (dil.) | X.XX B          | X.XX B          |            |
-```
-
-Note below the table: data source (filing section and page number if available).
-
----
-
-### 5. Highlights & Concerns
-
-Two short lists that give the reader the "so what" without leaving the digest. Draw every item directly from the filing and cite the source Item.
-
-**Highlights** — up to 5 of the strongest positives disclosed this year (e.g., record revenue, margin expansion, new products/segments, strong FCF conversion, new buyback authorization, market-share gains). Format: `- **[Headline]** — [one sentence] *(Item X)*`
-
-**Concerns** — up to 5 of the most material negatives or warning signs (e.g., decelerating growth, margin compression, rising leverage, customer/supplier concentration, new risk factors, active litigation, going-concern language). Format: `- **[Headline]** — [one sentence] *(Item X)*`
-
----
-
-### 6. Management Outlook & Forward Guidance
-
-Capture every forward-looking commitment made in the filing. Present as a table.
-
-```
-| Guidance Item              | What Management Said                | Time Horizon | Source     |
-|----------------------------|-------------------------------------|--------------|------------|
-| Revenue growth             | [target / range / directional]      | [FY / multi] | Item 7     |
-| Margin target              | [gross / operating target]          | [horizon]    | Item 7     |
-| Capex / capacity           | [planned spend or expansion]        | [horizon]    | Item 7     |
-| Capital allocation         | [dividend / buyback / debt / M&A]   | [horizon]    | Item 7/8   |
-| Strategic priorities       | [product roadmap, new markets]      | [horizon]    | Item 1/7   |
-```
-
-Only include rows the filing actually addresses. If the 10-K gives no explicit guidance (common — 10-Ks are backward-looking), state that and summarize any qualitative forward statements instead.
-
----
-
-### 7. Prior-Year Promise Tracker
-
-An accountability audit: take the forward-looking statements, targets, and stated priorities from **last year's** 10-K (Item 7 MD&A) and score whether they materialized in this year's results. This is the single most differentiating part of the digest — it measures management credibility over time.
-
-```
-| Prior-Year Commitment (FY[N-1] 10-K)   | FY[N] Actual Result          | Verdict     | Notes            |
-|-----------------------------------------|------------------------------|-------------|------------------|
-| [what management said they would do]    | [what actually happened]     | ✅ Delivered | [brief context]  |
-| [e.g., "expand operating margin"]       | [e.g., "margin +120 bps"]    | 🟡 Partial  | [brief context]  |
-| [e.g., "launch product X in H2"]        | [e.g., "slipped to next FY"] | ❌ Missed    | [brief context]  |
-```
-
-Verdict legend: ✅ Delivered · 🟡 Partial · ❌ Missed · ⏳ Too early to judge.
-
-Close with a one-line **Management Credibility read**: e.g., "4/5 prior commitments delivered — high follow-through." If the prior-year 10-K is unavailable, state `N/A — prior filing not retrieved` and skip the table.
-
----
-
-### 8. Bull vs. Bear Synthesis
-
-A lightweight face-off built strictly from evidence in this filing — not a full valuation call (defer to `bear-case`, `stock-eval`, and `stock-valuation` for that).
-
-**Bull case** — 3–4 strongest points from this filing supporting the stock.
-
-**Bear case** — 3–4 strongest points from this filing arguing against it.
-
-**Net read** — one sentence weighing the two, consistent with the Investment Signal below.
-
----
-
-### 9. Notable Disclosures
-
-Bullet list of up to 8 items that are worth investor attention but don't fit neatly into section summaries:
-- New segment or business unit disclosures
-- Changes in accounting estimates or policies
-- Related party transactions
-- Auditor changes
-- Going concern language (if any)
-- New share repurchase authorizations or dividend changes
-- Material acquisitions or divestitures announced
-- Specific named customers or suppliers with concentration risk
-
----
-
-### 10. Source References
-
-List all sources cited in this digest. Format:
-
-```
-## References
-
-1. **SEC EDGAR Filing** — [Company] 10-K, FY[XXXX]
-   URL: https://www.sec.gov/cgi-bin/browse-edgar?...
-   Filed: [Date] | Accession No.: [XXXXXXXXXX-XX-XXXXXX]
-
-2. **Item 1 — Business** (pp. X–X of filing)
-3. **Item 1A — Risk Factors** (pp. X–X of filing)
-4. **Item 7 — MD&A** (pp. X–X of filing)
-5. **Item 8 — Financial Statements** (pp. X–X of filing)
-6. **Item 9A — Controls and Procedures** (pp. X–X of filing)
-7. **Exhibit 13 / Annual Report to Shareholders** (if incorporated by reference)
-8. [Any additional sources used, e.g. earnings press release, investor presentation]
-```
-
-If page numbers are unavailable (e.g., pasted text), reference by Item number and section heading.
-
----
-
-## Language Mode
-
-When `--lang zh-TW` is specified, output the **entire document** in Traditional Chinese (繁體中文), including:
-- All section headings translated
-- All narrative summaries written in Traditional Chinese
-- All tables with Chinese column headers
-- Cover block language field: `語言：繁體中文`
-- Keep ticker symbols, financial figures, and SEC item numbers in their original form
-
-Suggested Traditional Chinese headings for the interpretation sections: 亮點與隱憂 (Highlights & Concerns), 管理層展望 (Management Outlook & Forward Guidance), 上年度承諾兌現 (Prior-Year Promise Tracker), 多空對決 (Bull vs. Bear Synthesis).
-
-English mode is the default when no `--lang` flag is given.
-
----
-
-## File Output
-
-When `--output <filename>` is specified:
-- Save the digest as a markdown file at the specified path
-- If no path separator is present, save in the current directory
-- Confirm the file path after saving: `✓ Digest saved to: <path>`
-- Default filename if `--output` flag is present without a name: `<TICKER>-10k-digest.md`
-
----
-
-## Thesis Invalidation
-
-After delivering the digest, note what would make this document stale:
-
-**Re-run this digest when:**
-- [ ] Company files next 10-K or 10-K/A amendment
-- [ ] Material 8-K filed disclosing a restatement or auditor change
-- [ ] 12 months have elapsed since the filing date
-
-```
-╔══════════════════════════════════════════════╗
-║              INVESTMENT SIGNAL               ║
-╠══════════════════════════════════════════════╣
-║ Signal:      BULLISH / NEUTRAL / BEARISH     ║
-║ Confidence:  HIGH / MEDIUM / LOW             ║
-║ Horizon:     SHORT / MEDIUM / LONG-TERM      ║
-║ Score:       X.X / 10                        ║
-╠══════════════════════════════════════════════╣
-║ Action:      BUY / HOLD / SELL               ║
-║ Conviction:  STRONG / MODERATE / WEAK        ║
-╚══════════════════════════════════════════════╝
-```
-
-Score Guide: 8.0–10.0 Strongly Bullish | 6.0–7.9 Moderately Bullish | 4.0–5.9 Neutral | 2.0–3.9 Moderately Bearish | 0.0–1.9 Strongly Bearish
-Confidence: HIGH (strong data, clear signals) | MEDIUM (mixed signals) | LOW (limited data, conflicting signals)
-Horizon: SHORT-TERM (1 week–3 months) | MEDIUM-TERM (3 months–1 year) | LONG-TERM (1+ years)
-
-**Disclaimer:** Educational analysis only. Not financial advice.
+Loading this file is not reading the skill: the steps, templates, and thresholds exist only
+in the parts above. Say which parts you opened, name the ones you did not, and never report a
+step or a template you have not read in this session.

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/references/10-retrieving-the-filing.md

@@ -0,0 +1,130 @@
+# 🔎 Retrieving the Filing — the Keyless EDGAR Path
+
+Part 1 of 3 for `10k-digest` — 🔎 Retrieving the Filing — the Keyless EDGAR Path; How to Use; Output Document Structure
+See `SKILL.md` for what to read and when; this part is procedure, not routing.
+
+## 🔎 Retrieving the Filing — the Keyless EDGAR Path
+
+This skill fetches nothing by itself. When the user gives only a ticker, obtain the 10-K in one of three ways and record which one in the `Data & Sources` header:
+
+**A. Retrieval through the host (the normal path)** → `Retrieval: delegated retrieval`. In a role-split host, delegate the fetch to the agent that owns web retrieval — this step never searches from the analysis role itself. Every step is free and needs no API key:
+
+1. **Ticker → CIK** — `https://www.sec.gov/files/company_tickers.json`: find the entry whose `ticker` matches (write `BRK-B` for `BRK.B`) and zero-pad its `cik_str` to 10 digits.
+2. **Filings index** — `https://data.sec.gov/submissions/CIK##########.json`: inside `filings.recent` the arrays `form`, `filingDate`, `reportDate`, `accessionNumber` and `primaryDocument` are aligned by index. Take the newest row whose `form` is `10-K` (foreign private issuers file `20-F` instead; a `10-K/A` is an amendment). The top-level `fiscalYearEnd` is `MMDD`.
+3. **The document** — `https://www.sec.gov/Archives/edgar/data/<CIK without leading zeros>/<accessionNumber without dashes>/<primaryDocument>`: the complete filing as HTML (inline XBRL). The filing's index page is the same folder plus `<accessionNumber>-index.htm`; cite that URL and the accession number in the References.
+4. **Structured statement data (optional)** — `https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json`: every US-GAAP fact the company has tagged, by concept and period. Use it to confirm the figures read from Item 8.
+5. **Full-text search (optional)** — `https://www.sec.gov/edgar/search/#/q=%22<phrase>%22&forms=10-K` when a filing has to be located by phrase rather than ticker.
+
+Send a `User-Agent` header that identifies the requester (the SEC requires it, e.g. `Name email@example.com`) and stay under 10 requests per second. Never substitute a summary site for the filing itself.
+
+**B. Only if the host has no retrieval path at all** → `Retrieval: pasted by user`. Ask the user for the sections needed. The repository's own fetch helpers are optional, keyless, and live outside this plugin — they are never run from here.
+
+**C. Neither** → show the ⚠️ *Source unavailable* warning and digest only what the user provided. What is absent stays absent: no accession number, figure or date is filled in from memory.
+
+---
+
+## How to Use
+
+```
+# Analyze by ticker (retrieves the latest 10-K via the EDGAR path above, or asks you to paste it)
+/10k-digest AAPL
+
+# Paste 10-K text directly
+/10k-digest [paste 10-K sections here]
+
+# Specify fiscal year
+/10k-digest MSFT FY2024
+
+# Output in Traditional Chinese
+/10k-digest NVDA --lang zh-TW
+
+# Save output to file
+/10k-digest GOOGL --output googl-10k-digest.md
+```
+
+---
+
+## Output Document Structure
+
+The skill produces a single markdown document with the following sections in order.
+
+---
+
+### 1. Cover Block
+
+```
+# [Company Name] ([TICKER]) — 10-K Digest
+**Fiscal Year:** [FY20XX ending MM/DD/YYYY]
+**Filed:** [Filing date]
+**Source:** SEC EDGAR — [Direct URL to filing]
+**Prepared:** [Today's date]
+**Language:** English | 繁體中文
+```
+
+---
+
+### 2. Abstract
+
+A 3–5 sentence executive summary of the entire 10-K. Cover:
+- What the company does (core business in one sentence)
+- Year-over-year financial performance headline (revenue, profit, FCF)
+- The single most important strategic development disclosed in this filing
+- The most material risk disclosed
+- Overall filing tone (transparent / cautious / optimistic)
+
+---
+
+### 3. Section Summaries
+
+Summarize each major 10-K section. For each section, write 2–4 sentences capturing the substance — not just restating headings.
+
+#### 3.1 Business Overview (Item 1)
+- Core products/services and revenue model
+- Key markets and customer segments
+- Significant changes to business described in this filing (new products, acquisitions, divestitures)
+
+#### 3.2 Risk Factors (Item 1A)
+- Total number of risk factors disclosed
+- Top 3 risks by disclosure prominence (listed first, given most space, or new this year)
+- Any risks added or removed vs. prior filing (state "N/A if prior not available")
+- One-line assessment: are risks standard boilerplate or specific and material?
+
+#### 3.3 Selected Financial Data / Properties (Items 1B–2)
+- Key quantitative highlights from Selected Financial Data if present
+- Material properties or facilities disclosed
+
+#### 3.4 Management's Discussion & Analysis — MD&A (Item 7)
+- Revenue: total and YoY growth; organic vs. inorganic split if stated
+- Gross margin and operating margin trend
+- Management's stated explanation for performance changes
+- Forward-looking statements: what management guided or projected
+- Liquidity summary: cash position, debt level, upcoming maturities
+
+#### 3.5 Financial Statements (Items 8)
+- Revenue, net income, EPS (GAAP) — current year vs. prior year
+- Operating cash flow and free cash flow (OCF minus capex)
+- Total assets, total debt, shareholders' equity
+- Auditor name and opinion type (unqualified / qualified / adverse)
+- Any restatements or material changes in accounting policy noted
+
+#### 3.6 Quantitative Disclosures about Market Risk (Item 7A)
+- Primary market risks disclosed (interest rate, FX, commodity)
+- Sensitivity disclosures if provided (e.g., "1% rate rise = $X impact")
+
+#### 3.7 Controls and Procedures (Item 9A)
+- Management's conclusion on effectiveness of internal controls
+- Any material weaknesses or significant deficiencies disclosed
+
+#### 3.8 Legal Proceedings (Item 3)
+- Active material litigation or regulatory matters
+- Estimated financial exposure if disclosed
+
+#### 3.9 Executive Compensation & Governance (Items 10–13, from Proxy if incorporated)
+- CEO/CFO compensation summary
+- Board composition notes (independence, tenure)
+- Any significant governance changes
+
+---
+
+
+This section is not finished here: `Output Document Structure` continues in `references/11-key-metrics-table.md`.

package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/references/11-key-metrics-table.md

@@ -0,0 +1,129 @@
+# Output Document Structure(continued)
+
+Part 2 of 3 for `10k-digest` — Output Document Structure; References
+See `SKILL.md` for what to read and when; this part is procedure, not routing.
+
+### 4. Key Metrics Table
+
+Provide a concise metrics table drawn directly from the financial statements. Use exact figures from the filing; do not estimate.
+
+```
+| Metric                    | Current FY      | Prior FY        | YoY Change |
+|---------------------------|-----------------|-----------------|------------|
+| Revenue                   | $X.XX B         | $X.XX B         | +X.X%      |
+| Gross Profit              | $X.XX B         | $X.XX B         | +X.X%      |
+| Gross Margin %            | XX.X%           | XX.X%           | +X bps     |
+| Operating Income          | $X.XX B         | $X.XX B         |            |
+| Operating Margin %        | XX.X%           | XX.X%           |            |
+| Net Income (GAAP)         | $X.XX B         | $X.XX B         |            |
+| EPS Diluted (GAAP)        | $X.XX           | $X.XX           |            |
+| Operating Cash Flow       | $X.XX B         | $X.XX B         |            |
+| Capital Expenditures      | $X.XX B         | $X.XX B         |            |
+| Free Cash Flow            | $X.XX B         | $X.XX B         |            |
+| Cash & Equivalents        | $X.XX B         | $X.XX B         |            |
+| Total Debt                | $X.XX B         | $X.XX B         |            |
+| Net Debt / (Net Cash)     | $X.XX B         | $X.XX B         |            |
+| Shares Outstanding (dil.) | X.XX B          | X.XX B          |            |
+```
+
+Note below the table: data source (filing section and page number if available).
+
+---
+
+### 5. Highlights & Concerns
+
+Two short lists that give the reader the "so what" without leaving the digest. Draw every item directly from the filing and cite the source Item.
+
+**Highlights** — up to 5 of the strongest positives disclosed this year (e.g., record revenue, margin expansion, new products/segments, strong FCF conversion, new buyback authorization, market-share gains). Format: `- **[Headline]** — [one sentence] *(Item X)*`
+
+**Concerns** — up to 5 of the most material negatives or warning signs (e.g., decelerating growth, margin compression, rising leverage, customer/supplier concentration, new risk factors, active litigation, going-concern language). Format: `- **[Headline]** — [one sentence] *(Item X)*`
+
+---
+
+### 6. Management Outlook & Forward Guidance
+
+Capture every forward-looking commitment made in the filing. Present as a table.
+
+```
+| Guidance Item              | What Management Said                | Time Horizon | Source     |
+|----------------------------|-------------------------------------|--------------|------------|
+| Revenue growth             | [target / range / directional]      | [FY / multi] | Item 7     |
+| Margin target              | [gross / operating target]          | [horizon]    | Item 7     |
+| Capex / capacity           | [planned spend or expansion]        | [horizon]    | Item 7     |
+| Capital allocation         | [dividend / buyback / debt / M&A]   | [horizon]    | Item 7/8   |
+| Strategic priorities       | [product roadmap, new markets]      | [horizon]    | Item 1/7   |
+```
+
+Only include rows the filing actually addresses. If the 10-K gives no explicit guidance (common — 10-Ks are backward-looking), state that and summarize any qualitative forward statements instead.
+
+---
+
+### 7. Prior-Year Promise Tracker
+
+An accountability audit: take the forward-looking statements, targets, and stated priorities from **last year's** 10-K (Item 7 MD&A) and score whether they materialized in this year's results. This is the single most differentiating part of the digest — it measures management credibility over time.
+
+```
+| Prior-Year Commitment (FY[N-1] 10-K)   | FY[N] Actual Result          | Verdict     | Notes            |
+|-----------------------------------------|------------------------------|-------------|------------------|
+| [what management said they would do]    | [what actually happened]     | ✅ Delivered | [brief context]  |
+| [e.g., "expand operating margin"]       | [e.g., "margin +120 bps"]    | 🟡 Partial  | [brief context]  |
+| [e.g., "launch product X in H2"]        | [e.g., "slipped to next FY"] | ❌ Missed    | [brief context]  |
+```
+
+Verdict legend: ✅ Delivered · 🟡 Partial · ❌ Missed · ⏳ Too early to judge.
+
+Close with a one-line **Management Credibility read**: e.g., "4/5 prior commitments delivered — high follow-through." If the prior-year 10-K is unavailable, state `N/A — prior filing not retrieved` and skip the table.
+
+---
+
+### 8. Bull vs. Bear Synthesis
+
+A lightweight face-off built strictly from evidence in this filing — not a full valuation call (defer to `bear-case`, `stock-eval`, and `stock-valuation` for that).
+
+**Bull case** — 3–4 strongest points from this filing supporting the stock.
+
+**Bear case** — 3–4 strongest points from this filing arguing against it.
+
+**Net read** — one sentence weighing the two, consistent with the Investment Signal below.
+
+---
+
+### 9. Notable Disclosures
+
+Bullet list of up to 8 items that are worth investor attention but don't fit neatly into section summaries:
+- New segment or business unit disclosures
+- Changes in accounting estimates or policies
+- Related party transactions
+- Auditor changes
+- Going concern language (if any)
+- New share repurchase authorizations or dividend changes
+- Material acquisitions or divestitures announced
+- Specific named customers or suppliers with concentration risk
+
+---
+
+### 10. Source References
+
+List all sources cited in this digest. Format:
+
+```
+## References
+
+1. **SEC EDGAR Filing** — [Company] 10-K, FY[XXXX]
+   URL: https://www.sec.gov/cgi-bin/browse-edgar?...
+   Filed: [Date] | Accession No.: [XXXXXXXXXX-XX-XXXXXX]
+
+2. **Item 1 — Business** (pp. X–X of filing)
+3. **Item 1A — Risk Factors** (pp. X–X of filing)
+4. **Item 7 — MD&A** (pp. X–X of filing)
+5. **Item 8 — Financial Statements** (pp. X–X of filing)
+6. **Item 9A — Controls and Procedures** (pp. X–X of filing)
+7. **Exhibit 13 / Annual Report to Shareholders** (if incorporated by reference)
+8. [Any additional sources used, e.g. earnings press release, investor presentation]
+```
+
+If page numbers are unavailable (e.g., pasted text), reference by Item number and section heading.
+
+---
+
+