@huicai/cli 2026.714.0 → 2026.721.0

package/skills/procurement-supply/scripts/supply.py

@@ -0,0 +1,71 @@
+# 采购供应链计算件（经 run_python 执行）：供应商评分卡 / ABC 分析 / 周转与呆滞。
+# 直接执行本文件 = 自测。
+import numpy as np
+import pandas as pd
+
+DEFAULT_WEIGHTS = {'质量': 30, '交付': 25, '成本': 20, '服务': 15, '合规财务': 10}
+GRADES = [(85, 'A-战略'), (75, 'B-优选'), (60, 'C-观察'), (0, 'D-退出')]
+
+
+def supplier_scorecard(scores, weights=None):
+    """scores: DataFrame（行=供应商，列=维度，0–100 分）。返回带加权总分/排名/分级的表。"""
+    w = weights or DEFAULT_WEIGHTS
+    assert abs(sum(w.values()) - 100) < 1e-6, '权重和须为 100'
+    miss = [c for c in w if c not in scores.columns]
+    assert not miss, f'缺维度列：{miss}'
+    out = scores.copy()
+    out['总分'] = sum(out[c] * p / 100 for c, p in w.items()).round(1)
+    out['排名'] = out['总分'].rank(ascending=False, method='min').astype(int)
+    out['分级'] = out['总分'].map(lambda s: next(g for th, g in GRADES if s >= th))
+    out = out.sort_values('总分', ascending=False)
+    print(f'[评分卡] 权重={w}')
+    print(out.to_markdown())
+    return out
+
+
+def abc_analysis(df, item_col, amount_col, a=0.7, b=0.9):
+    """按金额累计占比分级：A≤70%、B≤90%、其余 C。返回带累计占比与级别的表。"""
+    g = df.groupby(item_col, as_index=False, observed=True)[amount_col].sum() \
+          .sort_values(amount_col, ascending=False).reset_index(drop=True)
+    g['累计占比'] = (g[amount_col].cumsum() / g[amount_col].sum()).round(4)
+    g['级别'] = np.where(g['累计占比'] <= a, 'A', np.where(g['累计占比'] <= b, 'B', 'C'))
+    stat = g.groupby('级别', observed=True).agg(品项数=(item_col, 'size'),
+                                                金额=(amount_col, 'sum')).round(1)
+    print('[ABC]\n' + stat.to_markdown())
+    return g
+
+
+def turnover_days(inv_df, out_df, item_col, qty_col, days=90, stagnant_days=60, stagnant_min=0):
+    """周转天数与呆滞：inv=当前库存（品项,数量）；out=期间出库明细（品项,数量,可含日期）。
+    周转天数=库存/日均出库；期间出库=0 且库存>stagnant_min → 呆滞。"""
+    o = out_df.groupby(item_col, observed=True)[qty_col].sum().rename('期间出库')
+    m = inv_df.set_index(item_col).join(o).fillna({'期间出库': 0}).reset_index()
+    m['日均出库'] = m['期间出库'] / days
+    m['周转天数'] = np.where(m['日均出库'] > 0, m[qty_col] / m['日均出库'], np.inf).round(1)
+    m['呆滞'] = (m['期间出库'] == 0) & (m[qty_col] > stagnant_min)
+    n_stag = int(m['呆滞'].sum())
+    print(f'[周转] 品项 {len(m)} · 呆滞 {n_stag} · 周转天数中位 '
+          f"{m.loc[np.isfinite(m['周转天数']), '周转天数'].median():.0f} 天（观察期 {days} 天口径）")
+    return m
+
+
+if __name__ == '__main__':
+    sc = pd.DataFrame({'质量': [92, 78, 65], '交付': [88, 82, 70], '成本': [70, 85, 90],
+                       '服务': [85, 75, 60], '合规财务': [90, 80, 55]},
+                      index=['甲供', '乙供', '丙供'])
+    card = supplier_scorecard(sc)
+    assert card.iloc[0].name == '甲供' and card.loc['丙供', '分级'].startswith(('C', 'D'))
+
+    rng = np.random.default_rng(3)
+    items = pd.DataFrame({'物料': [f'M{i:03d}' for i in range(100)],
+                          '金额': np.sort(rng.pareto(1.5, 100) * 1000)[::-1].round(0)})
+    abc = abc_analysis(items, '物料', '金额')
+    assert (abc[abc['级别'] == 'A']['金额'].sum() / abc['金额'].sum()) <= 0.72
+    assert set(abc['级别']) == {'A', 'B', 'C'}
+
+    inv = pd.DataFrame({'物料': ['M001', 'M002', 'M003'], '数量': [900, 50, 300]})
+    out = pd.DataFrame({'物料': ['M001'] * 3 + ['M002'], '数量': [30, 30, 30, 5]})
+    t = turnover_days(inv, out, '物料', '数量', days=90)
+    assert bool(t.loc[t['物料'] == 'M003', '呆滞'].iloc[0]) is True
+    assert abs(t.loc[t['物料'] == 'M001', '周转天数'].iloc[0] - 900) < 1
+    print('OK supply.py')

