@huicai/cli 2026.714.0 → 2026.804.0

package/skills/ip-management/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: ip-management
+description: 知识产权管理（商标/专利/著作权全生命周期、IP 台账、侵权应对与维权、许可与转让交易）。当用户说"注册商标/申请专利/软著/被侵权/山寨/IP 授权/知识产权尽调"时使用。法律技能链之 IP 环。
+version: 1.0.0
+---
+
+# 知识产权管理（法律技能链 · IP 环；全景见 legal-chain）
+
+检索结论以官方数据库与代理机构意见为准;侵权判定与诉讼策略由执业律师/专业代理作出,
+本技能做体系、台账、材料与分析辅助。
+
+## 1. 权利布局（先想清楚保什么、在哪保）
+
+- **三权分工表**：商标（品牌标识,brand-design 命名评估衔接）/ 专利
+  （发明-实用新型-外观:保护强度、审查周期、费用三维对比,**技术方案公开换保护——
+  不愿公开的核心工艺考虑商业秘密路线**,与 risk-compliance 保密体系联动）/
+  著作权与软著（代码/文档/设计,自动产生但登记利于举证）;
+- 布局策略：核心类别+防御类别（商标 45 类中的关联类,别只注册主业类）;
+  专利族（核心专利+外围包绕）;出海市场提前布局（**优先权期限:专利 12 个月/商标 6 个月**,
+  错过=丧失优先权,马德里/PCT 路径提示）;
+- 申请前纪律：**先检索后申请**（近似商标/现有技术,tech-research 检索式方法）,
+  **先申请后发表**（论文/发布会/展会披露破坏专利新颖性——academic-writing 投稿前过这关）。
+
+## 2. IP 台账（资产化管理）
+
+字段：权利类型/名称号码/申请-授权日/**下次年费或续展日**/权利人（**核对是公司不是员工
+或前代理商个人**——权属瑕疵是尽调头号杀手）/覆盖地域/状态/关联产品;
+职务成果链条：劳动合同 IP 条款（legal-contract）+ 立项记录 + 交底书签收——三环齐才叫权属干净;
+到期管理：年费/续展 T-90 提醒（office-automation 例程,**商标续展宽展期后即失权**）;
+对外合作场景的背景 IP/前景 IP 约定核查（研发合同高频雷区）。
+
+## 3. 侵权应对（被侵权方）
+
+固证先行（**公证购买/时间戳/网页存证在发函之前**——先发函=打草惊蛇毁证据,
+litigation-support 证据规范）→ 侵权比对初步分析（商标:近似+商品类似;专利:权利要求
+逐要素对照表,**结论标注"初步分析,以专业鉴定为准"**）→ 策略阶梯（平台投诉（电商侵权
+最快路径:各平台 IP 保护通道材料清单）→ 警告函（律师函升级）→ 行政投诉 → 诉讼
+（litigation-support 三工件,赔偿计算:权利人损失/侵权获利/法定赔偿三口径材料准备））;
+被诉侵权方：不侵权抗辩/现有技术抗辩/合法来源抗辩的材料方向 + 规避设计评估（律师牵头）。
+
+## 4. 许可与交易
+
+许可类型表（独占/排他/普通——**排他≠独占**,许可人自己还能不能用,合同里写死）;
+计价方式（一次性/销售额提成/入门费+提成,提成的审计权条款要留）;
+许可合同要点清单（范围/地域/期限/分许可权/改进成果归属/侵权维权义务分配,
+legal-contract 审查框架套用）;IP 尽调清单（交易/融资场景:权属链/有效性/负担
+（质押/许可在先）/涉诉——capital-ops 尽调资料室的 IP 室）。
+
+## 验收自查
+
+- [ ] 申请前有检索记录;公开前有申请（新颖性保住）
+- [ ] 台账权利人核对无误,到期提醒挂上
+- [ ] 维权固证先于发函;比对结论标注专业复核
+- [ ] 许可合同独占/排他/普通定义无歧义

