opencode-skills-collection 4.1.15 → 4.1.17

package/bundled-skills/longbridge-content/references/sec-filings.md

@@ -0,0 +1,113 @@
+# longbridge-sec-filings
+
+Prompt-only analysis skill. Retrieves SEC filings via Longbridge and extracts investment-relevant signals: financial KPIs (10-K/10-Q), material events (8-K), governance/compensation (Proxy), and insider behaviour (Form 4).
+
+## CLI
+
+Run `longbridge <subcommand> --help` to verify exact flags.
+
+```bash
+# List recent filings for a symbol
+longbridge filing <SYMBOL> --format json
+
+# Filter by filing type (if supported — verify with --help)
+longbridge filing <SYMBOL> --type 10-K --format json
+longbridge filing <SYMBOL> --type 10-Q --format json
+longbridge filing <SYMBOL> --type 8-K  --format json
+
+# Financial data (structured KPIs from filings)
+longbridge financial-report <SYMBOL> --format json
+
+# News — supplement for 8-K summaries and insider trade coverage
+longbridge news <SYMBOL> --format json
+```
+
+## Filing type guide
+
+| Filing          | Frequency      | Key content                                                 | Investment signal              |
+| --------------- | -------------- | ----------------------------------------------------------- | ------------------------------ |
+| 10-K            | Annual         | Full financials, Risk Factors, MD&A, auditor opinion        | Baseline quality, hidden risks |
+| 10-Q            | Quarterly      | Interim financials, MD&A updates, legal proceedings         | Trend vs prior quarters        |
+| 8-K             | Ad hoc         | Material events: earnings, M&A, exec changes, defaults      | Immediate catalyst             |
+| Proxy (DEF 14A) | Annual         | Exec compensation, board composition, shareholder proposals | Governance quality             |
+| Form 4          | Within 2 days  | Insider buy/sell transactions (officers/directors)          | Insider sentiment signal       |
+| SC 13G/13D      | On crossing 5% | Large investor disclosures                                  | Block-holder moves             |
+
+## Workflow
+
+1. **Identify filing type** from the user's question; default to most recent filing if unspecified.
+2. **Fetch filings list** with `longbridge filing <SYMBOL>`, select the relevant entry.
+3. **Fetch financial KPIs** with `longbridge financial-report` for structured numbers.
+4. **Supplement with news** (`longbridge news`) for 8-K summaries or insider trade narratives if filing detail is sparse.
+5. **Extract key items** per filing type (see extraction guide below).
+6. **Output** structured analysis (template below). Cite Longbridge Securities.
+
+## Extraction guide by filing type
+
+### 10-K / 10-Q
+
+- Revenue, net income, EPS vs prior period
+- Gross/operating margin trend
+- Free cash flow
+- Key risk factors (new risks added or escalated language)
+- MD&A: management commentary on performance drivers
+- Non-recurring items (impairments, restructuring, gains on asset sales)
+- Debt and liquidity (cash, revolver capacity)
+
+### 8-K
+
+- Event type (Item number: 1.01=material agreement, 2.02=earnings, 5.02=exec change, etc.)
+- Material fact in 2–3 sentences
+- Bull/bear interpretation
+
+### Proxy (DEF 14A)
+
+- CEO total comp vs prior year and vs peers
+- Performance metrics in comp plan (revenue, TSR, EPS targets)
+- Board independence and audit committee composition
+- Shareholder proposals (activist items)
+
+### Form 4
+
+- Filer: name and title
+- Transaction: buy vs sell, shares, price, date
+- Post-transaction ownership
+- Pattern: first purchase, cluster selling near highs, 10b5-1 plan flag
+
+## Output template
+
+```
+{Symbol} {Filing type} analysis — Source: Longbridge Securities
+
+[Filing metadata]
+- Form: {type}  |  Filed: {date}  |  Period: {period}
+
+[Key findings]
+1. {Finding — max 2 sentences}
+2. {Finding}
+3. {Finding}
+
+[Financial snapshot] (10-K / 10-Q)
+- Revenue: ${X}  YoY: {+/-X%}
+- Net income: ${X}  |  EPS: ${X}
+- Free cash flow: ${X}
+- Non-recurring: {describe or "none identified"}
+
+[Risk factors / MD&A highlights] (10-K / 10-Q)
+- New or escalated risks: {list}
+- Management tone: {cautious / neutral / optimistic}
+
+[Investment signal]
+{Bullish / Bearish / Neutral} — {1-sentence rationale}
+
+⚠️ 以上分析仅供参考，不构成投资建议。/ 以上分析僅供參考，不構成投資建議。/ For reference only. Not investment advice.
+```
+
+## Error handling
+
+| Situation                       | 简体回复                                         | 繁體回復                                         | English reply                                                                   |
+| ------------------------------- | ------------------------------------------------ | ------------------------------------------------ | ------------------------------------------------------------------------------- |
+| `command not found: longbridge` | 切换到 MCP；若不可用，请安装 longbridge-terminal | 切換至 MCP；若不可用，請安裝 longbridge-terminal | Fall back to MCP; if unavailable, install longbridge-terminal                   |
+| stderr `not logged in`          | 请执行 `longbridge auth login`                   | 請執行 `longbridge auth login`                   | Run `longbridge auth login`                                                     |
+| `filing` returns empty          | 暂无 SEC 申报数据；尝试 `longbridge news` 补充   | 暫無 SEC 申報數據；嘗試 `longbridge news` 補充   | No filing data available; try `longbridge news` as supplement                   |
+| Non-US symbol requested         | SEC 申报仅适用于美股；港股/A股请改用相应披露渠道 | SEC 申報僅適用於美股；港股/A股請改用相應披露渠道 | SEC filings are US-listed only; for HK/A-share use relevant disclosure channels |

