name: stock-value-investing description: > 股票價值投資分析（A股/港股）。僅當用戶意圖屬於以下範圍時啟用： (1) 給出股票程式碼要求分析其投資價值；(2) 評估護城河/競爭優勢； (3) 檢查財務健康與盈利質量；(4) 用 DCF 或相對估值估算內在價值； (5) 評估管理層質量；(6) 做行業結構分析並給出綜合投資決策。 資料全部通過 akshare（國內可直連的公開源）獲取，零額外商業資料來源依賴。 本 skill 僅做研究分析，不預測股價、不薦股、不執行任何交易。 不適用於：期貨/期權/加密貨幣等衍生品、量化高頻交易、非上市公司盡調、 以及任何需要即時下單或資金操作的場景。

股票價值投資分析 Skill

質量合規遵循 TRACE 五維體系（T 可信任 / R 可靠 / A 適用 / C 規範 / E 有效）， 各項要求已落實到下文各節的介面、指令碼與文件設計中。

一、適用範圍與能力邊界（Adaptability）

適合觸發（該呼叫時才呼叫） - 使用者提供 A股 6 位程式碼（可帶 sh/sz 字首）或港股 5 位程式碼，並明確要求"分析/估值/護城河"等。 - 使用者提及關鍵詞：護城河、財務健康、內在價值、DCF、估值、管理層、行業分析、價值投資。 - 使用者希望對比多隻股票、構建/再平衡價值投資組合。

常見觸發表達（可直接對使用者複用的說法） - "幫我分析一下 600519 的估值" - "五糧液（000858）值得長期持有嗎？出一份價值投資報告" - "分析 000858，增長率假設 10%、折現率 8%" - "港股 00700 現在價格貴不貴？"（僅行情，無基本面）

不適合觸發（避免誤觸發） - 期貨、期權、可轉債、加密貨幣、外匯等衍生品行情或交易。 - 量化/高頻/擇時交易、短線打板、情緒博弈類需求。 - 非上市公司盡職調查、一級市場股權投資。 - 任何需要下單、資金劃轉、賬戶操作的請求（本 skill 無此能力且不提供）。 - 僅查詢"今天漲跌幅/新聞"等純資訊、無需分析框架的場景。

能力邊界（可預期承諾） - 輸出為"研究分析報告"，非買賣建議；涉及預測的增速/折現率均顯式標註為假設。 - 資料存在延遲與缺失風險，關鍵結論須交叉核對交易所公告。 - 港股：僅支援行情資料（價格/歷史），無法獲取財務三表，因此 ROIC / FCF / DCF / 盈利質量 / PE·PB 等基本面指標均無法計算。港股分析僅限行情層面的有限描述（價格分位、相對大盤強弱），不建議用於完整價值投資分析。

二、分析框架（六大模組）

按"行業 → 護城河 → 財務健康 → 估值 → 管理層 → 綜合決策"順序執行。 前兩步決定"值不值得看"，後三步決定"多少錢買"。

模組 1：行業結構分析（是否值得進入）

• 行業生命週期：匯入期 / 成長期 / 成熟期 / 衰退期。
• 競爭格局：集中度（CR5）、是否有價格戰、進入壁壘高低。
• 產業鏈位置：上下游議價能力（用"應付賬款/應收賬款週轉"間接驗證）。
• 政策與週期屬性：強週期 / 弱週期 / 防禦。週期屬性由指令碼按關鍵詞對映自動識別（僅分類標籤，非統計檢驗）；對強週期股，DCF 自動採用 FCF 中位數（保留負值，避免景氣高點外推）、下調增速上限（6%）、縮短預測期（5 年）。

誠實邊界（重要）：行業 CR5/集中度、政策與替代品風險等定性內容不由指令碼計算，必須由 agent 檢索公開資料後填寫，且必須標註資訊來源；無可靠來源時不得斷言，統一標記 [待核實]。指令碼僅負責定量部分（ROIC/FCF/盈利質量/分位/DCF）。