package/skills/product-design/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: product-design
+description: 产品设计与需求文档（PRD、用户故事与验收标准、竞品拆解、埋点方案、需求评审）。当用户说"写 PRD/需求文档/用户故事/竞品拆解/埋点/产品方案"时使用。
+version: 1.0.0
+---
+
+# 产品设计（PRD 范式 + 可验收的需求 + 竞品拆解 + 埋点）
+
+## PRD（`read_skill_file` 读 `references/prd-framework.md` 取完整骨架）
+
+七段结构：背景与问题（数据佐证的痛点,不是"为了体验更好"）→ 目标与非目标
+（**非目标必须写**,砍范围的依据）→ 用户与场景（画像+触发场景）→ 方案总览（流程图文字版/信息架构）→
+功能详述（逐功能:交互规则+边界条件+异常态）→ 数据与埋点 → 发布计划（灰度/回滚条件）。
+
+**功能详述的深度标准**（区别于"简单实现"的关键）：
+- 每个输入给：类型/长度/校验规则/默认值/为空时;
+- 每个列表给：排序规则/分页/空态文案/加载失败态;
+- 每个操作给：权限/二次确认与否/操作后去向/可撤销否;
+- 状态机类（订单/审核）给状态迁移表：状态×动作→新状态+触发通知。
+
+## 用户故事与验收标准
+
+故事：As a【角色】I want【能力】so that【价值】——价值写不出=伪需求。
+验收用 Gherkin：
+```
+Given 已登录的普通用户且购物车为空
+When 点击「立即购买」
+Then 跳转确认页且默认地址为最近使用地址
+```
+每个故事 ≥3 条场景（正常/边界/异常）;验收标准是给 QA 直接执行的,不许有"体验良好"类不可判定项。
+
+## 竞品拆解
+
+拆解不是截图汇总：选 2–4 个竞品,按「核心流程逐步拆（步数/必填项/打断点）→
+功能矩阵（有无+完成度打分+证据）→ 策略推断（它为什么这么做）→ 借鉴与差异化结论」。
+体验类结论要走查真实流程后再写,注明版本与日期。
+
+## 埋点方案
+
+事件表：事件名（动宾式 `page_view`/`order_submit_click`）/触发时机（精确到交互）/
+属性（名/类型/取值枚举）/平台/负责人。
+指标先行：先写「要回答什么问题→需要什么指标→需要什么事件」,反向推导,禁止"先埋了再说"。
+核心漏斗事件必须成对检查（曝光有点击、发起有结果）。
+
+## 需求评审与优先级
+
+- 优先级用 RICE（Reach×Impact×Confidence÷Effort）或 KANO 定性,给打分过程;
+- 评审前自查：与现有功能冲突?数据兼容（老数据怎么办）?多端一致性?权限矩阵?
+- 砍需求话术要给替代（"本期不做 X,用 Y 过渡,数据达到 Z 再启动"）。
+
+## 产出物组合
+
+PRD（docx-author,含修订记录表）/ 评审 PPT（slides-html:问题-方案-数据-计划）/
+埋点表与功能矩阵（xlsx-analysis 样式）/ 状态迁移表。
+
+## 验收自查
+
+- [ ] 非目标已写;每个功能有边界与异常态
+- [ ] 验收标准全部可判定（能写成测试用例）
+- [ ] 埋点由指标反向推导且漏斗成对
+- [ ] 状态机类需求有迁移表
+- [ ] 竞品结论有版本/日期/证据
+
+## 附件
+
+- `references/prd-framework.md` — PRD 完整骨架 + 状态迁移表/埋点表/功能矩阵模板 + RICE 表

package/skills/product-design/references/prd-framework.md