package/skills/ipo-listing/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: ipo-listing
+description: IPO 与上市准备（上市条件对照、规范性整改、申报材料体系、问询回复方法论、上市路径比较）。当用户说"公司想上市/IPO 准备/股改/申报材料/交易所问询"时使用。证券技能链之上市环。
+version: 1.0.0
+---
+
+# IPO 与上市准备（证券技能链 · 上市环；全景见 securities-chain）
+
+**红线**：上市规则（各板块条件/审核问答）**持续修订**——一切条件与数字以交易所现行规则
+与证监会最新要求为准,由保荐机构/律师/会计师"三中介"牵头;本技能做对照自查、材料组织
+与问询应对方法论,不替代中介意见。
+
+## 1. 上市条件对照与路径选择
+
+- **条件对照表**（拿现行规则逐条填）：财务指标（各板块多套标准择一:净利润/收入/市值组合）×
+  我方三年数据（finance-analysis 口径先自洁）→ 满足/差距/可补救路径;
+- 板块与路径比较维度：行业定位契合度（板块定位问答对照:硬科技/三创四新/专精特新）/
+  审核周期与确定性 / 估值与流动性 / 境内外路径（A 股/港股/境外备案要求提示）——
+  输出决策矩阵而非单一推荐,**选板块是战略决策,董事会定**;
+- 时间表倒排：股改基准日 → 辅导备案与验收 → 申报 → 问询轮次 → 上会 → 发行,
+  各节点前置条件清单（project-management 关键路径法排,审计基准日与财报有效期
+  是硬约束——**财报过期加期审计是最常见的时间表杀手**）。
+
+## 2. 规范性整改（IPO 的真正工程量）
+
+按问题域建整改台账（问题/整改措施/完成标准/中介确认）：
+- **财务规范**：收入确认口径统一（accounting-ops 五步法）/ 第三方回款清理 /
+  关联交易公允性与必要性（减少依赖的路径）/ 内控缺陷整改（risk-compliance 矩阵,
+  内控鉴证要过）/ 现金交易与个人卡（**上市前最痛的清理**,补税测算 tax-compliance）;
+- **法律规范**：历史沿革瑕疵（出资不实/代持清理 corporate-governance）/ 土地房产权属 /
+  业务资质齐备 / 诉讼仲裁梳理（litigation-support 台账）;
+- **治理规范**：三会一层实际运转（corporate-governance,**装样子的董事会问询一问就穿**）/
+  独立性五分开 / 同业竞争解决方案;
+- 员工与社保：社保公积金补缴测算与披露口径。
+
+## 3. 申报材料体系
+
+招股书结构（重大事项提示/风险因素/业务与技术/财务/募投）写作纪律：
+- **风险因素要具体**（"宏观经济波动"不合格;"前五大客户占比 X%,第一大客户 Y 若流失
+  影响收入 Z%"合格——量化+针对性,securities-research 风险规范同源）;
+- 业务章节讲清商业模式闭环（向谁收钱/成本结构/竞争位置,数据与财务章节勾稽一致——
+  **全书数字一致性核对是败诉级纪律**,doc-chain 长文档生产线承接）;
+- 募投项目：必要性与产能消化测算（financial-modeling,**募投画饼上会必问**）;
+- 配套文件台账（三年一期审计报告/法律意见书/各类承诺函,版本与签章管理）。
+
+## 4. 问询回复方法论（审核的主战场）
+
+- 拆题：一问多题拆成子问题清单,逐题分派（公司/保荐/律师/会计师）;
+- 回复结构：**直接回答 → 事实与数据 → 核查程序与依据 → 中介核查意见**——
+  先答问题再摆论据,绕着答=追问;
+- 一致性纪律：本轮回复 vs 招股书 vs 前轮回复三向核对（doc-compare）,
+  **改口必须解释**;敏感问题（毛利率异于同行/客户集中/突击入股）提前备预案;
+- 问询台账：问题/责任方/内部截止/外部截止/状态——回复时限是刚性约束。
+
+## 验收自查
+
+- [ ] 条件对照用现行规则原文,差距有补救路径与时间
+- [ ] 整改台账逐项有完成标准与中介确认位
+- [ ] 招股书风险量化、全书数字一致性核对完成
+- [ ] 问询回复先答后证,三向一致性核对过

package/skills/it-audit/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: it-audit
+description: IT 审计（ITGC 一般控制三域、应用控制与自动化控制测试、数据审计、系统上线与运维审计）。当用户说"IT 审计/权限审计/系统控制/ITGC/日志审计/数据核查"时使用。审计技能链之 IT 环。
+version: 1.0.0
+---
+
+# IT 审计（审计技能链 · IT 环；全景见 audit-chain）
+
+财务数字长在系统里——**系统控制不可靠,账面数字的可靠性无从谈起**（ITGC 失效会放大
+所有实质性程序的样本量）。本技能覆盖内审 IT 专项与年审 ITGC 配合两个场景。
+
+## 1. ITGC 一般控制三域（逐域测试表）
+
+### 权限与访问控制
+- 测试点：用户与岗位匹配（**全量导出账号清单 vs 在职花名册**——离职未禁用是最高频发现,
+  data-report-pro 反连接一跑就出）;特权账号清单与使用留痕（admin/DBA 谁在用,
+  共享账号=红线）;**不相容权限矩阵**（制单与审核/开发与生产运维,SOD 冲突扫描）;
+  权限审批留痕抽样（新增/变更单 vs 系统实际权限一致性）;定期复核证据（季度权限复核
+  签认记录,没有=控制缺失）;
+### 变更管理
+- 测试点：变更单齐套率（开发-测试-审批-上线四留痕,抽样比对系统上线日志 vs 变更单——
+  **有上线无变更单的"幽灵变更"逐条追）**;开发测试生产环境分离;紧急变更事后补审时限;
+  数据直改（绕过应用改库）的审批与日志（高危,单列测试）;
+### 运维与灾备
+- 测试点：备份执行率与**恢复演练证据**（备份成功≠能恢复,一年内无恢复测试记为缺陷）;
+  作业调度失败处理留痕;日志留存期限与防篡改;灾备切换演练报告。
+
+## 2. 应用控制与自动化控制
+
+- 关键自动化控制识别（三单匹配容差/信用额度拦截/审批流金额路由/利息计提公式）→
+  **测试策略:一次一例证**（自动化控制逻辑不变则测一条有效路径+一条拦截路径即可,
+  前提是 ITGC 变更管理有效——这就是 ITGC 与应用控制的杠杆关系）;
+- 接口控制：系统间传输的完整性核对（发送方记录数/金额 vs 接收方,勾稽差异台账）;
+- 配置基线：关键参数快照与变更比对（税率/折旧年限/汇率源——参数错=批量错）。
+
+## 3. 数据审计（用数据说话的内审放大器）
+
+- 全量优于抽样的场景：日志类/交易流水类直接全量跑规则（data-report-pro 承接）;
+- 常用筛查规则库：休眠账户突然活跃/非工作时间高危操作/同一 IP 多账号/审批人与经办人
+  同设备/金额恰低于审批阈值(阈值-1 现象)/序列号断号;
+- 数据取得纪律：**只读权限+取数过程留痕**（SQL/导出日志归档,审计自己也要可审计）;
+  个人信息脱敏后分析（data-governance 清单）。
+
+## 4. 系统生命周期审计
+
+上线前：需求与授权/UAT 测试证据/数据迁移核对（迁移前后总量与关键字段勾稽,
+**迁移差异是陈年烂账之源**）/权限初始化;
+运行中：ITGC 年检;下线：数据归档与保留期、许可证清理。
+
+## 验收自查
+
+- [ ] 三域测试有全量比对类证据（账号 vs 花名册/上线日志 vs 变更单）
+- [ ] SOD 冲突扫描完成,特权账号逐个盘点
+- [ ] 自动化控制测了有效+拦截双路径
+- [ ] 取数留痕,敏感数据已脱敏
+- [ ] 备份有恢复演练证据