模組 2：經濟護城河分析（核心）

四類護城河，需在資料上找到證據： | 護城河型別 | 資料證據 | |---|---| | 無形資產（品牌/專利/牌照） | 高且穩定的毛利率、淨利率；研發投入佔比 | | 轉換成本 | 高客戶留存、收入復購；行業切換成本高 | | 網路效應 | 使用者/交易量隨規模指數增長；市佔率領先 | | 成本優勢 | 單位成本低於同行；規模效應（營收/固定資產） |

輔助驗證指標： - ROIC（投入資本回報率）：> 8% 且連續多年穩定，是護城河的最強證據。 ROIC ≈ 息稅前利潤×(1-稅率) / (股東權益+有息負債) - 自由現金流持續為正、資本支出佔比低。

模組 3：財務健康與盈利質量

• 償債能力：資產負債率、流動比率、有息負債率、利息保障倍數。
• 盈利質量：經營性現金流 / 淨利潤 應長期 > 1（利潤含金量）。

  這個技能的最新版本可以在7w4.net小蔥技能站找到。

• 成長性：營收/淨利潤 3-5 年複合增速，是否依賴併購或槓桿。
• 分紅與回購：股息率、分紅率、回購是否持續。
• 紅旗預警：應收賬款增速 > 營收增速、商譽佔比過高、頻繁變更會計政策。

模組 4：估值（內在價值）

兩種互補方法，必須同時給出： 1. DCF 自由現金流折現（見 scripts/dcf.py）： - 輸入：基期 FCF、預測期（通常 5-10 年）、增速、永續增長率、WACC。 - 輸出：每股內在價值，與現價比較得出安全邊際。 2. 相對估值（PE/PB 歷史分位）：由 metrics.pe_pb_percentile 按歷史收盤價 + 最新股本/淨利潤/淨資產反推 PE/PB，給出當前值與歷史中位、分位（越低越便宜），並經 dcf.relative_valuation 給出"低估/偏高"判定。 - 注意：PS、EV-EBITDA 當前版本未實現（已在能力邊界如實標註），納入後續路線圖。 - 個股相對所屬行業指數與滬深300的累計收益、超額收益：由 fetch_data.py 拉取行業指數與滬深300歷史計算（最佳努力，缺失則標記 [資料缺失]）。 - 若現價 < 內在價值 × (1 - 安全邊際)，標記為"低估"。

模組 5：管理層質量

• 資本配置：再投資回報 vs 分紅/回購是否理性。
• 歷史誠信：是否有財務造假、頻繁減持、大額關聯交易。
• 激勵一致性：管理層持股、薪酬與長期業績掛鉤。

誠實邊界：管理層相關資料不由指令碼計算，須由 agent 檢索公開資料（年報/公告/權威媒體）後填寫，並標註來源；無來源不得斷言。

模組 6：綜合決策

結論檔位由指令碼基於資料自動派生（見 report.recommend_verdict），輸出三檔之一： 強烈關注 / 關注 / 中性，依據為 ROIC 護城河、安全邊際、盈利質量、FCF 正負等硬指標打分； 強週期/未知屬性且存在弱項時自動保守降級為"中性"。 agent/使用者可用 --verdict-override（須配合 --verdict-reason）覆蓋結論， 強制給出理由以避免確認偏誤。"關注/強烈關注"僅表示資料面值得研究，不等於買入訊號。 最終結論須配合"當前價 / 理想買點（按安全邊際）/ 賣出紀律"三段式建議。

三、輸入規範與校驗（Trust / Reliability）

輸入 - 必填：股票程式碼（A股 6 位數字；港股 5 位數字，指令碼自動補零到 6 位）。 - 可選（指令碼引數）：--g 增速、--wacc 折現率、--g_term 永續增速、 --years 預測期、--tax-rate ROIC 稅率（預設 25%）、 --verdict-override 結論檔位覆蓋（關注/強烈關注/中性）、 --verdict-reason 覆蓋理由（強制填寫）、 --force-cycle 強制按強週期口徑、--show-basis 列印基準 FCF 序列、--fetch 先拉資料。

