@huicai/cli 2026.714.0 → 2026.721.0

package/skills/policy-analysis/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: policy-analysis
+description: 政策解读与企业适配（政策文件拆解、适用性判定、企业行动清单、政策对比、申报窗口台账）。当用户给出政府政策/规划/办法/细则说"解读一下/对我们有什么影响/能享受什么"时使用。
+version: 1.0.0
+---
+
+# 政策解读（从红头文件到企业行动清单）
+
+## 解读流程（长文件走 long-doc-analysis 打底）
+
+1. **文件定位**：发文机关层级（中央/部委/省/市——决定效力与落地时差）、文件性质
+   （法律法规/规章/规范性文件/规划纲要——**规划是方向,细则才有真金白银**）、
+   生效与有效期、是否有配套细则（"另行制定"=先别急着行动,盯细则）;
+2. **五要素拆解表**（逐条过正文）：
+   支持/限制什么（事项）| 谁适用（条件,逐条可判定化）| 给什么/罚什么（金额/比例/资质/额度）|
+   怎么申请/怎么合规（程序/材料/窗口期）| 找谁（主管部门与层级）;
+3. **企业适配判定**：适用条件 × 企业现状对照表（满足/不满足/可创造条件满足——第三类给
+   达标路径与成本,如"研发费占比差 0.8pct,约需调整 X"）;
+4. **行动清单**（解读的唯一交付标准）：每条=动作+负责人建议+窗口期+所需材料+预期收益/风险,
+   按「立即办/规划办/持续跟踪」三档;
+5. **不确定性标注**：条文模糊处如实标注（"'原则上'表述存在弹性,建议向 X 部门书面咨询"）,
+   **不替政府解释政策**——引用原文+我方理解+核实建议三段式。
+
+## 政策对比场景
+
+- 新旧版本对比（doc-compare 打底）：变化点 → 对企业的边际影响（收紧/放宽/新增义务）;
+- 多地政策对比（选址/迁移决策）：同维度矩阵（税收/补贴/人才/用地/门槛）,
+  口径统一后再比（"最高补贴 500 万"要看兑现条件与分期）;
+- 同主题政策族谱：中央 → 省 → 市逐级细化脉络图,找市级执行口径。
+
+## 政策红利盘点（年度动作）
+
+企业画像（行业/规模/资质/研发/用工/区域）× 政策库扫描 → 可享清单
+（每项:依据文件/条件核对/申报窗口/材料/主管部门）→ 台账化跟踪
+（office-automation 例程:窗口期前 30 天提醒）;与 project-proposal 衔接（要申报书的转过去）。
+
+## 风险侧解读（合规义务）
+
+新政带来的**义务**清单（禁止性/限制性/程序性义务,过渡期截止日）→ 现状差距 →
+整改计划（转 risk-compliance 落内控）;处罚条款单独列表（violation→后果,量化的写量化）。
+
+## 验收自查
+
+- [ ] 五要素表覆盖全部条款;适用条件可判定化
+- [ ] 行动清单三档分类,每条有窗口期与材料
+- [ ] 模糊条文标注核实建议,无越权解释
+- [ ] 义务与红利两侧都盘了

package/skills/portfolio-analysis/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: portfolio-analysis
+description: 投资组合分析（持仓贡献分解、Brinson 业绩归因、再平衡偏离、集中度与相关性风险）。当用户给出持仓/组合数据说"组合表现怎么样/收益从哪来/该不该再平衡/风险在哪"时使用。研究工具，不构成投资建议。
+version: 1.0.0
+---
+
+# 投资组合分析（证券技能链 · 组合环；全景见 securities-chain）
+
+合规声明同 quant-analysis：研究工具、不构成投资建议、历史不代表未来——每份产出末尾必带。
+
+## 1. 贡献分解（`read_skill_file` 读 `scripts/portfolio.py`）
+
+`contribution()`：各持仓 贡献 = 权重 × 收益,**加总≡组合收益**（恒等校验内置）——
+"组合涨 3% 谁贡献的"一表看清;正负贡献分列,**头部贡献集中度**
+（前 3 大贡献占比,过高=组合表现系于个别持仓）。
+
+## 2. Brinson 业绩归因（对基准的超额从哪来）
+
+`brinson()` 两因素+交互（BF 模型）：
+- **配置效应** =(w_p−w_b)×(r_b−R_b)：超配了跑赢基准的板块吗;
+- **选择效应** = w_b×(r_p−r_b)：板块内选的标的比板块基准强吗;
+- 交互效应 =(w_p−w_b)×(r_p−r_b);
+- **恒等校验**：三效应之和 ≡ 组合收益 − 基准收益（脚本内置断言）;
+- 解读纪律：单期归因噪声大,**连续多期同向才是能力**（配置一直为正=真会配,
+  单月为正=可能是运气）;基准选择要匹配（成长组合对沪深300 归因意义有限,注明基准）。
+
+## 3. 再平衡与偏离
+
+`weights_drift()`：目标权重 vs 当前权重 → 偏离表+触发建议（阈值法:偏离 >±20% 相对
+或 ±5pct 绝对提示再平衡,**阈值参数化**）;
+再平衡的权衡如实呈现：纪律性收割波动 vs 交易成本与税费——给"偏离度+成本估算"两个数,
+决策留给用户;定投/现金流再平衡（用新增资金纠偏,免卖出成本）优先提示。
+
+## 4. 风险透视
+
+集中度：单一持仓/前五占比、行业与风格集中（**分散的是相关性不是数量**——
+10 只高相关≈1 只）;相关性矩阵（quant-analysis 承接,危机相关性趋同提示）;
+流动性分层（极端情形几天能变现,大额持仓对成交量占比）;
+回撤压力：组合历史最大回撤 + 假设情景（重仓板块 -20% 时组合回撤,给算式）。
+
+## 5. 定期组合报告模板
+
+期间表现（组合 vs 基准,quant perf_stats 四件套）→ 贡献分解 → Brinson 归因
+（多期滚动表）→ 偏离与再平衡建议 → 风险透视 → 附录（数据口径/复权/基准定义/声明）。
+data-analysis 出图（净值对比/贡献瀑布/归因柱状）。
+
+## 验收自查
+
+- [ ] 贡献加总恒等;归因三效应恒等
+- [ ] 基准匹配性已说明;单期归因未下能力结论
+- [ ] 再平衡给偏离+成本两个数,不替用户拍板
+- [ ] 集中度与相关性并报;末尾声明在
+
+## 附件
+
+- `scripts/portfolio.py` — contribution（恒等校验）/ brinson（三效应恒等）/ weights_drift（阈值参数化）;可直接执行自测