@@ -0,0 +1,60 @@
+# PRD 骨架与配套模板
+
+## PRD 完整骨架（章节可增不可减）
+
+```
+# 【产品/功能名】PRD
+版本记录：| 版本 | 日期 | 作者 | 变更摘要 |
+
+## 1. 背景与问题
+- 现状数据：【指标现值与趋势，来源】
+- 用户痛点：【谁在什么场景遇到什么问题，佐证（调研/客诉/数据）】
+- 机会判断：【为什么现在做】
+
+## 2. 目标与非目标
+- 目标：【上线后 N 周内，指标 X 从 A → B】（可量化，有时限）
+- 非目标：【明确不做什么及原因】——评审时防蔓延的锚
+
+## 3. 用户与场景
+| 画像 | 触发场景 | 当前解法 | 期望 |
+
+## 4. 方案总览
+- 核心流程：【步骤 1 → 2 → 3，每步谁做什么】
+- 信息架构变化：【新增/调整的页面与入口】
+- 方案取舍：【备选方案与放弃原因】
+
+## 5. 功能详述（逐功能）
+### 5.x 【功能名】
+- 入口与权限：
+- 交互规则：【含输入校验/排序分页/空态/失败态/撤销】
+- 边界条件：【并发/极值/网络异常/数据不存在】
+- 状态迁移表（如适用）：| 当前状态 | 动作 | 条件 | 新状态 | 通知 |
+- 文案清单：【标题/按钮/空态/报错，中英一致性】
+
+## 6. 数据与埋点
+- 要回答的问题 → 指标 → 事件（反向推导表）
+- 事件表：| 事件名 | 触发时机 | 属性(名/类型/枚举) | 平台 |
+
+## 7. 发布计划
+- 灰度策略：【比例/人群/观察指标与阈值】
+- 回滚条件：【指标恶化到什么程度回滚，怎么回滚】
+- 依赖与风险：【上下游/审核/合规】
+```
+
+## RICE 优先级表
+
+| 需求 | Reach(人/期) | Impact(0.25–3) | Confidence(%) | Effort(人周) | 分数=R×I×C/E |
+|---|---|---|---|---|---|
+
+## 功能矩阵（竞品）
+
+| 能力项 | 我方 | 竞品A | 竞品B | 证据(版本/截图说明) | 结论 |
+|---|---|---|---|---|---|
+（完成度：✗无 / ▲基础 / ●完整 / ★标杆）
+
+## 状态迁移表示例（订单）
+
+| 当前状态 | 动作 | 前置条件 | 新状态 | 触达 |
+|---|---|---|---|---|
+| 待支付 | 支付成功回调 | 金额校验通过 | 待发货 | 短信+站内信 |
+| 待支付 | 超时30min | — | 已取消 | 站内信；库存回补 |

package/skills/production-planning/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: production-planning
+description: 生产计划与排程（订单交期评审、MPS 主计划、MRP 净需求运算、产能负荷分析、插单评估、缺料管理）。当用户说"排产/交期能不能接/物料需求/产能够不够/插单/缺料"时使用。制造技能链之计划环。
+version: 1.0.0
+---
+
+# 生产计划与排程（制造技能链 · 计划环；全景见 manufacturing-chain）
+
+计划的本职是**说真话的交期**：接单前双核（产能+物料），接了的单守住，守不住的提前预警。
+
+## 1. 订单评审（交期承诺前的双核）
+
+- **产能核**：订单工时需求 × 瓶颈工序负荷（见 §3）——瓶颈说了算,非瓶颈富余没有意义（TOC）;
+- **物料核**：长周期物料（采购提前期 > 客户交期的料）现有+在途够不够,不够则交期=物料到期+生产周期;
+- 输出评审单：可承诺交期（CTP）+ 依据（瓶颈负荷 %/关键料到期）+ 风险（单一供应商/新工艺）——
+  **销售拍的交期不算数,评审单算数**。
+
+## 2. MPS 与 MRP（`read_skill_file` 读 `scripts/mrp_capacity.py`）
+
+- MPS 主生产计划：按周排产品级计划（需求=订单+预测,冻结期内不许改,变更走插单流程）;
+- **MRP 净需求**：`net_requirements()` —— 逐期:净需求 = 毛需求 − 可用库存 − 在途 + 安全库存,
+  BOM 逐层展开（父项净需求 × 单耗 = 子项毛需求）,输出分期采购/生产建议（考虑提前期回推下单期）;
+- 数据纪律：BOM 准确率与库存准确率（logistics-warehouse 口径）是 MRP 的命——
+  **垃圾进垃圾出,先治数据再信系统**;呆滞与安全库存联动 procurement-supply。
+
+## 3. 产能负荷分析
+
+`capacity_load()`：分工序 负荷% = 需求工时 ÷ 可用工时（可用=班次×时长×设备数×稼动率,
+稼动率用 equipment-tpm 的实际 OEE,别用铭牌值）;
+超载（>100%）三选给决策表：**加班**（成本+疲劳质量风险）/ **外协**（费用+质量管控,
+supply-chain 准入）/ **改期**（客户沟通话术+违约条款核查 legal）——与 project-management
+延期三案同构;瓶颈工序单独盯（缓冲与优先派工）。
+
+## 4. 排产与执行
+
+排产规则显式化（交期优先 EDD/瓶颈利用率优先/换型最小化——规则冲突时的优先级写死）;
+日计划-日报工-差异闭环（计划达成率 = 按时完工工单/总工单,连续 <85% 查根因:
+缺料/设备/品质/计划本身虚）;缺料管理：缺料表（料号/需求日/在途/差口/责任采购/催料动作）
+每日刷新,**缺料预警要早于停线**（提前期倒推的预警点）。
+
+## 5. 插单评估（老板的单也要算完再接）
+
+插单影响三算：挤掉谁（被延误订单清单与客户等级）/ 换型损失（次数×时长）/
+加急成本（空运/加班费）→ 影响面报告给决策者选,**不算就接单=计划失效的开始**;
+插单留白策略：产能预留 5–10% 弹性（旺季调高）。
+
+## 验收自查
+
+- [ ] 交期承诺有评审单（产能+物料双核依据）
+- [ ] MRP 用了实际库存/在途/提前期,BOM 版本正确
+- [ ] 超载给了三案决策表而非硬压
+- [ ] 插单有影响面报告;缺料预警早于需求日
+
+## 附件
+
+- `scripts/mrp_capacity.py` — net_requirements 分期净需求（BOM 展开+提前期回推）/ capacity_load 工序负荷与超载三案;可直接执行自测