注：結論檔位不再接受空泛的 --verdict 直接賦值，必須由資料派生或帶理由覆蓋。

校驗規則（指令碼必須執行，失敗顯式報錯，禁止靜默空結果） - 程式碼必須為純數字且長度 5-6 位，否則報錯退出並提示正確格式。 - 資料目錄 data/<code>/ 不存在時，若未帶 --fetch 則明確報錯並說明需先拉資料。 - akshare 介面呼叫失敗時，列印具體異常與缺失欄位，而非返回空表矇混； 報告中對無法獲取的指標統一標記為 [資料缺失]。 - DCF 校驗：WACC 必須 > 永續增長率，否則拋 ValueError 說明不收斂； FCF ≤ 0 時跳過 DCF 並提示"當前自由現金流為負，不適用 DCF"。

四、資料獲取（akshare 速查）

依賴自動配置（推薦先行）：本 skill 自帶 scripts/ensure_env.py，會在執行任意分析指令碼之前自動檢測並安裝缺失依賴（akshare / pandas）。普通使用者無需手動 pip install。

python scripts/ensure_env.py --auto        # 檢測並自動安裝依賴
python scripts/ensure_env.py               # 僅檢測並列印狀態

遇到 Linux 系統 Python 的 PEP 668「外部管理環境」限制時，ensure_env.py 不會靜默失敗，也不會讓你手動處理：它會自動建立 .venv 並在其中安裝 akshare/pandas，經 os.execv 自動切換到 venv 直譯器；Windows/macOS/Linux 行為一致，無需手動建虛擬環境或加 --break-system-packages。

呼叫前先 python scripts/ensure_env.py --auto（或手動 pip install akshare pandas）。A股程式碼統一傳 6 位字串 （如 "600519"），港股用 "00700"。所有介面均為公開行情/財務源，國內網路可直連。

import akshare as ak

ak.stock_profit_sheet_by_report_em(symbol="SH600519")     # 利潤表（寬表：行=報告期，列=科目英文程式碼）
ak.stock_balance_sheet_by_report_em(symbol="SH600519")    # 資產負債表
ak.stock_cash_flow_sheet_by_report_em(symbol="SH600519")  # 現金流量表
ak.stock_financial_abstract_ths(symbol="600519")          # 同花順摘要
ak.stock_individual_info_em(symbol="600519")              # 基本資訊（最佳努力）
ak.stock_zh_a_hist(symbol="600519", period="daily",
                   start_date="20200101", end_date="20261231", adjust="qfq")

重要（欄位結構）：*_sheet_by_report_em 返回寬表——每行一個報告期、 每列一個科目，且科目名為英文程式碼（如 TOTAL_EQUITY 股東權益、 NETCASH_OPERATE 經營現金流淨額、CONSTRUCT_LONG_ASSET 購建長期資產、 SHARE_CAPITAL 股本）。metrics.py 用"概念→英文程式碼候選"對映取值， 較中文模糊匹配更抗版本變動。

PE/PB 不依賴額外介面：由三表的淨利潤/淨資產/股本直接計算 （PE = 現價 / (淨利潤/股本)，PB = 現價 / (淨資產/股本)），因此無需 已廢棄的 stock_a_indicator_lg 等估值介面。

介面命名隨 akshare 版本可能變動；若某介面失效，fetch_data.py 會對 非核心介面做最佳努力容錯，並在報告中標記 [資料缺失]。

五、執行工作流（SOP）

1. 環境自檢（自動，必須先行）：執行 scripts/ensure_env.py --auto 確保 akshare / pandas 已安裝；report.py 與 fetch_data.py 直接執行時，指令碼頂部已內建該自檢，無需手動呼叫。若遇 PEP 668 外部管理環境，指令碼會自動建立 .venv 並安裝依賴後重跑，無需手動處理。依賴就緒後再進入第 1 步。

