agentleFS
soloveliness-a11ysoloveliness-a11y/legal-risk-workflow/skills/risk-workflow/SKILL.md

risk-workflow

Skill2 starsChanged 2 months agoMITView on GitHub

私募基金管理人法律风控标准化工作流(DAG 调度器)。6 阶段主干固定为默认路径,分支点由模型依据项目状态建议调整;尽调启动、报告定稿、交易与投后基线三个人工审批检查点必须由人放行,尽调收口默认随报告初稿一并审批;按项目状态组合调用 10 个能力技能。 触发词:风控流程、尽调、dd-prep、dd-check、dd-interview、risk-report、report-review、txn-docs、post-invest-check、qcc-scan、industry-research、legal-research、项目状态、下一步

The file

Files
SKILL.md

风控律师工作流(Risk Workflow — DAG 调度器)

定位

阶段主干固定为默认路径,模型可在分支点依据项目状态建议调整;重大节点(尽调启动、报告定稿、交易与投后基线)必须人工审批,机械性确认默认合并进检查点呈报。

本 Skill 是风控工作流的主调度器,职责:

  1. 读项目日志,判断当前阶段与步骤
  2. 告知当前步骤的默认动作与产出
  3. 在分支点给出可选路径与建议,交用户/审批人决策
  4. 不替代任何能力 Skill 的内部逻辑

全局契约:全部技能(含本调度器)统一遵守 CONTRACT.md——工作区与数据总线(§1)、Dossier canonical working view + 证据链登记(§2)、执行状态文件(§3)、检查点(§4)、风险编号(§5)、验收契约 AC1-AC5(§6)、外部依赖适配器(§7)、文档产出(§8)、项目日志与启动自检(§9)、版本与兼容(§10)。本文件只描述调度逻辑,凡与契约重复的内容一律引用、不复述。


6 阶段总览

Phase名称主技能(默认)关键输入关键产出主 CP
1项目准备dd-prep(调用 qcc-scan / industry-research)项目名、BP、公开数据尽调清单、访谈提纲、风险假设、初筛卡CP1 尽调启动确认
2尽调执行dd-check T2 → dd-interview 模块 A/B → 补充核查清单、企业材料、访谈转写verification_table、纪要、interview_result、pending 清单CP2 尽调收口(呈报,结论性缺口时阻断)
3报告撰写risk-reportDossier、核查表、纪要风控报告 + risk_matrix(含条款映射提示)—(初稿交复核)
4复核report-review报告初稿复核意见、修订闭环记录CP3 报告定稿确认
5交易文件txn-docs定稿报告、条款映射条款落实表、保全校验表、覆盖度报告CP4 交易与投后基线确认
6投后跟踪post-invest-check(qcc-scan 定期复查)法律台账、交割义务台账更新、预警记录—(持续性,无终止)

业务链:投资经理侧顺序为 小预审 Go/No-Go → 深度尽调 → 访谈与验证 → 研究更新 → 交易架构 → 大预审 → 投委会 → 投后跟踪;风控侧 Phase 1-6 与之对应。允许回环:复核不通过可回 Phase 2 补充调查或 Phase 3 修订报告;回环时已有产物不覆盖,版本共存标注。

Phase 3 内部默认顺序:预检+数据源复查(缓存 >7 天触发 diff)→ 前言与前提 → 基本情况 → 重点问题(核心章节,按风险主题逐项 IRAC)→ 投资方案评估 → 风险总结(编号稳定化)→ 跨章一致性检查。报告按风险主题聚焦生成,减少单次上下文负载。

各 Phase 进入条件(一句话):

  • Phase 1:新项目或用户明确启动尽调
  • Phase 2:CP1 通过(清单+提纲获批)
  • Phase 3:Phase 2 产物齐备(核查表+纪要)且 CP2 收口呈报完成——默认直接进入报告撰写,结论性缺口时经审批人决定(CONTRACT §4.1)
  • Phase 4:报告初稿完成且一致性检查无阻断项
  • Phase 5:CP3 通过(报告封版);投委会通过+签约打款后转 Phase 6
  • Phase 6:交割后持续运行,可反复调用

能力技能清单(10 个,可跨阶段调用)

能力 Skill 不是流水线节点,而是独立能力,同一 Skill 可在多个 Phase 被调用。