package/bundled-skills/longbridge-content/references/topic.md

@@ -0,0 +1,53 @@
+# topic
+
+```
+Community discussion topics
+
+Without subcommand: lists topics for a symbol. Subcommands: list  detail  mine  create  replies  create-reply  search Example: longbridge topic TSLA.US Example: longbridge topic list TSLA.US Example: longbridge topic detail 6993508780031016960 Example: longbridge topic create --body "Bullish on TSLA today" Example: longbridge topic search TSLA
+
+Usage: longbridge topic [OPTIONS] [SYMBOL] [COMMAND]
+
+Commands:
+  detail        Get full details of a community topic by its ID
+  mine          Topics created by the authenticated user
+  create        Publish a new community discussion topic
+  replies       List replies for a community topic (paginated)
+  create-reply  Post a reply to a community topic
+  search        Search community topics by keyword
+  help          Print this message or the help of the given subcommand(s)
+
+Arguments:
+  [SYMBOL]
+          Symbol in <CODE>.<MARKET> format (e.g. TSLA.US 700.HK). Omit when using a subcommand
+
+Options:
+      --count <COUNT>
+          Maximum number of topics to show (default: 20)
+
+          [default: 20]
+
+      --format <FORMAT>
+          Output format: 'pretty' for human-readable, 'json' for AI agents and scripting
+
+          [default: pretty]
+          [possible values: table, json]
+
+  -v, --verbose
+          Print verbose request info (host, elapsed) to stderr, prefixed with `*` like curl -v
+
+      --lang <LANG>
+          Language for content fetched from longbridge.com: zh-CN or en. Defaults to system LANG env var, then en
+
+  -h, --help
+          Print help (see a summary with '-h')
+```
+
+## Usage
+
+```bash
+# Run with JSON output for AI agents
+longbridge topic --format json
+
+# See all options
+longbridge topic --help
+```

package/bundled-skills/longbridge-fundamentals/SKILL.md

@@ -9,6 +9,9 @@ date_added: 2026-07-01
 license: MIT
 license_source: https://github.com/longbridge/skills/blob/main/LICENSE
 ---
+## Bundled upstream support
+
+Supporting files are included at skill-relative paths. See [UPSTREAM-NOTICE.md](UPSTREAM-NOTICE.md) for their pinned sources, licenses, hashes, and import changes.
 
 # Longbridge Fundamentals
 