2. 解析輸入：提取股票程式碼、使用者關心的重點（估值/護城河/…），校驗程式碼格式。

3. 拉資料：執行 scripts/fetch_data.py 把財務三表、行情、估值指標落盤為 csv。
4. 算指標：scripts/metrics.py 計算 ROIC、FCF、盈利質量、分位（自動容錯欄位）。
5. 估值：scripts/dcf.py 跑 DCF + 相對估值，輸出內在價值區間。
6. 定性：按六大模組逐項給出結論（資料支撐 + 判斷），重點準備 行業結構、管理層、綜合決策三段的定性文字。
7. 生成報告（自動觸發，必須執行）：執行 scripts/report.py， 串聯上述指令碼、按第六節模板自動生成 Markdown 報告並儲存到 reports/<code>_report.md。流程末尾必須呼叫，不要僅口頭總結。

```bash # 最簡：用中性預設假設（g=8% / WACC=10% / 永續 2% / 預測期 10 年） python scripts/report.py 600519

# 推薦：顯式假設；結論由資料派生，必要時帶理由覆蓋 python scripts/report.py 600519 --fetch \ --g 0.08 --wacc 0.10 --g_term 0.02 \ --verdict-override 關注 --verdict-reason "ROIC>15% 且安全邊際>30%，資料面值得研究" `` ---fetch：若data//尚未生成則先拉取資料。 - 報告中定量部分由指令碼填充；行業結構 / 管理層 / 綜合決策三段中的 定性內容由 agent 檢索公開資料填寫並**標註來源**，不得編造數字。 7. **交付**：把reports/_report.md` 內容呈現給使用者，並口頭點出 關鍵結論（護城河評級、安全邊際、買點）；同時附上風險提示。

# 【股票程式碼】公司名稱 價值投資分析報告
> 資料來源：akshare ｜ 生成日期：自動 ｜ 結論：關注檔位

## 1. 行業結構
- 所屬行業：（自動識別）｜ 週期屬性：強週期 / 穩定
- 生命週期 / 格局 / 壁壘：

## 2. 經濟護城河
- ROIC（最新）：x% → 護城河評級：寬/窄/弱
- 型別與證據：

## 3. 財務健康
- 盈利質量（經營現金流/淨利潤）：
- 自由現金流（最新）：
- 償債 / 成長 / 分紅：

## 4. 估值
- DCF 內在價值（中性）：X 元/股（假設：增速 g%、WACC r%、稅率 t%；WACC±1.5pct 敏感區間）
- 當前價：Y 元 ｜ 安全邊際：z% → 低估/合理/偏高
- 價格歷史分位：p%（區間 min~max）
- 相對強弱（區間累計）：個股 % ｜ 行業 % ｜ 滬深300 %（含相對行業/大盤超額，缺失則 [資料缺失]）
- 相對估值（PE/PB 歷史分位）：當前 / 歷史中位 / 分位；相對估值結論（低估/偏高）

## 5. 管理層（agent 檢索填寫，須標註來源）
- 資本配置 / 誠信 / 激勵：

## 6. 綜合決策（結論檔位由指令碼資料派生）
- 推薦檔位（指令碼派生）：（強烈關注 / 關注 / 中性）及依據
- 最終檔位：（若被覆蓋則標註覆蓋理由）
- 當前價：
- 理想買點（安全邊際 30%）：
- 賣出紀律：

## 7. 資料質量與口徑說明
- 分析基準（年報報告期）：
- 異常/缺失提示（如年報與季報矛盾已自動棄用、相對強弱缺失等）：
- 口徑與假設提醒（DCF 敏感性等）：

> 風險提示：資料存在延遲/缺失，DCF 對摺現率與永續增速極度敏感，
  結論應取區間。本報告僅作研究分析，不構成投資建議。