能力 Skill主战场其他可调用 Phase独立触发
dd-prepPhase 1(4 步各自独立可调)—✅
qcc-scanPhase 12 / 3 / 6✅
industry-researchPhase 12 / 3✅
dd-checkPhase 2(T2 正向匹配)1(T1 预扫描)/ 3(T3 增量)/ 4(补充)✅
dd-interviewPhase 2(模块 A 纪要 / 模块 B 归纳)4(补充访谈)✅
risk-reportPhase 34(修订)✅
legal-researchPhase 3(法源核验,risk-report 步骤 5 调用)4(定稿复核补验)/ 5(条款依据确认)✅
report-reviewPhase 4(双层复核)3(草稿期轻量自检)✅
txn-docsPhase 5—✅
post-invest-checkPhase 6—✅

调用原则:Phase 阶段固定,能力按需调用,报告始终迭代。 每个步骤的默认动作固定,模型不自行决定跳步;分支点由模型建议、用户决策;报告版本迭代遵循 CONTRACT §8。


调度逻辑

会话启动

执行 CONTRACT.md §9 的一页启动自检:读日志末尾判步骤 → 核对 Dossier §0 状态 → 按衔接表查上游文件 → 处理 blocked/待办 → 确认主 CP 审批状态。通过后向用户报告:当前 Phase/Step、默认动作、分支点选项(如有)、异常项(如有)。无异常且无分支点时直接执行默认动作,不等待确认;存在异常或分支点时停下等待用户决定;涉及主 CP 的按 §4 等待审批。

日志即状态源

  • project_log.md 只追加不删改;分支点决策记一行(路径+依据),主 CP 确认记录格式见 CONTRACT §4。
  • 日志与 Dossier 分工:日志记"做了什么、到哪一步";Dossier 记"事实是什么、来源与确定性"。
  • 日志与产物矛盾:以最新产物时间戳为准,追加修正说明。

场景判断(会话启动时识别)

场景识别信号语义
首轮尽调(标准模式)新项目,日志不存在;用户要求开展尽调,或决策问题需要新核查/访谈走完整 6 阶段默认路径;按轮次差异化深度(天使 15-20 项精简清单 / 成长期 30-40 项 / Pre-IPO 50+ 项含上市专项)
材料报告模式用户要求基于现有材料出报告或整理材料,未要求开展尽调不进尽调流程,不设 CP1/CP2:材料归档与预处理 → 证据登记 + Dossier 初始化 → risk-report 直接出带限制说明的 V0.1d 初稿(缺口全部入关键待核实事项)→ report-review;定稿/外发走 CP3。产出不得声称已完成尽调;结论性缺口突出标明并暂缓该项判断(详见 CONTRACT §4.1)
增量模式已有纪要/核查表,出现新材料、新转写或 pending 清单追加补充、不重做已有产出;核查走 dd-check T3,访谈追加专节;按 CONTRACT §8.1 交付变更摘要(受影响风险编号+等级变化+新增/关闭项)
加急模式用户明确要求压缩周期清单/行业研究降为快速扫描,复核不降级;验收契约 AC1-AC5 不豁免
补充尽调report-review 结论为"需补充调查"回 Phase 2 补充核查回路,只补目标项,完成后回到报告修订

场景结论记入日志一行(场景+依据+执行模式),不设固定字段模板。

范围边界:用户明确限定基于现有材料出稿时,优先遵守该范围——过程中发现的补查需求列入关键待核实事项,不自动扩展为完整尽调;是否升级为尽调由用户决定。


检查点

4 个主检查点:CP1 尽调启动确认 / CP2 尽调收口 / CP3 报告定稿确认 / CP4 交易与投后基线确认。其中 CP1/CP3/CP4 为人工审批、阻断性(批准外发与工作范围、接受未决风险并批准定稿、确认交易条件);CP2 为收口呈报,默认随报告初稿一并交 CP3 审批、不停顿,仅当存在足以改变核心结论的缺口时阻断升级。位置、呈报内容与规则见 CONTRACT.md §4。

技能内部的重要中间判断(风险假设成型、单场纪要完成、报告分析框架等)为子确认:默认并入下一个主 CP 的呈报项一并审批,不单独停顿;仅会改变工作范围或结论方向的判断才单独提出(CONTRACT §4.2)。


数据衔接

工作区目录结构、技能间衔接文件与消费关系统一见 CONTRACT.md §1。要点:

  • 文件系统即数据总线:能力间不私有传参,只通过约定路径的文件 + Dossier 衔接。
  • 编号双轨:访谈发现编号(dd-interview 产出,主题索引)≠ 风险编号 R01…(risk-report 产出,跨版本稳定,规则见 CONTRACT §5);前者是后者的素材之一,无 1:1 映射。
  • 交叉比对核查覆盖 9 维框架(维度定义见 knowledge-base/reference/dd-check_dimensions.md)。