package/skills/portfolio-analysis/scripts/portfolio.py

@@ -0,0 +1,78 @@
+# 组合分析计算件（经 run_python 执行）：贡献分解（恒等）/ Brinson 两因素+交互归因（恒等）/ 再平衡偏离。
+# ⚠ 研究工具，不构成投资建议。直接执行本文件 = 自测。
+import pandas as pd
+
+
+def contribution(df, name_col='持仓', w_col='权重', r_col='收益率'):
+    """贡献 = 权重×收益，加总 ≡ 组合收益（权重和须=1）。"""
+    d = df.copy()
+    wsum = d[w_col].sum()
+    if abs(wsum - 1) > 1e-6:      # 权重未归一：明确报错（ValueError 而非 assert——-O 下 assert 会被跳过）
+        raise ValueError(f'权重和={wsum:.4f}≠1，请先归一化（每项权重/权重合计）再算')
+    raw = d[w_col] * d[r_col]     # 组合收益用**未取整**求和保精度；四舍五入只用于展示列
+    port = float(raw.sum())
+    d['贡献'] = raw.round(6)
+    d = d.sort_values('贡献', ascending=False)
+    top3 = d['贡献'].head(3).sum() / port if port else float('nan')
+    print(f'[贡献] 组合收益 {port:+.2%} · 前3大贡献占比 {top3:.0%}' if port else f'[贡献] 组合收益 {port:+.2%}')
+    print(d.to_markdown(index=False))
+    return d, round(port, 6)
+
+
+def brinson(df, seg_col='板块', wp='组合权重', rp='组合收益', wb='基准权重', rb='基准收益'):
+    """Brinson-Fachler：配置=(wp-wb)(rb-Rb)；选择=wb(rp-rb)；交互=(wp-wb)(rp-rb)。
+    三效应之和 ≡ 组合收益 − 基准收益（恒等断言）。"""
+    d = df.copy()
+    for c in (wp, wb):
+        assert abs(d[c].sum() - 1) < 1e-6, f'{c} 和须为 1'
+    Rb = float((d[wb] * d[rb]).sum())
+    Rp = float((d[wp] * d[rp]).sum())
+    d['配置效应'] = ((d[wp] - d[wb]) * (d[rb] - Rb)).round(6)
+    d['选择效应'] = (d[wb] * (d[rp] - d[rb])).round(6)
+    d['交互效应'] = ((d[wp] - d[wb]) * (d[rp] - d[rb])).round(6)
+    total = d[['配置效应', '选择效应', '交互效应']].sum().sum()
+    excess = Rp - Rb
+    assert abs(total - excess) < 1e-9, f'归因恒等校验失败：{total} vs {excess}'
+    print(f'[Brinson] 组合 {Rp:+.2%} − 基准 {Rb:+.2%} = 超额 {excess:+.2%} '
+          f'（配置 {d["配置效应"].sum():+.2%} + 选择 {d["选择效应"].sum():+.2%} + 交互 {d["交互效应"].sum():+.2%}）')
+    print(d.to_markdown(index=False))
+    return d, {'Rp': Rp, 'Rb': Rb, 'excess': round(excess, 6)}
+
+
+def weights_drift(df, name_col='持仓', target_col='目标权重', cur_col='当前权重',
+                  abs_th=0.05, rel_th=0.20):
+    """再平衡偏离：绝对偏离>abs_th 或相对偏离>rel_th 触发提示（阈值参数化，决策留给用户）。"""
+    d = df.copy()
+    d['绝对偏离'] = (d[cur_col] - d[target_col]).round(4)
+    d['相对偏离'] = ((d[cur_col] / d[target_col] - 1)).round(4)
+    d['触发'] = (d['绝对偏离'].abs() > abs_th) | (d['相对偏离'].abs() > rel_th)
+    n = int(d['触发'].sum())
+    print(f'[偏离] 触发再平衡提示 {n} 项（阈值：绝对 ±{abs_th:.0%} 或相对 ±{rel_th:.0%}）')
+    print(d.to_markdown(index=False))
+    return d
+
+
+if __name__ == '__main__':
+    hold = pd.DataFrame({'持仓': ['A', 'B', 'C'], '权重': [0.5, 0.3, 0.2],
+                         '收益率': [0.10, -0.05, 0.02]})
+    d, port = contribution(hold)
+    assert abs(port - (0.05 - 0.015 + 0.004)) < 1e-9
+    br = pd.DataFrame({'板块': ['科技', '消费', '金融'],
+                       '组合权重': [0.5, 0.3, 0.2], '组合收益': [0.12, 0.02, -0.01],
+                       '基准权重': [0.4, 0.4, 0.2], '基准收益': [0.10, 0.03, 0.00]})
+    bd, meta = brinson(br)
+    assert abs((bd['配置效应'] + bd['选择效应'] + bd['交互效应']).sum() - meta['excess']) < 1e-9
+    assert meta['excess'] > 0  # 超配跑赢板块+选股占优 → 应为正超额
+    wd = weights_drift(pd.DataFrame({'持仓': ['A', 'B'], '目标权重': [0.6, 0.4],
+                                     '当前权重': [0.68, 0.32]}))
+    assert bool(wd.loc[0, '触发']) and bool(wd.loc[1, '触发'])  # 相对偏离 ±20% 触发
+    # 任意精度权重/收益（归一化后含长尾小数）不得崩——曾因"取整和 vs 未取整和"的错误断言在真实浮点上炸
+    _raw = [0.37, 0.29, 0.34]; _tot = sum(_raw); _w = [x / _tot for x in _raw]; _r = [0.137, -0.021, 0.0913]
+    _df2, _port = contribution(pd.DataFrame({'持仓': list('ABC'), '权重': _w, '收益率': _r}))
+    assert abs(_port - sum(wi * ri for wi, ri in zip(_w, _r))) < 1e-9  # 组合收益取未取整和，精确对得上
+    try:
+        contribution(pd.DataFrame({'持仓': ['X'], '权重': [0.5], '收益率': [0.1]}))
+        raise SystemExit('权重未归一应报错')
+    except ValueError:
+        pass
+    print('OK portfolio.py')