package/bundled-skills/longbridge-fundamentals/UPSTREAM-LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Longbridge Inc.
+
+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/bundled-skills/longbridge-fundamentals/UPSTREAM-NOTICE.md

@@ -0,0 +1,31 @@
+# Upstream helpers for longbridge-fundamentals
+
+The files listed below were recovered from [longbridge/skills](https://github.com/longbridge/skills) at commit `66f45635ac0c7000b714ed0f34ab400b6818be74`. The repository ID is `1224163986`.
+
+They retain the upstream **MIT** license reproduced in [UPSTREAM-LICENSE.txt](UPSTREAM-LICENSE.txt). This notice applies to the listed support files; it does not replace the license metadata of other catalog files. Preserve the upstream license and this attribution when redistributing them.
+
+License wording is unchanged; text-only trailing whitespace and EOF blank lines are normalized. Original license: https://github.com/longbridge/skills/blob/66f45635ac0c7000b714ed0f34ab400b6818be74/LICENSE
+
+| Local file | Original upstream path | Original Git blob SHA | Import changes |
+| --- | --- | --- | --- |
+| `references/financial-report.md` | `skills/longbridge-fundamentals/references/financial-report.md` | `aa6291be31f70328cc855ef652ef1c2714a61e79` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/business-segments.md` | `skills/longbridge-fundamentals/references/business-segments.md` | `2dbbfb398458d277c4740e3f6c62c91204bf326c` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/dividend.md` | `skills/longbridge-fundamentals/references/dividend.md` | `abfd39e13b27f2496d4a2a33745753de75f2866e` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/valuation.md` | `skills/longbridge-fundamentals/references/valuation.md` | `e961a83a3947e1c415462f7064dfbb206641d2ac` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/industry-valuation.md` | `skills/longbridge-fundamentals/references/industry-valuation.md` | `4f1bea00841f40e852e288c096f7301034e70ea2` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/operating.md` | `skills/longbridge-fundamentals/references/operating.md` | `d869bc23a95d1258feff8de30bc7235eb0fba2b3` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/corp-action.md` | `skills/longbridge-fundamentals/references/corp-action.md` | `a757a34b1f07e36a18628d3c397ce347d8c97ede` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/company.md` | `skills/longbridge-fundamentals/references/company.md` | `d153d978d832f2c8e0b299e974bdf95eccca0da6` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/invest-relation.md` | `skills/longbridge-fundamentals/references/invest-relation.md` | `7931d46df230f96cc14c3d660d9c469da848077c` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/valuation-rank.md` | `skills/longbridge-fundamentals/references/valuation-rank.md` | `ccb5293a4bd9607cdfbed12a6b6f4f2f95634fd2` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/compare.md` | `skills/longbridge-fundamentals/references/compare.md` | `571438b74f96ed15d4247ec6fec7ed5773ce1bd2` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/financial-statement.md` | `skills/longbridge-fundamentals/references/financial-statement.md` | `42bdaaf454138e3c9998e11c82acb8186550d5a6` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/executive.md` | `skills/longbridge-fundamentals/references/executive.md` | `70381c0cd27f3d6dc04fcc7ddb3d14878dd490e2` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/corporate.md` | `skills/longbridge-fundamentals/references/corporate.md` | `9246a6503e9c3c8d58a9c2f69a803b2dc54a3e1e` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/corporate-events.md` | `skills/longbridge-fundamentals/references/corporate-events.md` | `68219da8c5dcce7589bd760c9da8d7e763c6e53a` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/dcf.md` | `skills/longbridge-fundamentals/references/dcf.md` | `b15a6201d82643651329e0069966591766e35db8` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/valuation-methodology.md` | `skills/longbridge-fundamentals/references/valuation-methodology.md` | `4ca11c6e8f9afabd1c87a4ef87ebf0f9e1b0a73f` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/behavioral-finance.md` | `skills/longbridge-fundamentals/references/behavioral-finance.md` | `0615b0da9fe1776f8e59b6acd6fb46412a8fb815` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/value-screen.md` | `skills/longbridge-fundamentals/references/value-screen.md` | `d5566b79d1c05952f2657b777b1840bf79d9a7a6` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/smallcap-growth.md` | `skills/longbridge-fundamentals/references/smallcap-growth.md` | `6d25624de7dc94e004d57f651e5492522ec4c91a` | text-only trailing whitespace and EOF blank lines normalized |
+| `references/main-business-analysis.md` | `skills/longbridge-fundamentals/references/main-business-analysis.md` | `1d9573da5d865cf7e0c0200d2328323727f56bb6` | text-only trailing whitespace and EOF blank lines normalized |

package/bundled-skills/longbridge-fundamentals/references/behavioral-finance.md

@@ -0,0 +1,108 @@
+# longbridge-behavioral-finance
+
+Apply behavioral finance theory to identify exploitable market inefficiencies — map common cognitive biases to measurable price/volume patterns using Longbridge data.
+
+## Bias catalogue and tradeable signals
+
+### 1. Overreaction (过度反应)
+
+**Theory**: Investors overweight recent bad/good news, pushing prices beyond fundamental value. De Bondt & Thaler (1985).
+
+**Signal**: Long-term reversal. Stocks down 30–50% over 12M outperform over the next 12M; top performers underperform.
+
+**Detect**:
+
+```bash
+longbridge kline <SYMBOL> --period day --count 252 --format json
+```
+
+Compare 12M return vs peer group. If a stock is in the bottom 10% of sector returns, screen for reversal setup.
+
+### 2. Underreaction (反应不足)
+
+**Theory**: Investors are slow to update beliefs; price drifts gradually toward fair value after earnings surprises.
+
+**Signal**: Post-earnings announcement drift (PEAD). Buy after positive earnings surprise; price continues rising for 1–3 months.
+
+**Detect**: Use `longbridge-earnings` to identify beats. Track price drift with `longbridge kline --period day --count 60`.
+
+### 3. Disposition Effect (处置效应)
+
+**Theory**: Investors sell winners too early and hold losers too long (Shefrin & Statman, 1985).
+
+**Market impact**: Selling pressure on recent winners creates resistance near recent highs; support near cost basis concentrations.
+
+**Detect**: High capital inflows after a price surge = retail profit-taking.
+
+```bash
+longbridge capital <SYMBOL> --format json
+```
+
+### 4. Anchoring Bias (锚定效应)
+
+**Theory**: Investors anchor to arbitrary reference prices (52-week high, IPO price, round numbers).
+
+**Signal**: 52-week high breakout tends to persist (stocks resist breaking prior highs but accelerate once broken).
+
+**Detect**: Fetch 52-week high from `longbridge calc-index <SYMBOL> --format json` or static data.
+
+### 5. Herding (羊群效应)
+
+**Theory**: Investors follow the crowd, amplifying trends beyond fundamentals.
+
+**Signal**: Abnormal volume + price acceleration without fundamental catalyst = herding. Also: analyst consensus clustering.
+
+**Detect**:
+
+```bash
+longbridge market-temp --format json          # Market sentiment index 0-100
+longbridge capital <SYMBOL> --format json     # Capital flow concentration
+```
+
+If market temperature > 80 and a single sector dominates capital inflow → herding warning.
+
+### 6. Overconfidence (过度自信)
+
+**Theory**: Investors overestimate precision of their forecasts, leading to under-diversification and excess trading.
+
+**Market impact**: High turnover in bull markets; individual stocks show higher volatility than fundamentals justify.
+
+**Detect**: Turnover rate spike from `longbridge quote <SYMBOL> --format json` (turnover_rate field).
+
+## Workflow
+
+1. Identify which bias the user is asking about (or scan all six).
+2. Fetch relevant data (kline / market-temp / capital flow).
+3. Map observed price/volume pattern to the bias.
+4. Quantify signal strength: magnitude, duration, persistence.
+5. Suggest a trading implication (entry / exit / avoid) with explicit caveats.
+
+## CLI
+
+```bash
+longbridge kline --help
+longbridge market-temp --help
+longbridge capital --help
+
+longbridge market-temp --format json
+longbridge kline <SYMBOL> --period day --count 60 --format json
+longbridge capital <SYMBOL> --format json
+```
+
+## Output
+
+Present:
+
+1. Identified bias and academic basis.
+2. Observable evidence from Longbridge data (specific numbers).
+3. Tradeable implication (signal direction, horizon, conviction).
+4. Risks: when the bias does not persist (e.g. mean-reversion fails in trending markets).
+5. Disclaimer: behavioral signals are probabilistic, not deterministic.
+
+## Error handling
+
+| Situation                       | 简体回复                                           | 繁體回覆                                     | English reply                                                        |
+| ------------------------------- | -------------------------------------------------- | -------------------------------------------- | -------------------------------------------------------------------- |
+| `command not found: longbridge` | 请安装 longbridge-terminal 或检查 MCP 配置。       | 請安裝 longbridge-terminal 或檢查 MCP 配置。 | Install longbridge-terminal or check MCP config.                     |
+| stderr: `not logged in`         | 请运行 `longbridge auth login`。                   | 請執行 `longbridge auth login`。             | Run `longbridge auth login`.                                         |
+| Insufficient price history      | 历史数据不足，无法可靠识别偏差信号，请延长观察期。 | 歷史數據不足，請延長觀察期。                 | Insufficient history to identify bias reliably; extend the lookback. |

package/bundled-skills/longbridge-fundamentals/references/business-segments.md

@@ -0,0 +1,50 @@
+# business-segments
+
+```
+Business segment revenue breakdown for a symbol
+
+Without --history: returns the current-period segment composition. With --history: returns historical segment trends by period and category.
+
+Example: longbridge business-segments AAPL.US Example: longbridge business-segments AAPL.US --history --report qf
+
+Usage: longbridge business-segments [OPTIONS] <SYMBOL>
+
+Arguments:
+  <SYMBOL>
+          Symbol in <CODE>.<MARKET> format
+
+Options:
+      --history
+          Fetch historical segment trends instead of current snapshot
+
+      --report <REPORT>
+          Report period for history mode: qf (quarterly) | saf (semi-annual) | af (annual)
+
+      --cate <CATE>
+          Segment category filter for history mode
+
+      --format <FORMAT>
+          Output format: 'pretty' for human-readable, 'json' for AI agents and scripting
+
+          [default: pretty]
+          [possible values: table, json]
+
+  -v, --verbose
+          Print verbose request info (host, elapsed) to stderr, prefixed with `*` like curl -v
+
+      --lang <LANG>
+          Language for content fetched from longbridge.com: zh-CN or en. Defaults to system LANG env var, then en
+
+  -h, --help
+          Print help (see a summary with '-h')
+```
+
+## Usage
+
+```bash
+# Run with JSON output for AI agents
+longbridge business-segments --format json
+
+# See all options
+longbridge business-segments --help
+```

package/bundled-skills/longbridge-fundamentals/references/company.md

@@ -0,0 +1,39 @@
+# company
+
+```
+Company overview (founding date, employees, IPO price, address, etc.)
+
+Example: longbridge company AAPL.US
+
+Usage: longbridge company [OPTIONS] <SYMBOL>
+
+Arguments:
+  <SYMBOL>
+          Symbol in <CODE>.<MARKET> format
+
+Options:
+      --format <FORMAT>
+          Output format: 'pretty' for human-readable, 'json' for AI agents and scripting
+
+          [default: pretty]
+          [possible values: table, json]
+
+  -v, --verbose
+          Print verbose request info (host, elapsed) to stderr, prefixed with `*` like curl -v
+
+      --lang <LANG>
+          Language for content fetched from longbridge.com: zh-CN or en. Defaults to system LANG env var, then en
+
+  -h, --help
+          Print help (see a summary with '-h')
+```
+
+## Usage
+
+```bash
+# Run with JSON output for AI agents
+longbridge company --format json
+
+# See all options
+longbridge company --help
+```

package/bundled-skills/longbridge-fundamentals/references/compare.md

@@ -0,0 +1,49 @@
+# compare
+
+```
+Multi-stock valuation comparison (price, market cap, PE/PB/PS, ROE, ROA, div yield, and more)
+
+Without extra symbols: shows the stock alongside server-selected industry peers. With extra symbols: compares the specified stocks side by side.
+
+Example: longbridge compare AAPL.US Example: longbridge compare 9988.HK 700.HK 9999.HK --currency HKD
+
+Usage: longbridge compare [OPTIONS] <SYMBOL> [OTHERS]...
+
+Arguments:
+  <SYMBOL>
+          Base symbol in <CODE>.<MARKET> format
+
+  [OTHERS]...
+          Additional symbols to compare (up to 4)
+
+Options:
+      --currency <CURRENCY>
+          Currency: USD | HKD | CNY (default: USD)
+
+          [default: USD]
+
+      --format <FORMAT>
+          Output format: 'pretty' for human-readable, 'json' for AI agents and scripting
+
+          [default: pretty]
+          [possible values: table, json]
+
+  -v, --verbose
+          Print verbose request info (host, elapsed) to stderr, prefixed with `*` like curl -v
+
+      --lang <LANG>
+          Language for content fetched from longbridge.com: zh-CN or en. Defaults to system LANG env var, then en
+
+  -h, --help
+          Print help (see a summary with '-h')
+```
+
+## Usage
+
+```bash
+# Run with JSON output for AI agents
+longbridge compare --format json
+
+# See all options
+longbridge compare --help
+```

package/bundled-skills/longbridge-fundamentals/references/corp-action.md

@@ -0,0 +1,42 @@
+# corp-action
+
+```
+Corporate actions (splits, dividends, rights, etc.)
+
+Example: longbridge corp-action 700.HK Example: longbridge corp-action 700.HK --all
+
+Usage: longbridge corp-action [OPTIONS] <SYMBOL>
+
+Arguments:
+  <SYMBOL>
+          Symbol in <CODE>.<MARKET> format
+
+Options:
+      --all
+          Show all records instead of the default 30
+
+      --format <FORMAT>
+          Output format: 'pretty' for human-readable, 'json' for AI agents and scripting
+
+          [default: pretty]
+          [possible values: table, json]
+
+  -v, --verbose
+          Print verbose request info (host, elapsed) to stderr, prefixed with `*` like curl -v
+
+      --lang <LANG>
+          Language for content fetched from longbridge.com: zh-CN or en. Defaults to system LANG env var, then en
+
+  -h, --help
+          Print help (see a summary with '-h')
+```
+
+## Usage
+
+```bash
+# Run with JSON output for AI agents
+longbridge corp-action --format json
+
+# See all options
+longbridge corp-action --help
+```

package/bundled-skills/longbridge-fundamentals/references/corporate-events.md

@@ -0,0 +1,89 @@
+# longbridge-corporate-events
+
+Event-driven analysis for a single listed company: identifies, classifies, and scores corporate events that may create short- to medium-term pricing dislocations.
+
+> Simplified Chinese / Traditional Chinese / English.
+
+## Workflow
+
+1. Resolve the user's symbol to `<CODE>.<MARKET>` (e.g. `AAPL.US`, `700.HK`, `600519.SH`).
+2. Run `longbridge --help` to see available subcommands; run `longbridge <subcommand> --help` to confirm current flags for each.
+3. Fetch **latest news and announcements** using the news subcommand with `--format json`.
+4. Fetch **regulatory filings** using the filings subcommand with `--format json`.
+5. Fetch **corporate actions** (dividends, splits, rights, buyback notices) using the corporate-actions subcommand with `--format json`.
+6. Fetch **major shareholder changes** using the shareholder subcommand with `--format json`.
+7. Optionally fetch **earnings / event calendar** using the finance-calendar subcommand with `--format json` to surface upcoming catalysts.
+8. Classify each event into one of the standard types (see Output), assess sentiment (+/−/neutral), and estimate the expected price-impact window.
+9. Output the event ledger and a summary directional signal.
+
+## CLI
+
+```bash
+# Discover available subcommands and their flags
+longbridge --help
+longbridge <subcommand> --help   # run for each subcommand before use
+
+# Latest news and announcements
+longbridge <news-subcommand> AAPL.US --format json
+
+# Regulatory filings (SEC 8-K, HKEx announcements, CSRC disclosures)
+longbridge <filing-subcommand> AAPL.US --format json
+
+# Corporate actions (dividends, splits, rights, buybacks)
+longbridge <corp-action-subcommand> AAPL.US --format json
+
+# Major shareholder changes
+longbridge <shareholder-subcommand> AAPL.US --format json
+
+# Upcoming earnings / event calendar
+longbridge <finance-calendar-subcommand> --format json
+```
+
+## Output
+
+### Event classification table
+
+Classify each event found into one of these types:
+
+| Type        | 简体        | 繁體        | English                          | Typical signal                       |
+| ----------- | ----------- | ----------- | -------------------------------- | ------------------------------------ |
+| `increase`  | 大股东增持  | 大股東增持  | Insider / major-shareholder buy  | Bullish                              |
+| `decrease`  | 大股东减持  | 大股東減持  | Insider / major-shareholder sell | Bearish                              |
+| `buyback`   | 股份回购    | 股份回購    | Share buyback                    | Bullish                              |
+| `placement` | 定增 / 配股 | 定增 / 配股 | Private placement / rights issue | Dilutive / context-dependent         |
+| `incentive` | 股权激励    | 股權激勵    | Equity incentive plan            | Moderately bullish                   |
+| `ma`        | 并购重组    | 併購重組    | M&A / restructuring              | Event-specific                       |
+| `index`     | 指数调整    | 指數調整    | Index inclusion / exclusion      | Inclusion bullish; exclusion bearish |
+| `mgmt`      | 管理层变更  | 管理層變更  | Management change                | Context-dependent                    |
+| `pledge`    | 股权质押    | 股權質押    | Share pledge (high ratio)        | Bearish risk flag                    |
+| `st`        | ST / 摘帽   | ST / 摘帽   | A-share ST status change         | ST bearish; removal bullish          |
+| `other`     | 其他公告    | 其他公告    | Other filing                     | Neutral until assessed               |
+
+### Output structure
+
+1. **Event ledger** — chronological list: date / type / headline / sentiment (+/−/neutral) / expected impact window.
+2. **Top signal** — the single most market-moving event from the list, with a one-sentence rationale.
+3. **Directional bias** — net assessment (accumulation / distribution / neutral), based on the balance of bullish vs bearish events in the last 30 days.
+4. **Watch window** — suggest the next 1–4 weeks if a pending event (placement lock-up expiry, buyback completion deadline, index review date) is identified.
+
+When no significant events are found, state so explicitly — do not invent signals.
+
+**A-share-specific notes**:
+
+- ST / 摘帽 events have mandatory trading limits and announcement timing rules; flag these clearly.
+- Northbound (沪深港通) quota changes and index-rebalancing announcements (CSI 300 / SSE 50) are high-impact for A-share mid/large caps.
+
+**HK-specific notes**:
+
+- General mandate issuances (general mandate for new shares) are common HK dilution signals.
+- Connected-transaction / related-party announcements require regulatory approval and carry governance risk.
+
+## Error handling
+
+| Situation                       | 简体回复                                    | 繁體回復                                    | English reply                                         |
+| ------------------------------- | ------------------------------------------- | ------------------------------------------- | ----------------------------------------------------- |
+| `command not found: longbridge` | 请安装 longbridge-terminal，或使用 MCP 回退 | 請安裝 longbridge-terminal，或使用 MCP 回退 | Install longbridge-terminal or use MCP fallback       |
+| stderr `not logged in`          | 请运行 `longbridge auth login`              | 請執行 `longbridge auth login`              | Run `longbridge auth login`                           |
+| No events found                 | 所查时段内无重大公司事件                    | 所查時段內無重大公司事件                    | No significant corporate events in the queried period |
+| Symbol mapping fails            | 请提供 `代码.市场` 格式，如 AAPL.US         | 請提供 `代碼.市場` 格式，如 AAPL.US         | Provide `<CODE>.<MARKET>`, e.g. AAPL.US               |
+| Other stderr                    | 原样转述，不静默重试                        | 原樣轉述，不靜默重試                        | Relay verbatim, no silent retry                       |