package/skills/itsm-ops/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: itsm-ops
+description: IT 服务与运维管理（故障复盘 Postmortem、事件分级与值班、变更管理、SLA 报表、问题管理）。当用户说"写故障复盘/事故报告/值班制度/变更流程/SLA/可用性报表"时使用。
+version: 1.0.0
+---
+
+# IT 服务管理（事件快恢复，复盘无指责，变更有回滚）
+
+## 事件管理（先恢复，后根因）
+
+- 分级标准表（写死判定条件）：P1（核心业务不可用/资损进行中——**恢复优先于定位**,
+  15 分钟内拉起作战群+每 30 分钟对外同步）/ P2（核心降级/部分用户）/ P3（非核心）/ P4（个例）;
+- 值班机制：主备值班+升级链（响应 SLA:P1 5 分钟/P2 15 分钟）;**升级不是丢脸**,
+  超 30 分钟未恢复必须升级;
+- 作战纪律：指挥官唯一（IC 负责决策与对外,处置的人不做沟通）、时间线实时记录
+  （谁在几点做了什么——复盘的原料）、变更嫌疑优先（**"最近改了什么"是恢复第一问**,回滚优先于修复）。
+
+## 故障复盘 Postmortem（无指责文化是前提）
+
+48–72 小时内开,报告结构：
+- 摘要（影响时长/用户面/资损/等级）;
+- **时间线精确到分钟**（发生→发现→响应→定位→恢复,每段耗时单列——发现慢治监控,
+  响应慢治值班,定位慢治可观测性,恢复慢治预案）;
+- 根因（5Why 到系统性原因:"配置错了"不是根因,"配置无校验且无灰度"才是;
+  **人不是根因,允许人犯错的系统才是**）;
+- Action 清单：可验收（"加强监控"✗,"对 X 指标加 P1 告警,阈值 Y,负责人 Z,验收方式 W"✓）+
+  期限+跟踪（未闭环 action 月度通晒,office-automation 例程盯）;
+- 同类风险横扫（这个模式还在哪些系统存在）。
+
+## 变更管理（多数事故是变更引起的）
+
+变更单必填：内容与范围/影响评估/**回滚方案（含回滚时长与数据处理,"不可回滚"要审批人签认）**/
+灰度计划/验证清单/观察期;
+变更窗口：高危变更避开业务高峰与封网期（大促前 N 天封网制度）;
+变更三板斧落地检查：**可灰度、可观测、可回滚**——缺一项打回;
+变更后观察期内的告警自动关联变更单（嫌疑定位提速）。
+
+## SLA 与可用性报表
+
+口径先行：可用性=1−不可用时长/服务时长（**排除窗口写进 SLA**:计划维护算不算）;
+分服务分月呈现:可用性/MTTR（平均恢复时长,用中位数辅助）/MTBF/事件数按级;
+错误预算思路：目标 99.9% = 月度预算 43 分钟,**预算耗尽则冻结非紧急变更**——
+把稳定性从口号变成机制;对外 SLA 与对内 SLO 分开管理。
+
+## 问题管理（治重复事件）
+
+重复事件（同根因 ≥2 次）升级为问题 → 已知错误库（现象/临时绕过/根治方案/状态）→
+根治排期进版本;月度 TOP 问题（按事件数×影响加权）通晒。
+
+## 验收自查
+
+- [ ] 事件分级有可判定条件;P1 流程演练过
+- [ ] 复盘时间线到分钟,根因到系统层,action 可验收
+- [ ] 变更单有可执行回滚方案
+- [ ] SLA 口径含排除窗口定义,错误预算机制在