package/skills/ppt-chain/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: ppt-chain
+description: PPT 制作技能链总控（需求→大纲→素材→引擎选择→生成自检→导出→演讲全链、经营月报/方案书/发布会三条端到端工作流）。当用户要"做个 PPT"而场景/引擎/素材未定，或诉求跨环节（"从数据到汇报"）时先载入。
+version: 1.0.0
+---
+
+# PPT 制作技能链总控
+
+一份 PPT 的失败极少在排版,几乎都在**前置**:不知道讲给谁、一页塞三个观点、数字来路不明。
+本链把功夫花在生成之前。
+
+## 需求四问（任何 PPT 开工前）
+
+听众是谁（决策者要结论/专家要论证/大众要故事）→ 场合与时长（8 分钟路演 ≤12 页;
+被打断式汇报每页要能独立成立）→ 目的一句话（听完希望对方做什么）→
+**交付形态**（现场讲/发出去自读——自读版信息要自足,现场版要留白给讲）。
+
+## 引擎决策表（双引擎，按需选）
+
+| 维度 | pptx-author（python-pptx） | slides-html（渲染管线，桌面端） |
+|---|---|---|
+| 可编辑性 | ✅ 原生可改 | ❌ 贴图（如实告知） |
+| 设计表现力 | 常规版式 | ✅ 渐变/精细排版/发布会级 |
+| 适用 | 日常汇报/需二次编辑/模板合规 | 对外发布/路演/交付 PDF |
+| 自检 | verify 页数标题 | ✅ 截图注入逐页自检闭环 |
+
+品牌规范（色/字/logo）从 brand-design 的 VI 取;两引擎主题色系同源。
+
+## 通用生产线（六步）
+
+1. **大纲**（一页一论点,每页=标题(结论式)+支撑要点,先出大纲**必须确认再生成**）;
+2. **数据与图表**：数字全部可溯源（data-chain 口径）;图表按 data-analysis 规范生成 png
+   （中文字体!）;一页一图;
+3. **素材**：图片版权可用性;图标用 Emoji/内联 SVG（slides-html 禁外链）;
+4. **生成**：按引擎决策表;结构页型（封面/目录/章节/要点/图文/KPI/引用/结尾）套用;
+5. **自检**：验收清单（无溢出/无缺字/主题一致/页码/数字与来源核对——**讲错一个数,
+  整场信用清零**,同述职纪律）;
+6. **导出与演讲**：PDF（通用）/PPTX/放映页;讲稿按 260 字/分钟配时（okr-review 口径）,
+   QA 预演（pr-comms 攻防表）。
+
+## 端到端工作流
+
+### ① 经营月报链（每月）
+finance-chain 月结产物（报表+差异+比率）→ 要点提炼（结论卡三件事,management-accounting
+"所以呢"纪律）→ 图表组（趋势/瀑布/KPI）→ pptx-author 常规版式（管理层要能改）→
+自检数字核对 → 呈报归档（`财务/YYYY-MM/` 同目录,链上同源）。例程化：月度 5 日自动出初稿。
+
+### ② 方案书/标书演示链（按单）
+内容源（business-plan 或 tender-bidding 的定稿文档——**PPT 是文档的浓缩,不是另写一份**）→
+逐页大纲对齐评分点/投资人质疑清单 → 数据页（估值敏感性/报价构成）→
+slides-html 设计版（对外形象）→ 现场备份 PDF+PPTX 双格式（客户环境不可控）。
+
+### ③ 发布会链（大场）
+marketing-chain 新品上市链的发布环节 → SMP 一句话贯穿全 deck（brand-design）→
+slides-html 四主题选型+定制封面 → 逐页截图自检至无溢出 → 放映页现场演示
+（键盘翻页,内置浏览器全屏）→ 讲稿与彩排（event-management Run Sheet 挂接）。
+
+## 使用纪律
+
+大纲未确认不生成;数字未溯源不上页;PPTX 贴图版的不可编辑性**必须**提前告知;
+模板资产沉淀（好版式回写团队模板,knowledge-sop 管理）。