package/skills/production-planning/scripts/mrp_capacity.py

@@ -0,0 +1,70 @@
+# 计划计算件（经 run_python 执行）：MRP 分期净需求（单层 BOM 展开+提前期回推下单期）/ 工序产能负荷。
+# 直接执行本文件 = 自测。
+import pandas as pd
+
+
+def net_requirements(gross, on_hand, on_order=None, safety=0.0, lead_weeks=0, item='物料'):
+    """分期净需求：净需求_t = max(毛需求_t + 安全库存 − 期初可用_t − 在途_t, 0)；
+    可用滚动：期末可用 = 期初 + 在途 + 计划到货(=净需求) − 毛需求。
+    gross: {周: 数量}；on_order: {周: 在途到货}。返回计划表（含回推下单周）。"""
+    weeks = sorted(gross)
+    oo = on_order or {}
+    rows, avail = [], float(on_hand)
+    for w in weeks:
+        g = float(gross[w])
+        rec = float(oo.get(w, 0.0))
+        need = max(g + safety - avail - rec, 0.0)
+        end = avail + rec + need - g
+        rows.append({'周': w, '毛需求': g, '期初可用': round(avail, 1), '在途': rec,
+                     '净需求': round(need, 1), '下单周': w - lead_weeks if need > 0 else None,
+                     '期末可用': round(end, 1)})
+        avail = end
+    df = pd.DataFrame(rows)
+    late = df[(df['净需求'] > 0) & (df['下单周'].notna()) & (df['下单周'] < weeks[0])]
+    print(f"[MRP:{item}] 净需求合计 {df['净需求'].sum():,.0f}（提前期 {lead_weeks} 周）")
+    if len(late):
+        print(f"  ⚠ {len(late)} 期下单周已过（应在第 {late['下单周'].min():.0f} 周下单）：交期不可守，走缺料预警/改期评估")
+    print(df.to_markdown(index=False))
+    return df
+
+
+def explode_bom(parent_net, bom):
+    """单层 BOM 展开：父项净需求 × 单耗 →各子件毛需求。bom: DataFrame[子件, 单耗]。"""
+    out = {}
+    for _, r in bom.iterrows():
+        out[r['子件']] = {w: v * r['单耗'] for w, v in parent_net.items()}
+    print(f'[BOM] 展开 {len(out)} 个子件')
+    return out
+
+
+def capacity_load(demand_hours, available_hours):
+    """工序负荷：负荷% = 需求工时/可用工时；>100% 给三案提示。两 dict 以工序为键。"""
+    rows = []
+    for ws, need in demand_hours.items():
+        avail = available_hours.get(ws, 0.0)
+        load = need / avail if avail else float('inf')
+        rows.append({'工序': ws, '需求工时': need, '可用工时': avail, '负荷%': round(load * 100, 1),
+                     '状态': '⚠超载' if load > 1 else ('▲偏紧' if load > 0.85 else '')})
+    df = pd.DataFrame(rows).sort_values('负荷%', ascending=False)
+    print(df.to_markdown(index=False))
+    over = df[df['负荷%'] > 100]
+    if len(over):
+        print(f"  ⚠ 瓶颈：{'、'.join(over['工序'])} —— 三案评估：加班（成本+质量风险）/ 外协（准入+管控）/ 改期（客户沟通+条款核查）")
+    return df
+
+
+if __name__ == '__main__':
+    plan = net_requirements(gross={1: 100, 2: 150, 3: 80, 4: 120}, on_hand=120,
+                            on_order={2: 50}, safety=20, lead_weeks=2, item='成品A')
+    assert plan.loc[0, '净需求'] == 0 and plan.loc[1, '净需求'] > 0
+    # 可用滚动守恒：期末 = 期初+在途+净需求-毛需求
+    r1 = plan.iloc[1]
+    assert abs(r1['期末可用'] - (r1['期初可用'] + r1['在途'] + r1['净需求'] - r1['毛需求'])) < 0.01
+    assert (plan['下单周'].dropna() < plan.loc[plan['下单周'].notna(), '周']).all()  # 回推早于需求周
+    kids = explode_bom({2: 130.0, 4: 100.0}, pd.DataFrame({'子件': ['外壳', '螺丝'], '单耗': [1, 8]}))
+    assert kids['螺丝'][2] == 1040
+    load = capacity_load({'注塑': 500, '装配': 300, '包装': 120},
+                         {'注塑': 400, '装配': 360, '包装': 200})
+    assert load.iloc[0]['工序'] == '注塑' and load.iloc[0]['负荷%'] == 125.0
+    assert load.set_index('工序').loc['装配', '状态'] == ''
+    print('OK mrp_capacity.py')