package/skills/knowledge-sop/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: knowledge-sop
+description: 知识管理与 SOP（标准操作程序编写、知识库信息架构、新人上手包、经验萃取、文档治理）。当用户说"写 SOP/流程文档/知识库整理/新人培训包/把经验沉淀下来"时使用。
+version: 1.0.0
+---
+
+# 知识管理与 SOP（写得出、找得到、跟得上）
+
+## SOP 编写范式（可执行性是唯一标准）
+
+结构：目的与适用范围 → 角色与职责 → 前置条件（权限/工具/输入物清单）→ 步骤
+（**每步=动作+对象+判定标准+异常分支**）→ 产出物与验收 → 常见问题 → 版本记录。
+步骤深度标准：
+- 新人不问人能照做（代词消灭:"把它发给相关人"→"把《X表》发给部门负责人邮箱组 dept-heads@"）;
+- 判定可观察（"检查无误"✗ →"核对 A 与 B 两处金额一致,不一致走 7.2 异常流程"✓）;
+- 异常分支显式（每个可能卡住的点给"如果…则…找谁"）;
+- 截图位标注（[截图:XX页面] 占位,用户补图）。
+**验证法**：写完让最不熟悉的人试跑一遍,卡点即改——SOP 的 bug 只能靠试跑发现。
+
+## 经验萃取（把老师傅的手感变成文档）
+
+访谈提纲：从最近一次实际案例入手（"上次 X 你是怎么处理的"）→ 追关键决策点
+（"什么信号让你判断要 Y"）→ 边界与反例（"什么情况下这么做会翻车"）;
+萃取产出三件套：决策树（信号→判断→动作）/ 案例库（情境-处理-结果-点评）/ 检查清单;
+**隐性知识优先**：显性流程谁都会写,值钱的是"什么时候不按流程来"。
+
+## 知识库信息架构
+
+- 组织原则：按**任务场景**组织优先于按部门组织（用户带着任务来,不是带着组织架构来）;
+- 三层结构：入口页（高频任务直达 TOP20）→ 领域页（场景聚合）→ 文档页;
+- 命名规范：《[域]-[任务]-[类型]》（"财务-差旅报销-SOP"）,禁止"新建文档(3)最终版V2";
+- 元数据：负责人/生效日期/**下次评审日期**（无评审日期的文档=注定腐烂）;
+- 文档治理节奏：季度巡检（点击量为 0 的归档、过评审期的催更、重复主题合并）。
+
+## 新人上手包（知识库的验金石）
+
+第 1 天（环境/权限/人头地图）/ 第 1 周（核心流程 SOP 清单+试跑作业）/ 第 1 月
+（独立职责与验收标准+导师检查点）;每项挂知识库链接——**链接挂不出来的项就是知识库的缺口清单**。
+
+## 与平台机制的衔接
+
+高频 SOP 可直接沉淀为**本地技能**（.huicai/skills,团队共享经平台广场 push）——
+"文档级 SOP"升级为"智能体可执行的技能",这是本平台独有的知识落地路径;
+文档批量整理/去重用 doc-compare 与 data-report-pro。
+
+## 验收自查
+
+- [ ] SOP 每步有判定标准与异常分支;经过试跑
+- [ ] 萃取覆盖了决策点与反例,不止流程
+- [ ] 文档有负责人与评审日期
+- [ ] 上手包每项可点击直达

package/skills/legal-chain/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: legal-chain
+description: 法务技能链总控（合同全生命周期、合规体系、争议解决三条主线→技能路由与端到端工作流、法务自动化例程）。当法务诉求跨环节（"从审到签到打官司""新规落地全流程"）或不确定用哪个技能时先载入。
+version: 1.0.0
+---
+
+# 法务技能链总控
+
+全链红线继承：辅助文书与流程管理,法律意见由执业律师出;引用法条按可靠层级。
+
+## 场景路由表
+
+| 法务模块 | 高频场景 | 技能 |
+|---|---|---|
+| 合同管理 | 起草审查/风险分级/修订建议/范本偏离 | **legal-contract** + doc-compare（红线比对） |
+| 合规管理 | 新规解读/义务落地/内控嵌入/反舞弊 | **policy-analysis** + risk-compliance |
+| 争议解决 | 证据整理/时间线/文书结构/执行台账 | **litigation-support**（和解测算转 negotiation-prep） |
+| 知识产权 | 布局申请/台账年费/侵权维权/许可交易 | **ip-management**（检索思路参 tech-research） |
+| 公司治理 | 三会决议/章程设计/三重一大/代持风险 | **corporate-governance**（变更流程参 capital-ops） |
+| 数据合规 | 处理清单/分级分类/委托协议 | data-governance + risk-compliance |
+
+## 端到端工作流
+
+### ① 合同全生命周期链
+需求（业务背景+我方立场确认）→ 范本选择（knowledge-sop 范本库,无范本先建）→
+**legal-contract** 审查（红黄蓝+可替换修订文本+数字专项核对）→ 对方回稿 **doc-compare**
+比对（改了哪+影响定性,只看红线版是事故之源——**全文重比**）→ 谈判支持
+（negotiation-prep:条款让步矩阵）→ 用印（用印台账:合同编号/审批链/骑缝,risk-compliance
+职务分离）→ **履约跟踪**（关键义务与期限进台账:付款/交付/续约窗口,office-automation 例程盯）→
+到期处置（续签评估/终止通知时限）→ 归档与复盘（争议高发条款回写范本库）。
+
+### ② 新规合规落地链
+监测（policy-analysis:新规五要素拆解）→ 义务清单与差距（现状对照,过渡期倒排）→
+制度修订（risk-compliance 三层文件+doc-compare 出修订对照）→ 流程嵌入
+（内控矩阵加控制点）→ 培训（education-training:考核可判定）→ 自查与留痕
+（检查表+整改闭环）→ 年度合规报告（docx-author）。
+
+### ③ 争议解决链
+争议预警（履约台账逾期/对账差异 data-report-pro）→ 前置固证（**litigation-support**:
+时间线+证据目录,微信函件邮寄凭证即时归档——**证据在争议前就要开始攒**）→ 催告函
+（email-writing 阶梯+律师函衔接）→ 和解谈判（negotiation-prep:底线=诉讼期望值−成本）→
+仲裁/诉讼材料（litigation-support 三工件+请求计算表）→ 执行台账 → 复盘回写
+（该争议暴露的合同漏洞 → legal-contract 清单与范本更新——**打过的官司要变成范本的免疫力**）。
+
+## 自动化例程配方
+
+- 履约台账日检：关键期限 T-30/T-7/T-1 三级提醒（续约窗口/付款节点/质保到期）;
+- 新规监测：约定目录落入政策文件即触发五要素拆解初稿;
+- 用印台账月度核对：用印记录 vs 合同台账勾稽;
+- 诉讼时效台账：季度核查在途债权时效中断动作。
+
+## 使用纪律
+
+每份产出末尾的免责声明不许省;红/黄级风险条款的接受必须有业务方书面确认（邮件固化,
+email-writing）;范本库版本化管理（knowledge-sop 治理节奏）。

package/skills/legal-contract/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: legal-contract
+description: 法律合同辅助（合同审查、条款风险分级、范本偏离比对、修订建议、尽调清单）。当用户说"审合同/看看这份协议/合同风险/改条款/法律尽调"时使用。提供文书辅助，不构成法律意见。
+version: 1.0.0
+---
+
+# 合同审查辅助（条款清单法 + 风险分级 + 可执行修订建议）
+
+## 定位红线（每份产出末尾固定声明）
+
+「本内容为合同文本的辅助审阅意见,不构成法律意见;重大交易请咨询执业律师;
+法规适用请以最新有效版本为准。」不引用无法核实的具体法条条号——写"依据《民法典》合同编相关规定"
+这类可靠层级,除非用户提供了条文原文。
+
+## 审查流程（强制）
+
+1. **通读定性**：合同类型/我方立场（甲方乙方/买卖双方）/交易实质;超 30 页走 long-doc-analysis。
+   **立场先行**：同一条款对买方是风险对卖方是保护,不问立场不出结论。
+2. **要素完整性**：主体（资质/授权）、标的、价款与支付、履行（期限/地点/方式）、
+   验收、违约责任、解除、争议解决、通知送达、生效条款——缺项清单先列出。
+3. **逐类条款过清单**：`read_skill_file` 读 `references/contract-checklists.md`——
+   按合同类型（买卖/服务/劳动/租赁/保密/借款/股权）逐条对照,每条给：
+   现状摘录 → 风险定性（红/黄/蓝,标准见清单）→ 修订建议（**给可直接替换的条款文本**,不是"建议完善"）。
+4. **数字专项核对**：金额大小写一致、比例加总=100%、日期先后逻辑、期限起算点、
+   违约金与定金并存冲突、管辖与仲裁并存冲突——逐项 print 核对结果。
+5. **交付**：`审查意见.docx`（执行摘要:红点数+是否可签的条件 → 风险清单表 → 逐条修订建议 →
+   声明）;需要红线版走 doc-compare 出对照表。
+
+## 风险分级标准
+
+- 🔴 红（不改不签）：无限连带责任、单方任意解除权在对方、知识产权归属倒置、
+  违约金畸高/畸低、放弃诉权、空白关键要素;
+- 🟡 黄（应改）：期限/验收标准模糊、通知方式缺失、不可抗力范围过宽、管辖不利;
+- 🔵 蓝（可优化）：措辞歧义、条款冗余、编号引用错误。
+
+## 常见高发问题（审查时主动扫）
+
+阴阳条款（正文与附件不一致）、"最终解释权"、自动续约无退出、
+数据/个人信息处理无合规安排、背靠背付款条款（我方为供应商时高风险）、
+知识产权"职务成果"边界、竞业限制无补偿。
+
+## 尽调场景（股权/资产交易）
+
+尽调清单按模块出：主体资质/股权结构/重大合同/资产权属/负债担保/劳动人事/税务/诉讼仲裁/
+行政处罚/知识产权/数据合规——每模块给「需对方提供的文件清单」+「核查要点」,
+产出尽调报告框架（红旗事项前置）。
+
+## 验收自查
+
+- [ ] 立场明确,每条意见都从我方立场出发
+- [ ] 红/黄级条款均有可直接替换的修订文本
+- [ ] 数字专项核对全部执行并留了记录
+- [ ] 不确定的法规表述已降级为"相关规定"或建议咨询律师
+- [ ] 末尾声明在
+
+## 附件
+
+- `references/contract-checklists.md` — 七类合同的逐条审查清单 + 风险定性标准 + 修订句式库

package/skills/legal-contract/references/contract-checklists.md

@@ -0,0 +1,59 @@
+# 合同审查清单（按类型逐条过；风险级：🔴不改不签 🟡应改 🔵可优化）
+
+## 通用清单（所有合同先过一遍）
+
+| 检查项 | 要点 | 缺陷时典型风险 |
+|---|---|---|
+| 主体 | 名称与营业执照一致;签约人有授权（法定代表人/授权书） | 合同效力瑕疵 🔴 |
+| 价款 | 含税否+税率;大小写一致;币种;调价机制 | 结算争议 🟡 |
+| 支付 | 节点与条件明确可判定;逾期付款利息 | 回款无抓手 🟡 |
+| 履行 | 期限起算点明确（"合同生效之日"优于"签订后"） | 拖延无责 🟡 |
+| 验收 | 标准可量化;逾期不验视为合格条款（我方为供方时争取） | 验收僵局 🟡 |
+| 违约责任 | 与违约情形一一对应;违约金上限;继续履行/解除的选择权 | 追责落空 🔴 |
+| 解除 | 双方解除情形对等;单方任意解除权在对方 🔴 | 被动出局 |
+| 争议解决 | 诉讼或仲裁二选一（并存无效风险）;管辖地评估 | 维权成本 🟡 |
+| 通知送达 | 地址+电子送达效力+变更通知义务 | 程序被动 🟡 |
+| 生效 | 签字盖章+日期;附条件生效的条件可控性 | 效力悬置 🟡 |
+
+## 买卖合同
+
+风险转移时点（交付主义,特殊约定要盯）;所有权保留条款;质量异议期（过短 🔴 我方为买方时）;
+包装运输费用承担;第三人知识产权侵权担保（供方兜底）;数量短溢装容忍度。
+
+## 服务/委托合同
+
+服务范围 SOW 清单化（"包括但不限于"在对方义务里是好词、在我方义务里是 🔴）;
+成果验收标准与次数;人员更换权;转委托禁止;成果知识产权归属与背景知识产权区分;
+按阶段付款与阶段成果解耦风险。
+
+## 劳动合同（+竞业/保密）
+
+试用期与期限法定匹配;工资构成拆分（基本+绩效的比例）;竞业限制:范围/期限（≤2年）/
+**月补偿标准**（无补偿条款风险在用人方）;服务期与违约金仅限专项培训;调岗调薪单方权 🔴（员工立场）。
+
+## 租赁合同
+
+租金递增机制;免租期与起租日;押金退还条件与时限;装修处置（届满归属/恢复原状）;
+转租权;优先承租权;提前解约的阶梯违约金;房产权属核验（抵押/查封）。
+
+## 保密协议（NDA）
+
+保密信息定义（过宽=双向负担;列举+兜底）;例外情形（已公开/独立开发/第三方合法获得/依法披露）;
+期限（永久保密对商业秘密可,对一般信息 🟡）;违约金与实际损失关系;单向还是双向。
+
+## 借款/担保
+
+利率合规上限;复利与罚息叠加 🟡;提前还款权与费用;担保方式（连带 vs 一般,连带对保证人 🔴）;
+保证期间明确;担保物权登记安排;资金用途与监管。
+
+## 股权（转让/增资）
+
+先决条件清单;交割安排与过渡期损益归属;陈述与保证范围+存续期;赔偿上限与免赔额（篮子）;
+对赌/回购条款的触发与计算公式复核;税费承担;竞业与创始人锁定;优先权体系（优先购买/共售/清算）。
+
+## 修订句式库（给"可直接替换"的建议时套用）
+
+- 期限模糊 → 「乙方应于合同生效之日起 __ 个工作日内完成…;逾期每日按合同总价 0.__% 支付违约金,累计不超过合同总价 __%。」
+- 单方解除失衡 → 「任一方严重违约致合同目的不能实现的,守约方有权书面通知解除;通知到达之日解除生效。」
+- 验收僵局 → 「甲方应于收到验收申请后 __ 个工作日内完成验收;逾期未提出书面异议的,视为验收通过。」
+- 送达 → 「双方确认本合同首部载明的地址及电子邮箱为有效送达地址;变更未书面通知的,按原地址送达即视为有效。」

package/skills/litigation-support/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: litigation-support
+description: 诉讼与仲裁支持（证据目录、事实时间线、诉讼请求计算表、起诉/答辩/仲裁文书结构、庭前准备）。当用户说"整理证据/打官司材料/起诉状/答辩状/仲裁/庭审准备"时使用。辅助文书整理，不构成法律意见。
+version: 1.0.0
+---
+
+# 诉讼仲裁支持（事实靠时间线，主张靠证据链，金额靠计算表）
+
+## 定位红线
+
+辅助**事实与材料整理**;诉讼策略、法律适用判断建议由执业律师作出（产出固定标注）;
+不编造证据与事实;引用法条同 legal-contract 口径（拿不准写"相关规定"）。
+
+## 三大核心工件（任何案件先做这三张表）
+
+1. **事实时间线**：日期/事件/我方行为/对方行为/**证据索引号**/争议标注（无争议✓/有争议标理由）——
+   长案卷（微信记录几百页）走 long-doc-analysis 分段提取;时间线是**给法官讲故事的骨架**,
+   有证据支撑的事实才进时间线,推测进"待查清单";
+2. **证据目录**（法院格式习惯）：编号/证据名称/来源/证明目的（**写到具体争议焦点**,
+   "证明合同关系"太粗,"证明 2025-3-1 双方就单价变更达成合意"才有用）/原件持有情况/页码;
+   证据链自检：每个待证事实 ≥1 组证据,孤证标注补强方向（微信记录+转账记录+发票互相咬合）;
+3. **诉讼请求计算表**：本金（合同与履行凭证对应）/利息或违约金
+   （**分段计算**:起算日-截止日×利率,利率依据参数化注明——约定利率/LPR 及倍数以现行规定
+   与合同为准,给公式与过程,xlsx 落盘可复算）/实现债权费用;请求金额的每一分钱可溯源。
+
+## 文书结构（辅助起草，律师定稿）
+
+- **起诉状**：当事人信息（工商登记核对）→ 诉讼请求（编号列明,金额与计算表一致）→
+  事实与理由（按时间线叙事,每段事实括注证据编号,克制修辞——**法官反感情绪化陈述**）→
+  证据清单;
+- **答辩状**：针对每项请求逐一回应（认可/部分认可/否认+理由）,程序性抗辩前置
+  （管辖/时效/主体资格）,不替对方补强逻辑;
+- **仲裁申请书**：仲裁条款引用（机构名称准确性核对——约定不明可能导致条款无效风险提示）,
+  其余同起诉状骨架;
+- 上诉状：一审判决的具体错误点（事实认定/法律适用/程序）逐条对应,不重复一审全部主张。
+
+## 庭前准备
+
+质证意见预案（对方可能证据:真实性/合法性/关联性三性逐一预判+我方意见）;
+法庭调查问题清单（我方需查明的事实→设问）;争议焦点归纳（预判合议庭归纳,按焦点组织举证顺序）;
+和解底线测算（诉讼成本+执行风险折价 → 可接受和解区间,转 negotiation-prep 谈判准备）。
+
+## 执行阶段
+
+财产线索台账（银行/不动产/股权/应收/车辆,线索来源合法性注意）;执行时间线与措施申请记录;
+终本后恢复执行的触发情形跟踪（office-automation 例程年度提醒）。
+
+## 验收自查
+
+- [ ] 时间线每条事实有证据索引;推测在待查清单
+- [ ] 证据目录证明目的到焦点级;孤证有补强方向
+- [ ] 请求金额分段计算可复算,利率依据注明
+- [ ] 文书克制陈述;律师复核标注在