package/skills/pptx-author/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: pptx-author
+description: 生成 PPT 演示文稿。当用户说"做个 PPT/幻灯片/汇报材料/演示文稿/pptx"时使用。
+version: 1.0.0
+---
+
+# PPT 生成（经 run_python 执行，python-pptx 已随托管运行时就绪）
+
+## 流程
+
+1. **大纲先行**：先在回复里给出逐页大纲（每页=标题 + ≤5 条要点 + 可选备注），页数建议 8–15；重要汇报让用户确认再生成。
+2. **选主题**：`read_skill_file` 读本技能 `scripts/pptx_deck.py`，内置四套配色主题——`navy`（深蓝商务，默认）/ `tech`（科技紫）/ `mono`(极简灰) / `warm`（活力橙）。用户有品牌色时改 `THEMES` 传自定义。
+3. **逐页构建**（16:9，helper 已处理版式/配色/字体）：
+   ```python
+   d = Deck(theme='navy')
+   d.add_cover('2026 上半年经营分析', '数据一部 · 2026-07')
+   d.add_agenda(['经营概览', '分区域表现', '问题与对策', '下半年计划'])
+   d.add_section('一、经营概览')
+   d.add_bullets('核心指标', ['营收 3.6 亿，同比 +18%', '毛利率 32.5%，环比 +1.2pct'], notes='强调同比口径')
+   d.add_image('分区域销售', '销售图.png', caption='华东领先，西南承压')
+   d.add_table('明细数据', [['地区','销售额','同比'], ['华东','1.2亿','+21%']])
+   d.add_end('谢谢，欢迎讨论')
+   d.save('经营分析.pptx')
+   ```
+4. **图表页**：先按 data-analysis 技能出 png（务必先设中文字体），再 `add_image` 插入——比 pptx 原生图表稳定且好看。
+5. **验收（必做）**：`verify('产物.pptx')` 重开打印页数与每页标题，对照大纲无缺页。
+
+## 设计约束（避免"惨不忍睹"的 PPT）
+
+- 一页一个观点；要点每条 ≤20 字；超了就拆页或进备注。
+- 数字是主角：关键数字用 `add_kpi`（大数字卡片页）而非藏在句子里。
+- 不堆图：一页一图；表格 ≤7 行，更多的放 xlsx 附件并在页脚注明。
+- 中文字体 helper 已设（微软雅黑/苹方由播放机器渲染，不嵌字体）。
+
+## 桌面端「炫酷版」提示
+
+python-pptx 走的是标准版式，追求设计感/动效的发布会级 PPT 属 M5-⑤ HTML 幻灯片管线（桌面端渲染导出）。用户明确要"炫酷/设计感"时：先用本技能出**结构定稿**，并说明设计版能力的边界。
+
+## 验收自查
+
+- [ ] verify 输出的页数与标题和大纲一致
+- [ ] 每页要点 ≤5 条、每条 ≤20 字（超限已拆页/进备注）
+- [ ] 插图的 png 中文显示正常（画图前设了字体）
+- [ ] 文件名是中文描述性名称，已 print 产物清单
+
+## 附件
+
+- `scripts/pptx_deck.py` — Deck 构建器：四主题配色、cover/agenda/section/bullets/kpi/image/table/end 八种版式、`verify()` 重读校验；可直接执行自测