package/skills/project-management/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: project-management
+description: 项目管理（WBS 分解、关键路径与排期、风险登记册、项目章程/周报/复盘、资源与变更管理）。当用户说"做项目计划/排期/甘特图/项目风险/项目周报/延期了怎么办"时使用。
+version: 1.0.0
+---
+
+# 项目管理（计划可算 + 风险有账 + 状态透明）
+
+## 启动：项目章程一页纸
+
+目标（SMART+验收标准）/ 范围（**含"不做什么"**）/ 里程碑 / 干系人矩阵（权力×利益四象限,
+高权高利者的诉求逐个写）/ 关键假设与约束（预算/人力/截止硬约束标注）——没有章程的项目,
+后期每次争论都要重新对齐一遍。
+
+## 计划：WBS → 排期（`read_skill_file` 读 `scripts/cpm.py`）
+
+- **WBS 分解**：交付物导向（名词,不是动作清单）,100% 规则（子项之和=父项全部）,
+  末级工作包 8–80 小时粒度,每包唯一负责人;
+- **关键路径**：`critical_path(tasks)` —— 输入任务(工期+依赖),输出 ES/EF/LS/LF/总浮动、
+  **关键路径链**与项目总工期,甘特数据（起止偏移）可直接出图（data-analysis）;
+- 排期纪律：估时用三点法（(乐观+4×最可能+悲观)/6）;**缓冲显式化**（项目级缓冲,而不是每人
+  偷偷加 20%）;里程碑倒排检查（关键路径工期 > 可用工期 → 当场谈判范围/资源,不做"纸面可行"计划）;
+- 资源平衡：同一人并行任务叠加图,超载即调序（浮动时间大的让路）。
+
+## 执行：状态透明三件套
+
+- **项目周报**：红黄绿状态（**变黄变红必须写触发原因与恢复计划**,不许悄悄变红）/
+  里程碑燃尽 / 本周完成 vs 计划 / 下周关键 / 需决策事项（给选项）;
+- **风险登记册**（活文档,周会必过）：风险描述（"如果 X 则 Y 影响 Z"格式）/概率×影响打分/
+  应对策略（规避/转移/减轻/接受,写到动作与负责人）/触发信号/状态——**发生了的风险转问题清单**;
+- **变更管理**：变更单（内容/原因/对工期成本范围的量化影响/审批人）——口头变更=范围蔓延之源,
+  一律书面。
+
+## 延期应对（被问"来不及了怎么办"的标准解法）
+
+先算再谈：关键路径上的活动才影响工期 → 压缩三选（赶工=加资源算成本增量/快速跟进=并行算风险/
+减范围=砍非关键需求）→ 给决策表（三案的工期-成本-风险对比）,不空谈"加班解决"。
+
+## 收尾：复盘
+
+计划 vs 实际（工期/成本/范围偏差与根因）/ 估时准确度分析（哪类任务总被低估,校准系数入库）/
+风险登记册回看（预测命中率）/ 可复用资产归档（模板/清单/教训——写进团队 SOP,knowledge-sop 承接）。
+
+## 验收自查
+
+- [ ] WBS 满足 100% 规则,工作包有唯一负责人
+- [ ] 关键路径算过,缓冲显式,倒排冲突已处理
+- [ ] 周报红黄绿如实,风险册每条有应对与触发信号
+- [ ] 延期给的是三案决策表而非口号
+
+## 附件
+
+- `scripts/cpm.py` — 关键路径法（ES/EF/LS/LF/浮动/关键链）+ 甘特数据 + 三点估时;可直接执行自测

