@v587d/capital-generation 2.7.2 → 2.7.4

package/selected-skills/claude-for-financial-services-cn/UPSTREAM.md

@@ -0,0 +1,173 @@
+# Upstream Record
+
+- Project: Claude for Financial Services（中文版）—— 63 颗面向 A 股的金融工作流 skill，按六条业务线组织：
+  证券研究（`china-finance`，31 颗）、投行（10）、私募（9）、基金运营（6）、财富管理（5）、账户与合规（2）。
+  同一套正文还被上游打包成四个"角色 Agent"（`agent-plugins/*`）再抄了一遍，所以仓库里 `SKILL.md` 有 188 个路径、
+  唯一 `name` 只有 58 个。
+- Repository: https://github.com/jwangkun/claude-for-financial-services-cn
+- Upstream commit: `d7585ca0033d0624e14e8c5a031b373c1216dd74`（main，2026-09-14，
+  "fix(akshare-mcp): get_financials always returned [] due to wrong THS indicator and stale annual filter (#4)"）
+  - 全仓 15 次提交（`jwangkun` 14、`fintech-python-java` 1）：2026-06-07 建仓，06-08 与 06-09 两天集中 10 次，
+    之后沉寂三个月到本 commit。831 stars、3 个 open issue，无 release、无 tag。
+- License: **Apache-2.0** —— 本仓六份快照里第一份非 MIT。`LICENSE` 为上游原件、未改写。署名有三处互不一致，
+  按现状记录，不做取舍：
+  - `LICENSE:189` 附录写 `Copyright [2025] [jwangkun]` —— Apache 自己的说明要求填好后**去掉方括号**，上游没去；
+  - 六个 `vertical-plugins/*/.claude-plugin/plugin.json` 的 `author.name` 都是 `Anthropic FSI China`；
+  - `README.md:5` 自称"基于 Anthropic 官方 [claude-for-financial-services](https://github.com/anthropics/claude-for-financial-services)
+    深度适配国内市场"，其对照表（`README.md:439`）称两者同为 Apache 2.0。
+  上游**没有 `NOTICE` 文件**，因此再分发只需保留 `LICENSE` 与本条记录。catalog 的 `owner` 用仓库 owner `jwangkun`。
+- Imported content: 该 commit 的完整文件树，267 个文件 / 约 3.1 MB（`vertical-plugins/` 六条线 63 颗 +
+  `agent-plugins/` 四个角色包的副本 + `managed-agent-cookbooks/` + `mcp-servers/` 四份 python 取数服务 +
+  `scripts/` + 根级 README / CLAUDE.md / IFIND-INTEGRATION-PLAN.md）。
+
+- Local modifications（四类，逐条可复核；口径与理由见 `docs/dev/selected-skills.md` §8.6 的接入必查清单）：
+
+  1. **删除上游的 `.gitignore`。** 它排的是 `mcp-servers/*/mcp_config.json`、`*.key`、`secrets/`、`__pycache__/`、
+     `*.xlsx` / `*.pptx` / `*.docx` 与 `.claude/settings.local.json`——这些规则会在本仓继续生效，
+     把"按 commit 重导"的快照与所钉 commit 弄成两种样子。实测该 commit 的 267 个已提交文件与盘上文件数一一对上
+     （被它挡的都在 `__pycache__/` 一类未提交路径里），所以删除不丢任何文件，但规则本身不能带进宿主仓库。
+  2. **不改布局。** 前五颗里出现过三种布局问题（上游没写 `name`、SKILL.md 住在仓库根、分组深一层），本颗都不是：
+     每颗 `SKILL.md` 的 frontmatter 都齐 `name` + `description`，`name` 与目录名一致。唯一的新形态是
+     **上游有六个 skills 根**（`vertical-plugins/<条线>/skills/`），而 provider 与五处反查只认一个根映射。
+     处理方式是**只登记规范根那一条线**：`SELECTED_SKILL_SKILL_DIRS` 填
+     `'claude-for-financial-services-cn': 'vertical-plugins/china-finance/skills'`，另五条线与 `agent-plugins/`
+     副本不进 provider 视野，`src/` 一行不动。这样也避开了上游内部的同名冲突——`fund-admin` 有五颗与
+     `china-finance` 同名但内容更薄（`china-accrual-schedule` 5799 vs 6563 字节一类），
+     两条根同时登记就会撞车（provider 的启用集合只按 `name` 认）。
+     上游 `CLAUDE.md` 自己写明 "Skills are authored in `vertical-plugins/china-finance/skills/`" 且
+     "Agent plugins bundle vendored copies of their skills. **Never edit bundled copies directly.**"——
+     登记规范根与上游的作者口径一致，那些副本因此在 diff 里与上游逐字节相同。
+  3. **取数面改写：9 份 `SKILL.md`，28 处段落级改动（+152 / −200 行）。** 分析结论、判定档位、阈值表、
+     报告骨架与输出模板一字未改。可核对的两个总数：这九颗里的 ```python 伪调用围栏 **14 处 → 0**；
+     `IFIND_DATA_SOURCE_MODE` 开关块在这九颗里 **全部删除**（规范根其余 21 颗与另五条款线照旧带着原文开关——
+     不进可选清单的正文不改也不扫，§8.6 第一段那条口径；所以整颗快照里仍有 176 个文件出现这个变量名，
+     `grep` 到它不代表改写漏了，运行时那些颗一律被 catalog 闭集挡在读取之外）。
+     本颗的 hazard 与前五颗不同族：**63 颗正文每一颗都把取数层写死进正文**——`## Data Sources (Multi-Tier)`
+     三档服务商（Tier-0 万得 Wind，带 `WIND_API_KEY`、`ak_` 前缀与密钥申请 URL；Tier-1 同花顺 iFind，
+     带 `IFIND_AUTH_TOKEN`；Tier-2 AkShare），python 围栏里的伪工具调用（`get_financials(ticker, …)`、
+     `ifind_get_stock_events(query)`、`ak.bond_zh_us_rate()`），尾部统一的 `IFIND_DATA_SOURCE_MODE`
+     环境变量开关块，以及把服务商名写进引用格式的 `Source: AkShare, [date]` 与"所有数字都应来自 …"检查项。
+     改动分六类：
+     - **TIER（9 份）**：服务商阶梯 → "这一节要的是哪些字段、as-of 哪天"的委派 brief 清单；
+       保留上游的字段词汇（三表、最新价 / PE / PB、板块成分股、指数基准、新闻与公告），
+       删掉的是"谁家有数据、密钥去哪申请"。
+     - **CALL（9 份、14 处围栏）**：```python 伪调用围栏与 workflow 步骤里的内联调用 → 散文式取数请求。
+       本插件没有 shell（§1.6），这些工具名指向的是快照里那四个 MCP 服务端，运行时不存在。
+     - **MODE（9 份）**：`IFIND_DATA_SOURCE_MODE` 开关尾块整段删除，换成一句"取数档位由宿主的凭据域决定，
+       这份产出既不配置它，也不向使用者索取凭据"（§5：密钥只进 credentials 域）。
+     - **CITE（5 份）**：引用格式与检查项里的服务商名 → 回到取数通道真正给出的东西（数据集引用、披露文件名与页码）。
+       `巨潮资讯` / 交易所 / 监管机构作为**出处**保留（那是披露场所，也是宿主检索通道本就在用的来源），
+       作为**取数指令**的部分删掉。
+     - **GAP（4 份，§8.6 第 2 条，本颗最要紧的一类）**：`china-earnings-preview` 原句
+       "**If consensus unavailable**, derive from: Historical growth rates / Management guidance /
+       Industry benchmarks"、`china-earnings-analysis` 的 `[UNSOURCED] — estimate based on [rationale]`、
+       `china-dcf` 的 "use … or web search for latest"、`china-earnings-analysis` 的
+       "Consensus sources: Wind / Choice / 慧博 / iFinD" 阶梯 → 统一改成**点名缺哪个字段、该列留空并停下**。
+       这里必须如实说明一件事：**本插件没有一致预期的结构化取数面**（同花顺能力清单里没有盈利预测／一致预期条目，
+       唯一带预测形状字段的是东财研报条目上的本年 / 次年 EPS 预测）。所以改写后的正文把这四档写成
+       "卖方单家口径 ≠ 市场共识"，情景与差异要么写在去年、自家先前口径或公司披露区间上并**标明是哪种基线**，
+       要么写成缺口——"用记忆里的增速估一个预期"没有任何工具会拦，只能改在正文里。
+     - **ROUTE（1 处）**：`china-catalyst-calendar` 的 `## Integration with Other Skills` 表原句保留，
+       加第五颗同一句前置条件（点名的 skill 只有使用者显式开启才存在于会话里，本插件明确不提供的那两类永远不存在）。
+     另有两处按同一族处理：**DESC（1 处）**`china-dcf` 的 frontmatter `description` 自己写着
+     "Uses AkShare MCP for financial statements"，那半句换成口径描述，方法论部分不动；
+     **CHART（1 处）**`china-initiating-coverage` 的 `**Chart standards:**` 块原文要求
+     "Dark theme or light theme (consistent with firm template)" 与 `Source: AkShare historical data` →
+     改成"这四张图说的是首次覆盖该有什么图表，图由宿主的出图通道渲染（出图只走 `render_chart`，§6.1），
+     主题与标签排版是出图角色的决定"，图表清单本身（收入与利润历史、倍数区间带、增长 vs 倍数散点、两年价格线）未改。
+     **一处就地标注（3 份）**：`china-comps-analysis`、`china-sector-overview`、`china-initiating-coverage`
+     的模板以目标价 / 投资建议 / 多空方向收尾，且改动正好落在那份文件的尾块上，因此除了 `riskNote` 之外，
+     尾块里另写了一句"属于推演练习、本插件不据它下单也不给仓位"。`china-earnings-analysis` 与
+     `china-variance-commentary` 的评级只出现在报告骨架的某一节里（没有落到被改写的尾块），正文不动，
+     完全由 catalog 的 `riskNote` 承担——两份都改或都不改都不是诚实的做法，这里是按"改写是否正好落在同一处"划线，
+     线画在这里是为了让下一个人看得见。**评级五档表、`Long / Short` 一览与 `投资建议: [Buy / Hold / Sell]`
+     这些上游判定档位与模板全部原样保留**（§8.6：不为口味改结论）。
+  4. **Apache-2.0 §4(b) 的改动声明：上面那 9 份文件各加一行。** 前五份快照是 MIT，再分发不要求在**被改的文件上**
+     留痕，改动口径只住在本文件里；Apache-2.0 第 4(b) 条要求"修改过的文件带上显著的声明"，所以这九份在一级标题
+     下面各有一句可见中文声明（点名所钉 commit `d7585ca`、改的是取数与凭据口径、逐条见本文件、方法论未改）。
+     其余 54 颗与上游逐字节相同，因此不带这一行。它是许可要求而不是编辑：不改语义、不改结论，
+     `test/selected-skills-content.test.mjs` 有一条正向断言钉住"这九份必须各带一行"，漏一颗就点名那一颗。
+
+- 收录判断（规范根 31 颗里 9 颗进 catalog，22 颗留在快照里当可审查材料；另五条款线 32 颗整条不进）：
+  - **进（9）**：`china-earnings-analysis`、`china-earnings-preview`、`china-comps-analysis`、`china-dcf`、
+    `china-sector-overview`、`china-catalyst-calendar`、`china-break-trace`、`china-variance-commentary`、
+    `china-initiating-coverage`。补的是既有 45 条里没有的形状：A 股卖方体例的业绩点评与超预期分解、
+    财报前情景框架、A 股口径的可比倍数与 DCF 参数（10Y 国债、A 股 ERP、25%/15% 税率）、
+    A 股披露节奏的催化剂日历、按报表科目与监管文书走的财务核查、差异表述的句子级写法、首次覆盖的报告骨架。
+    市场口径是 **A 股**（`tags` 全部带 `a-share`），与美股那 30 多颗互为对照，不通用。
+  - **不进 · 它本身就是取数目录**：`china-market-data`。整颗是四个服务商 MCP 的工具清单
+     （`mcp__ifind__*` / `mcp__akshare__*` 之类工具名表 + 28 个"要什么数据用哪个工具"的配方 +
+     `export IFIND_DATA_SOURCE_MODE=…`），自己不产出任何分析。收录它等于在本插件既有的取数协议之外
+     再造一条取数路由（§8.6 第 1 条与第 6 条同时撞上），因此整颗留原文不改、也不进清单。
+  - **不进 · 元技能 + 执行面**：`china-skill-creator`。它教 Agent 按上游模板新写 `china-*` skill，
+     模板里硬编码那份三档服务商的 `## Data Sources` 块，并要求跑 `python3 scripts/check-china.py` 与
+     `sync-china-skills.py` 来校验和同步。本插件没有 shell（§1.6），也不需要第二条 skill 生产线。
+  - **不进 · 上游自标的 alias**：`china-dcf-model`。`description` 自己写 "This alias skill redirects to
+     `china-dcf`"，与 InvestSkill 那轮的 `fundamental-analysis` / `dcf-valuation` 同一条理由（§8.6 第 6 条）。
+  - **不进 · 同题材的薄一份且结构坏**：`china-comps`（105 行 vs `china-comps-analysis` 207 行）。
+     它带着**两份 frontmatter**（`L1-4` 与 `L37-40` 各一份 `name` / `description`），
+     正文是同一题材的早版；收哪一颗都让"目录名 ↔ frontmatter name ↔ catalog name"的三处一致变复杂。
+  - **不进 · 给买卖动作与仓位数字**（与 `docs/reference/external-skill-scan-2026-10.md` 既定口径、
+    以及第五颗排除 `position-sizing` / `position-management` 同一条线）：
+    `china-morning-note`（晨会纪要的"2-4 条可执行 idea"、`方向: Long / Short / Watch`、止损位与仓位建议）、
+    `china-thesis-tracker`（`[Maintain / Add / Reduce / Exit]` 与止损位、目标价）、
+    `china-idea-generation`（选股清单给 `Long` 方向，`Position sizing recommendations` 一节）、
+    `china-tax-loss-harvesting`（`Full exit: Sell and replace` / `Reduce position` 与执行买卖的清单，
+    且税损收割本身是美股应税账户语境的产物）。这四颗**不改写后收进来**，按第五颗的决定整颗不收。
+  - **不进 · 要求产出或读取本地文件（§8.6 第 4、5 条）**：`china-xlsx-author`、`china-pptx-author`
+    （后者的 `Usage` 直接是 `python3 scripts/generate_a_share_ppt.py`）、`china-ppt-template-creator`、
+    `china-deck-refresh`、`china-audit-xls`、`china-ib-check-deck`、`china-clean-data-xls`、
+    `china-3-statement-model`（带 `## Excel Formatting (OpenPyXL / Office JS)` 与
+    `File named: …_3StatementModel_….xlsx` 的产出清单）、`china-lbo-model`（同一族的 Excel 结构）、
+    `china-model-update`、`china-roll-forward`。这十一颗的对象是一份工作簿或一份 deck：本插件的产出写在
+    最终答复里（§7 报告链路已删除），图表只走 `render_chart`（§6.1），没有 shell 能生成文件（§1.6）。
+  - **不进 · 不是本插件使用者的场景**：`china-gl-recon`、`china-accrual-schedule`（总账对账与计提计划，
+    会计作业口径）、`china-deal-screening`（一级市场标的筛选）。它们没有明显违规，留原文不改、不进清单。
+  - **整条线不进（另五条，共 32 颗）**：`investment-banking`（10：teaser / CIM / buyer list / datapack /
+    merger model / pitch deck …，交付物是并购文件）、`private-equity`（9：尽调清单、IC 备忘录、
+    回报与单元经济、投后监控）、`fund-admin`（6：净值对账、GL 对账、roll-forward）、
+    `wealth-management`（5：客户报告、理财规划、投顾建议书、组合再平衡——直接给配置动作与建议）、
+    `operations`（2：KYC 材料解析与规则）。理由合起来是三条：它们与规范根不在同一个 skills 根里、
+    交付物多是机构流程文件，以及财富管理那条线给的是配置建议。
+  - **`agent-plugins/*` 与 `mcp-servers/*` 更不是可选面**：前者是上游自己 vendored 的角色包副本
+    （上游规定不许直接编辑），后者是四份可运行的取数服务端（`server.py` + `requirements.txt` +
+    密钥配置形态）。本插件从不执行快照里的脚本（§8.6 第 4 条的口径：管的是正文，不是文件在不在盘上）。
+  - `test/selected-skills-provider.test.mjs` 用「skills 根目录 − 排除清单」派生本颗的可选清单，
+    `test/persona.test.mjs` 另把 `china-market-data` / `china-skill-creator` / `china-dcf-model` /
+    `china-idea-generation` 明确断为不进 catalog。
+- 复核方法：`git clone` 所钉 commit 后，只对**规范根**逐颗 `diff -r`：
+  `diff -r /tmp/upstream/vertical-plugins/china-finance/skills <快照>/vertical-plugins/china-finance/skills`
+  —— 差异只应是上面那 9 份 `SKILL.md`（28 段），其余 22 颗与另五条款线、`agent-plugins/`、`mcp-servers/`、
+  `LICENSE` 逐字节相同。注意 `agent-plugins/<角色>/skills/` 里有**同名副本**，对整个仓库跑 `diff -r`
+  会把它们一起列出来（本颗没动它们，列出来也不代表漂移）；`fund-admin` 那五颗同名 skill 内容更薄，
+  比对时按路径而不是按名字认。
+- Packaging: 这颗带 `.npmignore`，挡的是非运行内容：`agent-plugins/`（角色包里的 skill 副本）、
+  `managed-agent-cookbooks/` 与 `.codebuddy/`（它给别的宿主编排用的 agent 定义与团队材料）、
+  `scripts/`（上游的生成、校验与同步 python / shell）、`.claude-plugin/` 与 `.mcp.json`
+  （每条款线的 plugin manifest 与 MCP 接线）、根级 `README.md` / `CLAUDE.md` / `IFIND-INTEGRATION-PLAN.md`。
+  另有一条合规口径，不只是体积：**`mcp-servers/` 连发布包都不进**——四份能连付费数据接口的 python 服务端
+  与本仓排除券商执行面（`trading-skills` 的 `etoro`）是同一条线，凭据只进 credentials 域（§5）。
+  不进可选清单的正文（规范根的 22 颗、另五条款线的 32 颗）**随包保留**作为可审查材料，
+  照 InvestSkill 与 trading-skills 先例：provider 的 `list()` / `get()` 与 `/capital-skills/<name>.md`
+  旁路都按 catalog 闭集过滤，运行时读不到它们。
+  规则**只写裸名**：`test/packaging.test.mjs` 丢掉以 `/` 开头的规则、也不检查带内部斜杠的规则，
+  而目录规则按**任意路径段**匹配——所以这里绝不能出现 `skills/`（一条就会把六十三份正文全挡掉，
+  而 catalog 反查只会说"包里找不到 SKILL.md"）。
+  `package.json` 的 `files` 已登记 `selected-skills/claude-for-financial-services-cn`；随包的是 63 份
+  `SKILL.md`（规范根 31 + 另五条线 32）+ `LICENSE` + 本文件，净增 65 个文件，整包未压缩 3.49 → 3.98 MiB。
+- Maintenance snapshot (checked 2026-10-11): 15 次提交里 10 次落在 2026-06-08 与 06-09 两天，
+  此后三个月无动作，直到 2026-09-14 那一次修 AkShare 服务端返回空数组的 bug（也就是本 commit）。
+  831 stars、3 open issue，无 release / tag。因此标 `watchlist`：内容成体系、维护靠一次性的集中搬运，
+  与 `china-stock-research-skills`、`trading-skills` 同一口径，不是内容缺陷。
+  See [GitHub commit history](https://github.com/jwangkun/claude-for-financial-services-cn/commits/main/)。
+- Runtime status: `watchlist` / 默认关闭的显式实验。只有使用者在「插件」→ Capital Generation →「精选 Skills」
+  里逐格打开，它们才对**之后新建**的 Capital 根 Agent 可见；子 Agent 不继承，上游的 MCP 服务端与脚本从不执行。
+  能力标签全部复用既有词表（`a-share` 加各颗自己的 `earnings` / `valuation` / `risk` / `monitoring` /
+  `macro` / `competition` / `verification` / `business-analysis` / `filings` / `financial-health` / `cash-flow`），
+  本颗**没有新增标签**；`riskNote` 逐条写明两件事：评级、目标价与多空方向属于推演练习，
+  以及本插件取不到一致预期那一类字段。
+- Review status: 2026-11-08 复查上游、许可证与维护状态。这九颗按中国大陆卖方与机构研究惯例写
+  （中金 / 中信 / 华泰体例、申万与中信行业分类、CAS 科目、涨跌停与北向资金口径、A 股披露节奏），
+  与美股那三十多颗互为对照而**不通用**；五档评级与目标价那一套是本插件明确不提供的东西，
+  收录它们只为让使用者看见卖方流程长什么样，**不构成投资建议**，也不得反向当作监管或会计规则。
+  本文件与本仓的收录判断不构成对上游观点、也不构成对 `anthropics/claude-for-financial-services` 观点的背书。

package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-3-statement-model/SKILL.md

@@ -0,0 +1,287 @@
+---
+name: china-3-statement-model
+description: Three-statement financial model for A-share stocks. Adapts the standard 3-statement-model methodology for Chinese accounting standards (CAS), Chinese GAAP differences, and AkShare-sourced financials. Use instead of the original 3-statement-model skill when building integrated IS/BS/CF models for Chinese listed companies.
+---
+
+# china-3-statement-model
+
+## Purpose
+
+Build institutional-quality three-statement models (Income Statement / Balance Sheet / Cash Flow) for A-share equities, adapted for Chinese Accounting Standards (CAS) and the Chinese market context.
+
+## Key Differences from US 3-Statement Models
+
+| Parameter | US Model | China Model |
+|-----------|----------|-------------|
+| Accounting standard | US GAAP / IFRS | CAS (企业会计准则) |
+| Tax rate | 21% federal | 25% standard (高新技术企业 15%) |
+| Currency | USD | CNY (人民币) |
+| Fiscal year | Varied | Mostly Dec 31 year-end |
+| Revenue recognition | ASC 606 | CAS 14 (similar principles) |
+| Goodwill | Indefinite life (no amortization) | CAS 8 — goodwill amortized or tested |
+| R&D capitalization | Typically expensed | Can be capitalized under CAS |
+| VAT treatment | Sales tax separate | 增值税 often embedded in revenue/sales |
+| Unit reporting | USD | Often 千元 (thousands CNY) — verify |
+
+## Data Sources
+
+### Tier 0 — 万得 Wind（最全面付费数据）
+- 覆盖：A股/港美股/基金/指数/债券/宏观/研报/分析（44个工具）
+- MCP 服务：`wind-mcp`（需 `WIND_API_KEY` 密钥，以 `ak_` 开头）
+- 优势：全市场覆盖面最广、数据最全面、包含研报和量化分析
+- 密钥申请：https://aifinmarket.wind.com.cn/#/home
+
+### Tier 1 — 同花顺 iFind（付费精确数据）/ AkShare MCP（Tier-2 免费备选）
+
+```python
+get_financials(ticker, "income", "annual")   → 利润表
+get_financials(ticker, "balance", "annual")  → 资产负债表
+get_financials(ticker, "cashflow", "annual") → 现金流量表
+get_quote(ticker)                            → 实时行情
+get_historical_data(ticker)                  → 历史价格
+get_stock_info(ticker)                       → 公司基本信息
+```
+
+### Secondary Sources (when AkShare insufficient)
+- 巨潮资讯 (cninfo.com.cn) — mandatory disclosure filings
+- 上交所 / 深交所 — listed company announcements
+- 上证e互动 / 深交所互动易 — IR Q&A
+- 公司官网投资者关系页面
+
+## Workflow
+
+### Step 1: Data Retrieval
+
+Pull 3-5 years of historical financials from AkShare.
+
+**Verify units carefully:**
+- Some statements report in 元 (CNY)
+- Others in 千元 (thousands CNY)
+- Normalize to consistent unit before modeling
+
+```python
+# Pull all three statements
+get_financials(ticker, "income", "annual")
+get_financials(ticker, "balance", "annual")
+get_financials(ticker, "cashflow", "annual")
+```
+
+### Step 2: Historical Analysis
+
+Document key trends:
+
+- **Revenue growth**: YoY %, CAGR over 3-5 years
+- **Gross margin**: 毛利率 — track expansion/contraction
+- **Operating margin**: 营业利润率
+- **Net margin**: 净利率
+- **Tax rate**: 所得税率 — flag if below 25% (likely 高新技术企业)
+- **Effective tax rate**: vs statutory rate
+- **D&A**: 折旧与摊销 as % of PPE
+- **CapEx**: 资本支出 from cash flow statement
+- **Working capital**: 应收账款、存货、应付账款 trends
+- **Debt structure**: 有息负债 composition
+
+### Step 3: Build the Model
+
+Follow standard 3-statement modeling methodology, adapted for CAS:
+
+#### Income Statement (利润表)
+
+Key line items (Chinese naming):
+- 营业收入 (Revenue)
+- 营业成本 (COGS)
+- 税金及附加 (Taxes and surcharges — includes 消费税、城建税等)
+- 销售费用 (Selling expenses)
+- 管理费用 (G&A)
+- 研发费用 (R&D expenses — must be separated per CAS)
+- 财务费用 (Financial costs — net of interest income)
+- 营业利润 (Operating profit)
+- 营业外收入/支出 (Non-operating income/expenses)
+- 利润总额 (Profit before tax)
+- 所得税费用 (Income tax expense)
+- 净利润 (Net income)
+- 归属于母公司股东的净利润 (Net income attributable to parent)
+
+#### Balance Sheet (资产负债表)
+
+Key line items:
+- 货币资金 (Cash & equivalents)
+- 交易性金融资产 (Trading financial assets)
+- 应收账款 (Accounts receivable)
+- 预付款项 (Prepayments)
+- 存货 (Inventory)
+- 其他流动资产 (Other current assets)
+- 流动资产合计 (Total current assets)
+- 固定资产 (Fixed assets / PPE)
+- 在建工程 (Construction in progress)
+- 无形资产 (Intangible assets)
+- 商誉 (Goodwill — flag if >30% of equity)
+- 非流动资产合计 (Total non-current assets)
+- 资产总计 (Total assets)
+- 短期借款 (Short-term borrowings)
+- 应付账款 (Accounts payable)
+- 预收款项/合同负债 (Advance receipts / contract liabilities)
+- 一年内到期非流动负债 (Current portion of LT debt)
+- 流动负债合计 (Total current liabilities)
+- 长期借款 (Long-term borrowings)
+- 应付债券 (Bonds payable)
+- 非流动负债合计 (Total non-current liabilities)
+- 负债合计 (Total liabilities)
+- 股本 (Share capital)
+- 资本公积 (Capital reserve)
+- 盈余公积 (Surplus reserve)
+- 未分配利润 (Retained earnings)
+- 归属于母公司股东权益合计 (Parent equity)
+- 少数股东权益 (Minority interest)
+- 所有者权益合计 (Total equity)
+- 负债和股东权益总计 (Total liabilities + equity)
+
+#### Cash Flow Statement (现金流量表)
+
+Chinese indirect method:
+- 经营活动现金流量 (Operating CF):
+  - Start from 净利润
+  - Adjust: D&A, 财务费用, 投资收益, 营运资本 changes
+  - 经营活动产生的现金流量净额
+- 投资活动现金流量 (Investing CF):
+  - 购建固定资产/无形资产 (CapEx)
+  - 处置收回 (Asset sales)
+  - 投资支付/收回 (Investment purchases/sales)
+- 筹资活动现金流量 (Financing CF):
+  - 吸收投资 (Equity issuance)
+  - 取得借款 (Borrowings)
+  - 偿还债务 (Debt repayment)
+  - 分配股利 (Dividends)
+- 现金净增加额 (Net change in cash)
+- 期末现金余额 (Ending cash balance)
+
+### Step 4: Balance Checks
+
+**CRITICAL — Chinese-specific checks:**
+
+1. **Cash reconciliation**: 货币资金 (BS) = 期末现金余额 (CF) ± restricted cash
+2. **BS balancing**: 资产总计 = 负债和股东权益总计
+3. **RE roll-forward**: 期初未分配利润 + 本期净利润 - 提取盈余公积 - 现金分红 = 期末未分配利润
+4. **CF-IS linkage**: 净利润 (IS) → starting point for 经营CF
+5. **CapEx check**: 购建固定资产 (CF) ≈ 固定资产增加 (BS) + 累计折旧增加 (BS)
+6. **Debt check**: 借款变动 (CF) = 短期借款变动 + 长期借款变动 (BS)
+7. **Tax check**: 所得税费用 (IS) vs 实际缴纳 (CF indirect method add-back)
+
+### Step 5: Scenario & Sensitivity
+
+- Base / Bear / Bull scenarios
+- Sensitivity on revenue growth, gross margin, tax rate
+- Key drivers: 毛利率, 期间费用率, 营运资本效率
+
+## China-Specific Modeling Conventions
+
+### 增值税 (VAT)
+- Listed companies report 营业收入 net of VAT
+- 税金及附加 includes 消费税 but not VAT
+- VAT is off-balance-sheet in most models
+
+### 商誉 (Goodwill)
+- Common from M&A, especially 2015-2016 boom
+- Flag if 商誉 > 30% of 归母权益
+- Note annual impairment testing requirements
+
+### 研发费用 (R&D)
+- CAS requires R&D to be expensed (not capitalized like IFRS allows)
+- Some companies disclose R&D capitalization in notes — check if >5% of revenue
+
+### 折旧 (Depreciation)
+- Chinese companies often use straight-line over longer lives
+- Typical ranges:
+  - Buildings: 20-40 years
+  - Equipment: 5-10 years
+  - Vehicles: 4-6 years
+
+### 存货 (Inventory)
+- LIFO not permitted under CAS (FIFO or weighted average only)
+- 存货计价 affects margin comparability across years
+
+### 应收款项 (Receivables)
+- 应收账款 often high for industrial companies — check DSO
+- 应收票据 (notes receivable) vs 应收账款 (trade AR) — treat separately
+- 坏账准备 (allowance for doubtful accounts) varies by company
+
+### 借款 (Debt)
+- 短期借款 often high for leveraged companies
+- 长期借款 may include 一年内到期非流动负债
+- 应付债券 for corporate bond issuers
+- Interest expense in 财务费用 (net of interest income)
+
+## Excel Formatting (OpenPyXL / Office JS)
+
+Follow the same professional conventions as the base `xlsx-author` skill, with China-specific adaptations:
+
+- **Section headers**: Dark blue `#1F4E79` with white bold text
+- **Column headers**: Light blue `#D9E1F2` with black bold text
+- **Input cells**: Blue font (RGB: 0,0,255) — all hardcoded inputs
+- **Formula cells**: Black font (RGB: 0,0,0)
+- **Sheet links**: Green font (RGB: 0,128,0)
+- **Currency**: CNY (¥) with thousands separator
+- **Percentages**: 0.0% format
+- **Cell comments**: "Source: AkShare, [date], [field], [ticker]"
+
+### Number Format Conventions
+
+| Item | Format | Example |
+|------|--------|---------|
+| Revenue | ¥#,##0 | ¥12,345 |
+| Percentages | 0.0% | 15.3% |
+| Ratios | 0.00x | 2.50x |
+| Dates | YYYY | 2024 |
+| Stock price | ¥#,##0.00 | ¥158.50 |
+
+## Quality Checks
+
+Before delivering:
+
+- [ ] All three statements balance correctly
+- [ ] Cash from CF = Cash on BS
+- [ ] Retained earnings roll-forward ties
+- [ ] CapEx/Depreciation logic consistent
+- [ ] Debt changes tie between BS and CF
+- [ ] Tax rate reasonable (20-28% unless 高新技术企业)
+- [ ] All hardcoded inputs have cell comments
+- [ ] All formulas reference cells, no hardcodes in formulas
+- [ ] Scenario blocks structured correctly (Bear/Base/Bull)
+- [ ] Sensitivity analysis included
+
+## Common Pitfalls
+
+1. **Unit mismatch**: Mixing 元 and 千元 — always normalize
+2. **VAT confusion**: Double-counting VAT in revenue or COGS
+3. **Goodwill spike**: Forgetting large goodwill from acquisitions
+4. **Tax rate variance**: Assuming 25% when company is 高新技术企业 (15%)
+5. **R&D understatement**: CAS expenses all R&D, but some companies capitalize in notes
+6. **Receivables inflation**: 应收账款 much higher than revenue growth — flag
+7. **Short-term debt**: 短期借款 often high; don't miss current portion of LT debt
+8. **Minority interest**: 少数股东权益 can be significant for conglomerates
+
+## Data Source Priority
+
+1. **AkShare MCP** (primary) — real-time and historical A-share data
+2. **巨潮资讯** (cninfo.com.cn) — mandatory disclosures
+3. **交易所公告** — SH/SZ exchange filings
+4. **公司官网/IR** — supplementary data
+5. **Web search** — only if above insufficient, mark `[UNSOURCED]`
+
+## Output Checklist
+
+- [ ] Three-statement model fully linked (IS → BS → CF)
+- [ ] All balance checks pass
+- [ ] Historical + projected years included
+- [ ] Scenario analysis (Bear/Base/Bull)
+- [ ] Sensitivity tables
+- [ ] All hardcoded inputs sourced and commented
+- [ ] CAS conventions documented
+- [ ] Currency consistent (CNY)
+- [ ] File named: `[Ticker]_3StatementModel_[Date].xlsx`
+> **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
+> - `wind-only`: Wind only, error if unavailable
+> - `wind-fallback`: Wind first, fallback to iFind → AkShare

package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-accrual-schedule/SKILL.md

@@ -0,0 +1,182 @@
+---
+name: china-accrual-schedule
+description: Build accrual schedules for A-share companies tracking revenue recognition, expense accruals, and working capital timing. Adapted from the original accrual-schedule skill for CAS accounting and Chinese business practices. Triggers on "A股应计项目", "应计计提", "accrual schedule China", "应计账款分析", or "working capital accruals [company]".
+---
+
+# china-accrual-schedule
+
+## Purpose
+
+Build **A股应计项目时间表** — comprehensive accrual schedules for financial analysis and audit preparation.
+
+## Data Sources
+
+### Primary: iFind MCP (Tier-1 付费) / AkShare MCP (Tier-2 免费备选)
+
+```python
+get_financials(ticker, "income")     → Revenue, expenses
+get_financials(ticker, "balance")    → Working capital accounts
+```
+
+### Secondary Sources
+- 巨潮 — annual/quarterly reports
+- 审计报告 — accrual methodology
+
+## Workflow
+
+### Step 1: Identify Accrual Items
+
+**Revenue accruals:**
+
+| Item | Description | Typical Items |
+|------|-------------|---------------|
+| 预收账款 (Deferred revenue) | Advance from customers | Prepayments, deposits |
+| 应收账款 (Accounts receivable) | Revenue recognized, not yet collected | Trade receivables |
+| 合同负债 (Contract liabilities) | New CAS term for prepayments | Contract-based |
+| 应收票据 (Notes receivable) | Commercial acceptance/bank bills | Bills from customers |
+
+**Expense accruals:**
+
+| Item | Description | Typical Items |
+|------|-------------|---------------|
+| 应付账款 (Accounts payable) | Expenses incurred, not yet paid | Trade payables |
+| 应付职工薪酬 (Accrued salaries) | Year-end bonus, unpaid wages | Bonus accruals |
+| 应付利息 (Accrued interest) | Interest on loans, bonds | Interest payable |
+| 预计负债 (Provisions) | Estimated obligations | Warranty, litigation |
+| 递延收益 (Deferred income) | Government grants | Subsidy income |
+| 预提费用 (Accrued expenses) | General accruals | Utilities, rent |
+
+**Other accruals:**
+
+| Item | Description |
+|------|-------------|
+| 应交税费 (Taxes payable) | Income tax, VAT, surcharges |
+| 应付股利 (Dividends payable) | Declared but unpaid |
+| 其他应付款 (Other payables) | Miscellaneous |
+
+### Step 2: Build Accrual Schedule
+
+**Monthly/quarterly accrual tracking:**
+
+| Accrual Item | Jan | Feb | ... | Q1 | Q2 | Q3 | Q4 | Full Year |
+|--------------|-----|-----|-----|----|----|----|----|-----------|
+| 应收账款增加 | | | | | | | | |
+| 预收账款增加 | | | | | | | | |
+| 应付账款增加 | | | | | | | | |
+| 应付职工薪酬 | | | | | | | | |
+| ... | | | | | | | | |
+| **Net accruals** | | | | | | | | |
+
+### Step 3: Analyze Accrual Quality
+
+**Accrual ratios:**
+
+| Ratio | Formula | Interpretation |
+|-------|---------|---------------|
+| 总应计率 | (ΔCA - ΔCash - ΔCL) / Average Assets | >0 = accrual-based earnings |
+| 应收账款/收入 | AR / Revenue | Rising = potential issues |
+| 应付账款/成本 | AP / COGS | Trend analysis |
+| 预收账款/收入 | Deferred rev / Revenue | Customer prepayments |
+| 经营现金流/净利润 | OCF / Net Income | <1 = accrual concern |
+
+**Accrual quality flags:**
+
+| Flag | Warning |
+|------|---------|
+| 应收账款增速 >> 收入增速 | Potential revenue inflation |
+| 应付账款突然减少 | Potential window dressing |
+| 预收账款大幅波动 | Revenue recognition timing |
+| 其他应付款异常 | Related party tunneling |
+
+### Step 4: CAS-Specific Accrual Items
+
+**China-specific accruals:**
+
+| Item | CAS Treatment | Notes |
+|------|--------------|-------|
+| 增值税 | Pass-through, not revenue | 不含税收入 |
+| 政府补助 | 递延收益 or 其他收益 | Timing impact |
+| 坏账准备 | 预期信用损失模型 | CAS 22 |
+| 存货跌价准备 | Lower of cost or NRV | CAS 1 |
+| 固定资产减值 | When indicators exist | CAS 8 |
+| 商誉减值 | Annual test (no reversal) | CAS 8 |
+| 辞退福利 | Employee termination | CAS 9 |
+
+### Step 5: Working Capital Accruals
+
+**Working capital accrual schedule:**
+
+| Item | Beginning | Additions | Usage | Reversal | Ending |
+|------|-----------|-----------|-------|----------|--------|
+| 坏账准备 | | | | | |
+| 存货跌价准备 | | | | | |
+| 固定资产减值 | | | | | |
+| 预计负债 (产品质量) | | | | | |
+
+### Step 6: Revenue Recognition Accruals
+
+**CAS 14 revenue recognition:**
+
+| Scenario | Recognition | Accrual Impact |
+|-----------|-------------|----------------|
+| 商品销售 (Goods) | 控制权转移时 | 通常为交付时 |
+| 提供服务 (Services) | 期间内逐步 | 劳务成本匹配 |
+| 建造合同 (Construction) | 产出法/投入法 | 长期合同 |
+| 特许经营 (Franchise) | 持续期间 | 品牌使用费 |
+
+**Revenue accrual items:**
+- 发出商品 (Goods in transit)
+- 委托代销 (Consignment)
+- 工程结算 (Construction settlement)
+- 会员费/预付费 (Membership / prepaid)
+
+### Step 7: Period-End Accrual Review
+
+**Month-end / year-end accrual checklist:**
+
+| Area | Items to Review |
+|------|----------------|
+| Revenue | Unbilled revenue, returns, allowances |
+| Purchases | Uninvoiced goods/services |
+| Payroll | Bonus, overtime, social insurance |
+| Interest | Accrued but unpaid |
+| Taxes | Tax provisions |
+| Depreciation | Monthly depreciation |
+| Provisions | Legal, warranty, restructuring |
+
+## China-Specific Considerations
+
+### Common Accrual Patterns
+
+| Industry | Typical Accruals |
+|----------|-----------------|
+| 制造业 | Raw material AP, bonus accruals |
+| 零售 | Lease accruals, loyalty programs |
+| 房地产 | 预收账款 (presale), construction accruals |
+| 建筑 | 工程结算 (progress billing) |
+| 软件 | Deferred revenue, support accruals |
+| 医药 | Rebates, returns provisions |
+
+### Audit Considerations (China)
+
+| Area | Focus |
+|------|-------|
+| 大额应计 | Materiality threshold |
+| 关联方 | Related party payables |
+| 期限 | Aging of receivables |
+| 坏账 | Adequacy of allowance |
+| 政府补助 | Compliance with grant conditions |
+
+## Quality Checks
+
+Before delivering:
+- [ ] All significant accruals identified
+- [ ] Schedule ties to financial statements
+- [ ] Trends analyzed
+- [ ] Quality flags addressed
+- [ ] CAS compliance verified
+- [ ] Audit implications noted
+> **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