package/skills/pptx-author/scripts/pptx_deck.py

@@ -0,0 +1,193 @@
+# PPT 构建器（经 run_python 执行）。16:9 空白版式全手绘（不依赖模板文件），四套主题配色，
+# 八种版式：cover / agenda / section / bullets / kpi / image / table / end；notes 进演讲备注。
+# 直接执行本文件 = 自测：产出 pptx_deck_check.pptx 并重读校验。
+import base64
+
+from pptx import Presentation
+from pptx.dml.color import RGBColor
+from pptx.enum.text import PP_ALIGN
+from pptx.oxml.ns import qn
+from pptx.util import Emu, Inches, Pt
+
+THEMES = {
+    'navy': dict(primary='1F4E79', accent='2E75B6', light='DEEBF7', text='333333'),  # 深蓝商务（默认）
+    'tech': dict(primary='5B2D90', accent='9A66CC', light='EDE4F7', text='333333'),  # 科技紫
+    'mono': dict(primary='404040', accent='7F7F7F', light='F2F2F2', text='333333'),  # 极简灰
+    'warm': dict(primary='C55A11', accent='ED7D31', light='FBE5D6', text='3B3B3B'),  # 活力橙
+}
+FONT = '微软雅黑'  # 播放端渲染（mac 自动回退苹方），不嵌字体
+
+
+def _style(run, size=18, bold=False, color='333333', font=FONT):
+    f = run.font
+    f.name = font
+    f.size = Pt(size)
+    f.bold = bold
+    f.color.rgb = RGBColor.from_string(color)
+    # 中文字体需另设 <a:ea>（run.font.name 只设拉丁 <a:latin>）；用 lxml 直建，兼容各版本 python-pptx
+    from lxml import etree
+    rPr = run._r.get_or_add_rPr()
+    ea = rPr.find(qn('a:ea'))
+    if ea is None:
+        ea = etree.SubElement(rPr, qn('a:ea'))
+    ea.set('typeface', font)
+
+
+class Deck:
+    def __init__(self, theme='navy'):
+        self.t = THEMES.get(theme, THEMES['navy'])
+        self.prs = Presentation()
+        self.prs.slide_width = Inches(13.333)
+        self.prs.slide_height = Inches(7.5)
+
+    # ── 内部小件 ──────────────────────────────────────────────
+    def _slide(self, notes=None):
+        s = self.prs.slides.add_slide(self.prs.slide_layouts[6])  # 空白版式
+        if notes:
+            s.notes_slide.notes_text_frame.text = notes
+        return s
+
+    def _rect(self, s, x, y, w, h, color):
+        from pptx.enum.shapes import MSO_SHAPE
+        r = s.shapes.add_shape(MSO_SHAPE.RECTANGLE, x, y, w, h)
+        r.fill.solid()
+        r.fill.fore_color.rgb = RGBColor.from_string(color)
+        r.line.fill.background()
+        return r
+
+    def _text(self, s, x, y, w, h, text, size=18, bold=False, color=None, align=PP_ALIGN.LEFT):
+        tb = s.shapes.add_textbox(x, y, w, h)
+        tf = tb.text_frame
+        tf.word_wrap = True
+        p = tf.paragraphs[0]
+        p.alignment = align
+        _style(p.add_run(), size, bold, color or self.t['text'])
+        p.runs[0].text = text
+        return tf
+
+    def _title(self, s, text):
+        self._rect(s, 0, 0, self.prs.slide_width, Inches(0.12), self.t['accent'])
+        self._text(s, Inches(0.6), Inches(0.35), Inches(12), Inches(0.9), text, size=28, bold=True, color=self.t['primary'])
+
+    # ── 八种版式 ──────────────────────────────────────────────
+    def add_cover(self, title, subtitle='', notes=None):
+        s = self._slide(notes)
+        self._rect(s, 0, 0, self.prs.slide_width, self.prs.slide_height, self.t['primary'])
+        self._text(s, Inches(1), Inches(2.6), Inches(11.3), Inches(1.4), title, size=44, bold=True, color='FFFFFF', align=PP_ALIGN.CENTER)
+        if subtitle:
+            self._text(s, Inches(1), Inches(4.2), Inches(11.3), Inches(0.8), subtitle, size=18, color='DDE7F3', align=PP_ALIGN.CENTER)
+        return s
+
+    def add_agenda(self, items, title='目录', notes=None):
+        s = self._slide(notes)
+        self._title(s, title)
+        tb = s.shapes.add_textbox(Inches(1.2), Inches(1.7), Inches(10.5), Inches(5))
+        tf = tb.text_frame
+        tf.word_wrap = True
+        for i, it in enumerate(items):
+            p = tf.paragraphs[0] if i == 0 else tf.add_paragraph()
+            p.space_after = Pt(14)
+            _style(p.add_run(), 22, False, self.t['text'])
+            p.runs[0].text = f'{i + 1}　{it}'
+        return s
+
+    def add_section(self, title, notes=None):
+        s = self._slide(notes)
+        self._rect(s, 0, Inches(3.2), self.prs.slide_width, Inches(1.2), self.t['light'])
+        self._text(s, Inches(1), Inches(3.35), Inches(11.3), Inches(0.9), title, size=32, bold=True, color=self.t['primary'], align=PP_ALIGN.CENTER)
+        return s
+
+    def add_bullets(self, title, bullets, notes=None):
+        s = self._slide(notes)
+        self._title(s, title)
+        tb = s.shapes.add_textbox(Inches(0.9), Inches(1.6), Inches(11.5), Inches(5.3))
+        tf = tb.text_frame
+        tf.word_wrap = True
+        for i, b in enumerate(bullets):
+            p = tf.paragraphs[0] if i == 0 else tf.add_paragraph()
+            p.space_after = Pt(12)
+            _style(p.add_run(), 20, False, self.t['text'])
+            p.runs[0].text = '•  ' + str(b)
+        return s
+
+    def add_kpi(self, title, kpis, notes=None):
+        """kpis: [(大数字, 说明)]，最多 4 个卡片。"""
+        s = self._slide(notes)
+        self._title(s, title)
+        n = min(len(kpis), 4)
+        w = Inches(2.7)
+        gap = (self.prs.slide_width - n * w) / (n + 1)
+        for i, (num, label) in enumerate(kpis[:4]):
+            x = gap * (i + 1) + w * i
+            self._rect(s, x, Inches(2.4), w, Inches(2.2), self.t['light'])
+            self._text(s, x, Inches(2.7), w, Inches(1), str(num), size=36, bold=True, color=self.t['primary'], align=PP_ALIGN.CENTER)
+            self._text(s, x, Inches(3.8), w, Inches(0.6), str(label), size=14, color=self.t['text'], align=PP_ALIGN.CENTER)
+        return s
+
+    def add_image(self, title, image_path, caption='', notes=None):
+        s = self._slide(notes)
+        self._title(s, title)
+        pic = s.shapes.add_picture(image_path, Inches(1), Inches(1.6), height=Inches(4.6))
+        if pic.width > self.prs.slide_width - Inches(1):  # 超宽图改按宽度适配
+            s.shapes._spTree.remove(pic._element)
+            pic = s.shapes.add_picture(image_path, Inches(1), Inches(1.6), width=self.prs.slide_width - Inches(2))
+        pic.left = int((self.prs.slide_width - pic.width) / 2)
+        if caption:
+            self._text(s, Inches(1), Inches(6.4), Inches(11.3), Inches(0.6), caption, size=14, color='777777', align=PP_ALIGN.CENTER)
+        return s
+
+    def add_table(self, title, rows, notes=None):
+        s = self._slide(notes)
+        self._title(s, title)
+        nr, nc = len(rows), len(rows[0])
+        tb = s.shapes.add_table(nr, nc, Inches(0.9), Inches(1.7), Inches(11.5), Inches(0.5) * nr).table
+        for i, row in enumerate(rows):
+            for j, val in enumerate(row):
+                cell = tb.cell(i, j)
+                cell.text = str(val)
+                p = cell.text_frame.paragraphs[0]
+                _style(p.runs[0] if p.runs else p.add_run(), 14, i == 0, 'FFFFFF' if i == 0 else self.t['text'])
+                if i == 0:
+                    cell.fill.solid()
+                    cell.fill.fore_color.rgb = RGBColor.from_string(self.t['primary'])
+        return s
+
+    def add_end(self, text='谢谢', notes=None):
+        s = self._slide(notes)
+        self._rect(s, 0, 0, self.prs.slide_width, self.prs.slide_height, self.t['primary'])
+        self._text(s, Inches(1), Inches(3.1), Inches(11.3), Inches(1.2), text, size=40, bold=True, color='FFFFFF', align=PP_ALIGN.CENTER)
+        return s
+
+    def save(self, path):
+        self.prs.save(path)
+        return path
+
+
+def verify(path):
+    """重读校验（验收步骤用）：打印页数与每页首个文本。"""
+    prs = Presentation(path)
+    n = len(prs.slides)
+    print(f'[verify] 共 {n} 页')
+    for i, s in enumerate(prs.slides, 1):
+        first = next((sh.text_frame.text.split('\n')[0] for sh in s.shapes
+                      if sh.has_text_frame and sh.text_frame.text.strip()), '（无文本）')
+        print(f'  p{i}: {first[:40]}')
+    return n
+
+
+if __name__ == '__main__':
+    png = 'pptx_deck_check.png'  # 1x1 红点 png，占位自测（真实场景用 matplotlib 产图）
+    open(png, 'wb').write(base64.b64decode(
+        'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=='))
+    d = Deck('navy')
+    d.add_cover('自测演示', 'pptx_deck.py 冒烟', notes='备注示例')
+    d.add_agenda(['概览', '数据', '结论'])
+    d.add_section('一、概览')
+    d.add_bullets('要点', ['要点甲', '要点乙', '要点丙'])
+    d.add_kpi('核心指标', [('3.6亿', '营收'), ('+18%', '同比'), ('32.5%', '毛利率')])
+    d.add_image('示意图', png, caption='占位图')
+    d.add_table('明细', [['地区', '销售额'], ['华东', '1200'], ['华南', '950']])
+    d.add_end()
+    p = d.save('pptx_deck_check.pptx')
+    verify(p)
+    print('OK', p)