package/skills/project-management/scripts/cpm.py

@@ -0,0 +1,84 @@
+# 关键路径法 CPM（经 run_python 执行）：前向/后向遍历求 ES/EF/LS/LF/总浮动，输出关键路径与甘特数据。
+# 任务格式：{'id':'A','name':'需求','dur':5,'deps':['X','Y']}。直接执行本文件 = 自测（经典网络断言）。
+import pandas as pd
+
+
+def three_point(optimistic, likely, pessimistic):
+    """三点估时（PERT）：(乐观+4×最可能+悲观)/6，返回 (期望, 标准差)。"""
+    e = (optimistic + 4 * likely + pessimistic) / 6
+    sd = (pessimistic - optimistic) / 6
+    print(f'[三点] O={optimistic} M={likely} P={pessimistic} → 期望 {e:.1f}，σ={sd:.1f}')
+    return round(e, 1), round(sd, 1)
+
+
+def critical_path(tasks):
+    """返回 (明细表 DataFrame, 关键路径 id 列表, 总工期)。依赖成环/缺失会报错。"""
+    t = {x['id']: dict(x) for x in tasks}
+    for x in t.values():
+        for d in x.get('deps', []):
+            if d not in t:
+                raise ValueError(f"任务 {x['id']} 依赖了不存在的 {d}")
+    # 拓扑排序（Kahn）
+    indeg = {k: len(v.get('deps', [])) for k, v in t.items()}
+    order, queue = [], [k for k, v in indeg.items() if v == 0]
+    succ = {k: [] for k in t}
+    for k, v in t.items():
+        for d in v.get('deps', []):
+            succ[d].append(k)
+    while queue:
+        n = queue.pop(0)
+        order.append(n)
+        for s in succ[n]:
+            indeg[s] -= 1
+            if indeg[s] == 0:
+                queue.append(s)
+    if len(order) != len(t):
+        raise ValueError('依赖成环：' + ','.join(set(t) - set(order)))
+    # 前向：ES/EF
+    for k in order:
+        x = t[k]
+        x['ES'] = max((t[d]['EF'] for d in x.get('deps', [])), default=0)
+        x['EF'] = x['ES'] + x['dur']
+    total = max(x['EF'] for x in t.values())
+    # 后向：LS/LF
+    for k in reversed(order):
+        x = t[k]
+        x['LF'] = min((t[s]['LS'] for s in succ[k]), default=total)
+        x['LS'] = x['LF'] - x['dur']
+        x['float'] = x['LS'] - x['ES']
+    crit = [k for k in order if t[k]['float'] == 0]
+    df = pd.DataFrame([{**{'id': k}, **{c: t[k][c] for c in ('name', 'dur', 'ES', 'EF', 'LS', 'LF', 'float')},
+                        '关键': '★' if t[k]['float'] == 0 else ''} for k in order])
+    print(f'[CPM] 总工期 {total} · 关键路径：{" → ".join(crit)}')
+    print(df.to_markdown(index=False))
+    return df, crit, total
+
+
+def gantt_data(df):
+    """甘特数据源：id/name/start(=ES)/dur —— data-analysis 的 barh 出图即可。"""
+    return df[['id', 'name', 'ES', 'dur']].rename(columns={'ES': 'start'})
+
+
+if __name__ == '__main__':
+    e, sd = three_point(3, 5, 13)
+    assert e == 6.0 and abs(sd - 1.7) < 0.1
+    tasks = [
+        {'id': 'A', 'name': '需求', 'dur': 3, 'deps': []},
+        {'id': 'B', 'name': '设计', 'dur': 4, 'deps': ['A']},
+        {'id': 'C', 'name': '文案', 'dur': 2, 'deps': ['A']},
+        {'id': 'D', 'name': '开发', 'dur': 6, 'deps': ['B']},
+        {'id': 'E', 'name': '素材', 'dur': 3, 'deps': ['C']},
+        {'id': 'F', 'name': '联调上线', 'dur': 2, 'deps': ['D', 'E']},
+    ]
+    df, crit, total = critical_path(tasks)
+    assert total == 15 and crit == ['A', 'B', 'D', 'F']
+    assert int(df.loc[df['id'] == 'C', 'float'].iloc[0]) == 5  # 非关键链浮动
+    g = gantt_data(df)
+    assert list(g.columns) == ['id', 'name', 'start', 'dur']
+    try:
+        critical_path([{'id': 'X', 'name': 'x', 'dur': 1, 'deps': ['Y']},
+                       {'id': 'Y', 'name': 'y', 'dur': 1, 'deps': ['X']}])
+        raise AssertionError('成环应报错')
+    except ValueError as err:
+        assert '成环' in str(err)
+    print('OK cpm.py')