package/skills/logistics-warehouse/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: logistics-warehouse
+description: 物流与仓储（运费对账与计费稽核、时效分析、仓储 KPI、异常件与理赔台账、承运商评估）。当用户说"运费对账/物流账单不对/时效分析/仓库KPI/丢件破损/承运商考核"时使用。
+version: 1.0.0
+---
+
+# 物流仓储（运费重算稽核 + 时效分位数 + 仓储口径纪律）
+
+## 运费对账（`read_skill_file` 读 `scripts/freight_check.py`，对账=按合同重算）
+
+- **计费规则参数化**：首重/续重单价、重量分段价表、**体积重系数**（计费重=max(实重,长×宽×高/系数),
+  系数 6000/8000 按合同）、燃油附加费 %、偏远/超长超重附加、保价费率——规则来自**合同报价单**,
+  逐条录成参数;
+- `freight_recalc()`：明细逐单重算应付运费 vs 账单金额 → 差异清单（差异金额排序+差异类型归因:
+  计费重不符/单价档不符/附加费错收/重复计费）;**先对总量再对明细**（data-report-pro 五步法同源）;
+- 索赔与红线：差异清单按承运商出《对账函》附明细,只主张有合同依据的差异;
+  体积重抽验（仓内复核尺寸照片留证）。
+
+## 时效分析（承诺是及格线，分位数是真相）
+
+- 口径：揽收-签收全程时效,分线路/承运商/仓;**P50/P90/超时率**三件套（均值会被极端件拉平）;
+- 对标承诺时效：超时率 = 超承诺件数/总件数,分段归因（揽收超时/干线/末端派送——
+  哪段超时决定找谁谈）;
+- 异常波动看日历维度（大促/天气/口岸）标注事件再归因。
+
+## 仓储 KPI（口径先行）
+
+库存准确率（**账实一致行数/盘点行数**,金额口径另列——两口径差异大=高值品管理问题）/
+拣选人效（件/人·时,分波次;与错拣率一起看,快而错=更贵）/ 库容利用率（用体积或托位,
+满仓率 >85% 拣选效率开始劣化,预警）/ 库龄结构（30/60/90 天分层,呆滞转 procurement-supply 处置）/
+发货及时率（截单时间口径写死）。月报=指标卡+趋势+TOP 问题（帕累托）+ 改善动作。
+
+## 异常件与理赔
+
+台账字段：运单号/类型（丢/破/湿/错分）/发现环节/责任判定（照片与交接记录为证）/货值/
+理赔金额/时效（**理赔时效超期自动升级**,office-automation 例程盯）;
+月度分析：异常率 ‰ 分承运商与品类,破损集中品类 → 包装整改闭环。
+
+## 承运商评估
+
+评分卡（procurement-supply 机制复用）:时效达成 35/异常率 25/对账准确 15/理赔响应 15/价格 10;
+季度评分 → 量的分配调整（好承运商加量是最有效的谈判筹码）。
+
+## 验收自查
+
+- [ ] 计费参数逐条来自合同;差异清单有归因
+- [ ] 时效用分位数+超时率,分段归因
+- [ ] 仓储指标口径写死（截单/盘点口径）
+- [ ] 理赔台账时效可追踪
+
+## 附件
+
+- `scripts/freight_check.py` — 参数化计费重算（体积重/分段价/附加费）+ 差异清单归因;可直接执行自测