package/skills/pr-comms/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: pr-comms
+description: 公共关系与企业传播（新闻稿、危机公关分级响应、媒体 Q&A、高管演讲稿、舆情分析报表）。当用户说"新闻稿/官方声明/危机公关/媒体问答/发言稿/舆情"时使用。
+version: 1.0.0
+---
+
+# 公共关系（新闻稿范式 + 危机分级 SOP + Q&A 攻防 + 舆情报表）
+
+## 新闻稿（倒金字塔，别写成散文）
+
+结构：标题（事实+亮点,≤25 字,禁自嗨形容词堆叠）→ 导语（5W1H 一段说完,最重要的排最前）→
+主体（重要性递减:核心事实 → 数据支撑 → 高管引语 → 背景）→ 公司介绍(boilerplate) → 媒体联系人。
+硬规则：
+- 每个数据有出处;没授权的客户名/合作方名不出现;
+- 高管引语要"像人话且只有他能说"（战略判断/取舍/情感）,不复述正文;
+- 首发时间与禁运期(embargo)标注;
+- 产出双版本：完整版 + 300 字通稿版（给转载）。
+
+## 危机公关（先定级，再按 SOP 走）
+
+| 级别 | 特征 | 响应时限 | 动作 |
+|---|---|---|---|
+| L1 轻微 | 个别投诉/小范围误读 | 24h | 客服口径统一,不上升 |
+| L2 中度 | 媒体点名/话题发酵中 | 4h | 事实核查→口径三件套→定向沟通关键媒体 |
+| L3 重大 | 全网热议/监管关注/安全事故 | 1h 内首响 | 声明+发布会准备+专项组+法务同步 |
+
+**首响声明五要素**（L2/L3）：确认知悉 → 已采取的行动 → 核查态度（不甩锅不定责）→
+后续通报时间承诺 → 反馈渠道。**红线**：未核实先否认、删帖式应对、攻击爆料方、
+"临时工"话术、承诺做不到的时限。
+声明措辞三稿制：事实版（法务视角,只说确定的事）→ 温度版（加同理与歉意）→ 终版（两者平衡）。
+
+## 媒体 Q&A（攻防手册）
+
+按「必问题/敏感题/陷阱题」三档准备,每题给：核心口径（一句）+ 支撑点（≤3）+ 桥接话术
+（"这个问题的关键其实是…"）+ **禁区**（绝不能说的词句）。
+陷阱题应对：二选一陷阱不接前提;假设性问题回到事实;引用匿名信源要求具体化。
+
+## 舆情分析报表（数据侧走 data-analysis）
+
+声量趋势（事件标注）/ 情感分布（正负中,口径注明是模型判定）/ 渠道分布 / TOP 传播节点 /
+高频负面关键词——结论落到「风险点 + 建议动作 + 监测阈值」。日报一页,周报带对比。
+
+## 高管演讲稿
+
+先要三件事：场合与听众/时长（≈260字/分钟）/一句话核心观点。
+结构：钩子（数据/故事/反常识）→ 观点 → 三个支撑（各带案例）→ 呼应收尾。
+口语化改写：短句、有停顿标记、去书面语（"进行了"→"做了"）。
+
+## 验收自查
+
+- [ ] 新闻稿导语 5W1H 完整,数据有出处,双版本齐
+- [ ] 危机响应先定级,声明含五要素,无红线话术
+- [ ] Q&A 覆盖敏感题与陷阱题,每题有禁区
+- [ ] 舆情结论落到动作与阈值,情感口径已注明
+
+## 附件
+
+- `references/pr-templates.md` — 新闻稿骨架 / 三级声明模板 / Q&A 表结构 / 舆情日报模板