资源入口:模板在 {workspace}/templates/(清单/访谈/报告/交易文件/Dossier 模板),知识库入口见下节,辅助脚本在 {workspace}/scripts/(一致性检查、台账生成、md→docx 等;脚本失败时模型手工替代,见异常处理)。


异常处理

原则:降级不断流——外部依赖缺失时按 CONTRACT §7 适配器降级并按 AC5 显式标注「本项未核查,原因:…」,流程继续;禁止以沉默冒充无风险。

场景处理
工商数据源失败/限流用已有缓存;无缓存走手工采集模式(CONTRACT §7.1);仍不可得 → 标注待核实后推进
行业研究无结果标注 [推断] 无行业特殊风险,不阻塞
关键材料缺失 >50%按 CP2 结论性缺口处理(CONTRACT §4.1):标明缺口与影响,由审批人决定补材料、带限制继续或暂缓该项判断
脚本执行失败跳过脚本,模型手工替代(效率降,不断流)
同一步骤失败 ≥3 次暂停升级人工:停止重试,向审批人说明错误与建议方案,不自行换路径
用户要求跳过中间 Phase尽调场景内默认路径不可跳过,可加速(合并子确认);材料报告场景是独立任务范围(见场景判断),不是对尽调路径的跳过;任何偏移记入日志
用户要求回退允许,追加回退记录;已有产物不覆盖,版本共存
project_log.md 损坏/不可读从 Dossier 与目录产物重建日志骨架,标注 [重建]
Dossier 缺失从模板初始化并标注 [重建];缺失状态下报告不出终稿

安全底线:对外文档(清单/报告/交易文件)生成前检查不含内部字段(风险等级、核实方式、内部备注);任何文件外发前必须审批人确认,AI 不得自行发送。


知识库(选择性加载)

入口:{workspace}/knowledge-base/VERSION.md(各模块版本、状态与文件索引)。按当前步骤的相关性选择性加载:风控发现沉淀(7 大风险主题)、行业专项检查库、案例学习笔记(可选私有库——开源包不含案例数据,使用者自建,见该目录 README;无则跳过,仅加载 writing_patterns)、风控术语表、reference/ 参考规范(9 维核查框架、五级风险分类标准、交易条款库等)。相关性由模型判断,不设强制全量加载;研究类产出的来源落盘要求见 CONTRACT §7.4。


风险评级核心原则(全工作流通用)

评级依据事实状态、影响、发生可能性与可缓释程度;不设机械上限,不设机械降级。 权威定义见 risk-report references/ 与 knowledge-base/reference/risk_classification_framework.md。每次输出风险矩阵前逐条校验。

维度规则
评级依据事实状态(确定性标签,与等级分离呈现)× 影响 × 发生可能性 × 可缓释程度;等级含义落到行动(优先核查/交易前置)
现实 vs 潜在是否实质化是发生可能性的输入,不是封顶规则;潜在风险可能性高且影响重大的照实评高
审核/交易/退出影响非审核红线的事项若对交易可行性或退出构成重大影响,按自身影响评级
常见瑕疵与已整改"行业常见""已整改"是影响评估背景,不是降级规则;已整改事项按剩余影响与复发可能性评估
暂缓定级证据不足时暂缓定级并列出所需信息;暂缓不替代识别
行业特异性医疗(临床试验合规)、半导体(出口管制)、军工(资质有效性)、数据密集型(数据出境)、金融(牌照有效性)、新能源(环保合规)的高频风险不受"行业普遍存在"背景稀释

知识库维护(数据飞轮)

知识库随项目积累进化,但项目学习默认写入仓库外的私有知识库;公共知识库仅接受去除个案信息的通用方法,经独立发布审核后更新。每完成 5 个项目,主动提醒审批人执行知识库审查:

  1. 风控发现沉淀:读近 5 个项目的 risk_matrix,识别新风险模式 → 先写入私有库;其中不含个案信息的通用模式经发布审核后可进入公共沉淀
  2. 行业专项检查库:新行业缺失检查点 → 私有库先行;公共行业库仅收录条件式核查问题(不含个案状态与成套参数)
  3. 写作范式:新案例笔记与现有范式对比 → 新范式先更新私有写作范式库;进入公共 writing_patterns 前去除个案信息并经发布审核
  4. 术语表:新术语 → 更新

审查结果经人确认后写入私有库;拟进入公共库的内容按 docs/EXCLUSIONS.md 的发布范围规则审核,并同步更新 VERSION.md。


版本

当前版本以 frontmatter version 为准。版本历史见 CHANGELOG.md;跨技能契约与变更记录见 CONTRACT.md。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.