package/skills/logistics-warehouse/scripts/freight_check.py

@@ -0,0 +1,71 @@
+# 运费稽核件（经 run_python 执行）：按合同规则逐单重算运费，与账单比对出差异清单。
+# 规则参数化：体积重系数 / 首重续重 / 重量分段价 / 燃油附加 % / 偏远附加。直接执行本文件 = 自测。
+import numpy as np
+import pandas as pd
+
+
+def chargeable_weight(actual_kg, l_cm, w_cm, h_cm, divisor=6000):
+    """计费重 = max(实重, 体积重)；体积重 = 长×宽×高(cm)/系数（系数按合同 6000/8000）。"""
+    vol = l_cm * w_cm * h_cm / divisor
+    return max(actual_kg, vol), vol
+
+
+def freight_by_rule(kg, rule):
+    """按规则算基础运费。rule 二选一：
+    {'first_kg':1,'first_price':10,'add_price':3}（首重续重，续重按 0.5kg 进位可选 'step':0.5}）
+    {'brackets':[(3,8),(10,6),(inf,5)]}（分段单价：≤3kg 8元/kg…）"""
+    if 'brackets' in rule:
+        for cap, unit in rule['brackets']:
+            if kg <= cap:
+                return kg * unit
+        raise ValueError('分段表未覆盖该重量')
+    step = rule.get('step', 1.0)
+    extra = max(kg - rule['first_kg'], 0)
+    units = np.ceil(round(extra / step, 6))
+    return rule['first_price'] + units * rule['add_price'] * step
+
+
+def freight_recalc(df, rule, divisor=6000, fuel_pct=0.0, remote_fee=0.0, remote_col=None, tol=0.01):
+    """逐单重算：需列 [运单号, 实重kg, 长, 宽, 高, 账单金额]。返回 (明细, 差异清单)。"""
+    d = df.copy()
+    cw = d.apply(lambda r: chargeable_weight(r['实重kg'], r['长'], r['宽'], r['高'], divisor), axis=1)
+    d['体积重'] = [round(x[1], 2) for x in cw]
+    d['计费重'] = [round(x[0], 2) for x in cw]
+    d['基础运费'] = d['计费重'].map(lambda k: freight_by_rule(k, rule))
+    d['燃油附加'] = (d['基础运费'] * fuel_pct).round(2)
+    d['偏远附加'] = (d[remote_col].map({True: remote_fee, False: 0.0}) if remote_col else 0.0)
+    d['应付'] = (d['基础运费'] + d['燃油附加'] + d['偏远附加']).round(2)
+    d['差异'] = (d['账单金额'] - d['应付']).round(2)
+
+    def why(r):
+        if abs(r['差异']) <= tol:
+            return ''
+        if r['体积重'] > r['实重kg'] and abs(r['账单金额'] - freight_by_rule(r['实重kg'], rule) * (1 + fuel_pct)) <= tol:
+            return '疑未按体积重计费(少收)' if r['差异'] < 0 else '计费重不符'
+        return '多收' if r['差异'] > 0 else '少收'
+    d['归因'] = d.apply(why, axis=1)
+    diff = d[d['差异'].abs() > tol].sort_values('差异', key=abs, ascending=False)
+    print(f"[运费稽核] {len(d)} 单 | 账单合计 {d['账单金额'].sum():,.2f} vs 应付 {d['应付'].sum():,.2f} "
+          f"| 差异单 {len(diff)} 张、净差 {d['差异'].sum():+,.2f}")
+    if len(diff):
+        print(diff[['运单号', '计费重', '应付', '账单金额', '差异', '归因']].to_markdown(index=False))
+    return d, diff
+
+
+if __name__ == '__main__':
+    w, vol = chargeable_weight(2.0, 40, 30, 30, 6000)
+    assert vol == 6.0 and w == 6.0  # 轻抛货按体积重
+    rule = {'first_kg': 1, 'first_price': 10, 'add_price': 3, 'step': 1.0}
+    assert freight_by_rule(1, rule) == 10 and freight_by_rule(2.2, rule) == 10 + 2 * 3
+    bill = pd.DataFrame({
+        '运单号': ['D1', 'D2', 'D3'],
+        '实重kg': [1.0, 2.0, 5.0],
+        '长': [20, 40, 30], '宽': [15, 30, 20], '高': [10, 30, 20],
+        '账单金额': [11.0, 30.25, 22.0],  # D1 正确(10×1.1)；D2 应付 6kg→25×1.1=27.5 被多收；D3 应付 25.3 被少收
+    })
+    detail, diff = freight_recalc(bill, rule, fuel_pct=0.10)
+    assert len(diff) == 2
+    assert diff.iloc[0]['运单号'] == 'D2' and diff.iloc[0]['归因'] == '多收'  # |+2.75| 最大排首位
+    assert diff.set_index('运单号').loc['D3', '归因'] == '少收'
+    assert (detail.loc[detail['运单号'] == 'D1', '差异'].abs() <= 0.01).all()
+    print('OK freight_check.py')