package/skills/pr-comms/references/pr-templates.md

@@ -0,0 +1,54 @@
+# PR 模板库（按需取用，填空处以【】标注）
+
+## 新闻稿骨架
+
+```
+【公司】发布【产品/事件】，【最有新闻价值的一点】
+
+【城市】【日期】——【公司全称】今日宣布【核心事实】。【最关键数据/影响一句】。
+
+【主体段1：核心事实展开，含可验证数据与出处】
+【主体段2：数据/客户/场景支撑】
+
+【公司职务】【姓名】表示："【战略判断/取舍/愿景，一段像人话的引语】"
+
+【背景段：行业背景/此前进展】
+
+关于【公司】
+【boilerplate，100 字内，全公司统一版本】
+
+媒体联系人：【姓名】｜【邮箱】｜【电话】
+（如有禁运期：EMBARGO until 【时间】）
+```
+
+## 危机声明模板（按级取用）
+
+**L2 中度（4 小时内）**
+```
+关于【事件】的说明
+我们已关注到【渠道】关于【事件】的反馈。【已确认的事实一句，未确认的不写】。
+我们已【已采取的动作：成立核查/暂停相关服务/联系当事人】。
+对由此给【对象】带来的困扰，我们深表歉意。核查结果将于【时间】前通过【渠道】通报。
+反馈渠道：【电话/邮箱】。
+                                        【公司】 【日期】
+```
+
+**L3 重大（1 小时内首响，宁短勿错）**
+```
+我们已知悉【事件】，并第一时间【动作：启动应急预案/配合有关部门/救治安置】。
+目前【仅写已核实事实】。我们将持续通报进展，下次通报不晚于【时间】。
+```
+> L3 首响禁止：定责、猜测原因、承诺赔偿数额、"个别员工行为"。
+
+## 媒体 Q&A 表结构
+
+| # | 类型(必问/敏感/陷阱) | 问题 | 核心口径(一句) | 支撑点 | 桥接话术 | 禁区 |
+|---|---|---|---|---|---|---|
+
+## 舆情日报模板（一页）
+
+- 总声量：N（环比 ±%），负面占比 %（口径：模型判定/人工抽核 n 条准确率 %）
+- 趋势图（事件标注）｜渠道 TOP3 ｜ 传播关键节点（账号/阅读量）
+- 负面高频词：…（各附典型原文 1 条）
+- 风险研判：【级别 + 依据】
+- 建议动作：【谁/何时/做什么】｜监测阈值：负面占比 >【】% 或单帖互动 >【】即升级