package/skills/project-proposal/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: project-proposal
+description: 项目申报与可研（政府专项/科研课题/高新认定类申报书、可行性研究报告、预算编制、评审自查）。当用户说"项目申报/申报书/可研报告/课题申请/预算编制"时使用。
+version: 1.0.0
+---
+
+# 项目申报（对指南写作 + 预算勾稽 + 评审人视角自查）
+
+## 第一步永远是「解构申报指南」
+
+拿到指南先产出**对标表**（这一步跳过=盲写）：
+| 指南要求 | 原文摘录 | 我方现状 | 差距与补救 | 材料清单 |
+支持方向/申报条件（硬门槛逐条判定:注册年限/资质/知识产权数/研发费占比）/
+考核指标（写进任务书就是军令状,虚高会死在验收）/ 预算科目与开支范围 / 截止时间倒排。
+硬门槛不满足→如实告知别硬报;可补救的给时间表。
+
+## 申报书写作（评审人视角）
+
+评审人平均一份看 15–20 分钟,写作三原则：
+1. **对着评分细则写**：有评分表就按分值分配篇幅,每个得分点有明确承接段落;
+2. **必要性=痛点+数据+政策呼应**：引用指南原文的关键词（原词,别同义替换）;
+3. **创新点可证伪**：「首次/领先」必须给对比对象与证据（查新/专利/检测报告）,给不出就降格为"特色"。
+
+章节骨架（通用,具体以指南模板为准）：立项依据（背景/必要性/国内外现状——现状综述走
+tech-research 的矩阵法）→ 目标与考核指标（定量,与预算联动）→ 研究/建设内容（与目标一一映射,
+用 WBS 分解）→ 技术路线（图+文字,关键节点里程碑）→ 现有基础（团队/平台/前期成果）→
+预算 → 风险与保障 → 进度安排（甘特文字版）。
+
+## 预算编制（`read_skill_file` 读 `scripts/budget_sheet.py`）
+
+- `budget_workbook()` 生成三级科目预算簿（xlsx 带公式）：设备/材料/测试化验加工/燃料动力/
+  差旅/会议/国际合作/劳务费/专家咨询/间接费用——**总表由明细表公式汇总**,改明细自动更新;
+- 内置勾稽校验：明细加总=总表、分年度加总=总额、自筹+申请=总投资、劳务费/间接费比例上限提示
+  （比例限额各类指南不同,以指南为准并在表头注明取值）;
+- 每笔支出给测算依据（单价×数量×次数）,"打包估"过不了财务评审。
+
+## 可研报告（投资类）
+
+十章骨架：总论/需求分析与建设规模/技术方案/建设条件与选址/节能环保/组织与人力/
+实施进度/投资估算与资金筹措/财务与社会效益评价（财务测算走 finance-analysis 口径:
+NPV/IRR/回收期给假设表）/风险分析。数字全书一致（总投资在每处出现都相同——成稿后专项核对）。
+
+## 评审自查清单（提交前过一遍）
+
+- [ ] 硬门槛逐条满足且有证明材料对应
+- [ ] 考核指标可考核（第三方可验证）且与内容/预算三方一致
+- [ ] 预算勾稽全过,每笔有测算依据
+- [ ] 指南关键词在正文有原词呼应
+- [ ] 附件清单齐（营业执照/审计报告/知识产权/推荐信…按指南列）
+- [ ] 全书数字一致性核对完成（总投资/人数/指标值）
+
+## 附件
+
+- `scripts/budget_sheet.py` — 三级科目预算簿生成（带公式与勾稽校验）;可直接执行自测

package/skills/project-proposal/scripts/budget_sheet.py