package/skills/procurement-supply/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: procurement-supply
+description: 采购与供应链（询比价分析、供应商评估评分卡、ABC 库存分析、周转与呆滞、采购降本报告）。当用户说"比价/供应商评估/库存分析/呆滞料/采购分析/降本"时使用。
+version: 1.0.0
+---
+
+# 采购与供应链（比价可复算 + 评分卡制度化 + 库存分层治理）
+
+## 询比价分析
+
+- 报价对齐口径先行：**总拥有成本 TCO** 而非裸单价——含税/运费/付款条件（账期折现）/
+  最小起订/模具分摊/质保;不同币种统一并注明汇率与日期;
+- 比价表：物料×供应商矩阵,TCO 分解列 + 资质硬门槛列（不满足直接置灰不参与比价）;
+- 议价筹码清单：量的承诺/付款条件互换/竞对报价（合规使用）/长协锁价;
+- 结论给「推荐+理由+风险」而非只给最低价（最低价+单一来源=风险敞口）。
+
+## 供应商评估（`read_skill_file` 读 `scripts/supply.py`）
+
+- `supplier_scorecard()`：维度权重制评分卡（质量 30/交付 25/成本 20/服务 15/合规与财务 10 为
+  缺省,可调）——每维给数据口径（质量=批次合格率/PPM,交付=OTD 准时率）,输出总分排名 +
+  雷达数据 + 分级（A 战略/B 优选/C 观察/D 退出）;
+- 评审节奏：季度评分卡+年度现场审核;C/D 级触发改进函（含指标/期限/复评安排）;
+- 新供应商准入清单：三证资质/样品验证/小批量试产/账期与廉洁协议（合同细节转 legal-contract）。
+
+## 库存分析（`supply.py`）
+
+- `abc_analysis()`：按金额累计占比分 A(70%)/B(20%)/C(10%)——A 类精细管理（安全库存+周盘点）,
+  C 类简化（双箱法/季度盘）;可叠加 XYZ（需求波动）成九宫格策略;
+- `turnover_days()`：周转天数=平均库存/日均出库;**呆滞判定**：N 天无动销且库存>阈值 →
+  呆滞清单（金额排序）+ 处置建议阶梯（调拨→促销→折价→报废,报废走审批）;
+- 缺货与超储同表呈现（安全库存对比）,只报呆滞不报缺货是半份报告。
+
+## 采购降本报告
+
+降本口径要诚实：**价格降幅 ≠ 降本金额**（量变化要剥离）;年化口径注明;
+降本五路径归类呈现（谈判/替代料/集采/流程/付款条件）,每项给证据（合同/订单前后对比）。
+
+## 验收自查
+
+- [ ] 比价用 TCO 口径且汇率/税注明
+- [ ] 评分卡每维有数据口径,分级有动作
+- [ ] 呆滞清单带处置阶梯;缺货风险同报
+- [ ] 降本剥离了量因素
+
+## 附件
+
+- `scripts/supply.py` — supplier_scorecard / abc_analysis / turnover_days（含呆滞判定）;可直接执行自测