@@ -0,0 +1,90 @@
+# 预算编制簿（经 run_python 执行）：生成 总表+分年度+明细 三层 xlsx（总表用公式引用明细，改明细自动更新），
+# 并做勾稽校验（明细=总表、分年=总额、申请+自筹=总投资）。直接执行本文件 = 自测（生成并重读校验）。
+import openpyxl
+from openpyxl.styles import Font, PatternFill
+from openpyxl.utils import get_column_letter
+
+CATEGORIES = ['设备费', '材料费', '测试化验加工费', '燃料动力费', '差旅费', '会议费',
+              '国际合作与交流费', '劳务费', '专家咨询费', '间接费用']
+HEAD_FILL = PatternFill('solid', fgColor='1F4E79')
+
+
+def _head(ws, row, cols):
+    for j, t in enumerate(cols, 1):
+        c = ws.cell(row=row, column=j, value=t)
+        c.font = Font(bold=True, color='FFFFFF')
+        c.fill = HEAD_FILL
+
+
+def budget_workbook(path, years=(2026, 2027, 2028), items_per_cat=3, apply_ratio=0.7):
+    """生成预算簿：明细 Sheet（科目×条目×年度）→ 总表/分年度全部公式引用。
+    apply_ratio=申请财政资金占比（其余自筹），示例值，按指南调整。"""
+    wb = openpyxl.Workbook()
+    det = wb.active
+    det.title = '明细'
+    cols = ['科目', '支出内容', '测算依据（单价×数量×次数）'] + [f'{y}年' for y in years] + ['小计']
+    _head(det, 1, cols)
+    r = 2
+    for cat in CATEGORIES:
+        for i in range(1, items_per_cat + 1):
+            det.cell(row=r, column=1, value=cat)
+            det.cell(row=r, column=2, value=f'{cat}-条目{i}（替换为实际内容）')
+            det.cell(row=r, column=3, value='【单价】×【数量】×【次数】')
+            for k in range(len(years)):
+                det.cell(row=r, column=4 + k, value=0)
+            first = get_column_letter(4)
+            last = get_column_letter(3 + len(years))
+            det.cell(row=r, column=4 + len(years), value=f'=SUM({first}{r}:{last}{r})')
+            r += 1
+    last_det = r - 1
+
+    tot = wb.create_sheet('总表')
+    _head(tot, 1, ['科目'] + [f'{y}年' for y in years] + ['合计', '占比%'])
+    for i, cat in enumerate(CATEGORIES, start=2):
+        tot.cell(row=i, column=1, value=cat)
+        for k in range(len(years)):
+            col = get_column_letter(4 + k)
+            tot.cell(row=i, column=2 + k,
+                     value=f'=SUMIF(明细!A2:A{last_det},A{i},明细!{col}2:{col}{last_det})')
+        f, l = get_column_letter(2), get_column_letter(1 + len(years))
+        tot.cell(row=i, column=2 + len(years), value=f'=SUM({f}{i}:{l}{i})')
+    total_row = len(CATEGORIES) + 2
+    tot.cell(row=total_row, column=1, value='合计').font = Font(bold=True)
+    for k in range(len(years) + 1):
+        col = get_column_letter(2 + k)
+        tot.cell(row=total_row, column=2 + k, value=f'=SUM({col}2:{col}{total_row - 1})')
+    sumc = get_column_letter(2 + len(years))
+    for i in range(2, total_row):
+        tot.cell(row=i, column=3 + len(years), value=f'=IF({sumc}{total_row}=0,0,{sumc}{i}/{sumc}{total_row}*100)')
+
+    src = wb.create_sheet('资金来源')
+    _head(src, 1, ['来源', '金额', '说明'])
+    src['A2'] = '申请财政资金'
+    src['B2'] = f'=总表!{sumc}{total_row}*{apply_ratio}'
+    src['C2'] = f'占总投资 {apply_ratio:.0%}（示例比例，按指南调整）'
+    src['A3'] = '单位自筹'
+    src['B3'] = f'=总表!{sumc}{total_row}*{1 - apply_ratio}'
+    src['A4'] = '总投资'
+    src['B4'] = '=B2+B3'
+    wb.save(path)
+    print(f'[预算簿] 已生成 {path}：明细 {last_det - 1} 行 × {len(years)} 年，总表/来源全公式联动')
+    return path
+
+
+def verify(path, years_n=3):
+    """重读勾稽（用值重算公式逻辑）：明细小计=横向和；总表=SUMIF 语义（按科目聚合）。"""
+    wb = openpyxl.load_workbook(path)  # 公式态：校验公式存在性与结构
+    det, tot = wb['明细'], wb['总表']
+    assert det.max_row > len(CATEGORIES), '明细行数异常'
+    assert str(tot.cell(row=2, column=2).value).startswith('=SUMIF'), '总表应公式引用明细'
+    assert str(det.cell(row=2, column=4 + years_n).value).startswith('=SUM'), '明细小计应为公式'
+    src = wb['资金来源']
+    assert str(src['B4'].value) == '=B2+B3', '总投资应=申请+自筹'
+    print('[预算簿] 勾稽结构校验通过（公式联动齐备）')
+    return True
+
+
+if __name__ == '__main__':
+    p = budget_workbook('预算簿_check.xlsx')
+    verify(p)
+    print('OK budget_sheet.py')