FDE Skill 开发规范手册

4人并行 · 50 Skill · 10字段描述 · SKILL.md目录结构 · Repair Loop · should-not-trigger · 三级上下文 · 产出防偏

一、开发规范
1命名规范

1.1 Skill ID与注册名

沿用云灵汐v5.1的SK-01~50编号,不重新编号。Hermes注册名格式:

SK-{编号}-{简写英文代号} // kebab-case,如 SK-01-auto-archive

1.2 文件命名

SK-{编号}_{中文简称}_v{版本}.{后缀} // 如 SK-01_项目自动建档_v1.0.md

1.3 字段命名

规则说明
JSON字段snake_case(小写+下划线),不用驼峰
时间格式ISO 8601(2026-09-04T10:30:00+08:00),不用时间戳
金额格式int分,不用float元。10000=100元
枚举值英文小写+下划线,如 "risk_level": "high"
空值null,不用空字符串""
空数组[],不用null
红线:金额用int分不用元——最高频bug来源。所有Skill输入输出统一。
2Skill描述模板

2.1 Skill描述10字段(注册时必填)

对标Agent Skills规范(agentskills.io),在原7字段基础上新增 allowed-tools / compatibility / version 三个字段:

{ "skill_id": "SK-01", "skill_name": "项目自动建档", "skill_name_en": "auto-archive", "description": "100-200字,三要素:做什么+何时触发+不做什么(见2.1.1)", "triggers": [见第8节触发词规范], "boundary": "A", // A/B/C "owner_fde": "FDE-1", "sop_stage": "S1-B00", "allowed_tools": ["erp.route-search"], // 工具白名单:只允许调这些工具 "compatibility": "requires: erp-module>=1.0; network: yes", // 环境依赖声明 "version": "1.0.0", // 语义化版本号 "dependencies": { "external_api": null, "mcp_tools": null, "upstream_skills": null, "downstream_skills": ["SK-02", "SK-05"], "parallelizable_with": null } }

2.1.1 description三要素规范(对标Agent Skills best practices)

description是AI路由Skill的唯一触发机制,必须包含三要素,100-200字:

要素说明示例(SK-10 公开工商查询)
做什么Skill的核心功能和输入→输出"查询企业的工商注册信息,输入公司名/统一社会信用代码,输出注册资本、法定代表人、经营状态等"
何时触发什么场景下应该调用此Skill,含关键词"当用户需要查工商信息、核验企业资质、尽调阶段查询合作方工商状态时使用"
不做什么明确边界,防止误触发"不查询司法记录(→SK-11)、不搜舆情(→SK-12)、不做风险评分(→SK-14)"
完整示例:"查询企业的工商注册信息,输入公司名/统一社会信用代码,输出注册资本、法定代表人、经营状态等。当用户需要查工商信息、核验企业资质、尽调阶段查询合作方工商状态时使用。不查询司法记录(→SK-11)、不搜舆情(→SK-12)、不做风险评分(→SK-14)。"
为什么从50字扩到100-200字:对标Agent Skills规范(description 1-1024字符,必须包含what AND when)。50字太短,AI路由时缺少足够语义信息做匹配,是调错Skill的首要原因。

2.1.2 allowed-tools工具白名单

对标Agent Skills规范的 allowed-tools 字段。每个Skill声明只能调用哪些工具,防止越权调用:

Skillallowed_tools说明
SK-10 工商查询["ext.scenic-query"]只能调企查查API,不能调MCP的order/fin工具
SK-27 合同生成[]纯LLM生成,不需要外部工具
SK-37 商品上架["ec.product-create", "ec.product-search"]只能调电商域的2个工具
SK-43 对账单生成["erp.dispatch-query", "order.query"]只能调ERP调度查询和订单查询
空数组[]表示纯LLM Skill,不需要外部工具。白名单外的工具调用一律拒绝。

2.1.3 compatibility环境依赖声明

声明Skill运行所需的环境条件,Hermes/工作台启动时自动检测:

"compatibility": "requires: asr-service>=1.0; network: yes; mcp: ec.*,erp.*" // 格式:requires: 依赖项>=版本; network: yes/no; mcp: 工具域 // 示例: // SK-19 录音转写 → "requires: asr-service>=1.0; network: yes" // SK-37 商品上架 → "requires: mcp: ec.product-create; network: yes" // SK-01 自动建档 → "requires: none"

2.2 System Prompt 5段式结构

## 角色定义 你是{角色名称},负责{职责描述}。当前执行SK-{编号} {中文名}。 ## 职责边界 你做什么:{列举} 你不做什么:{列举相邻Skill,用"→ SK-xx"标注路由} ## 输入规范 - {参数1}({类型},{必填/选填}):{说明} ## 输出规范 必须输出JSON,结构如下: {输出JSON Schema} ## 执行边界 - 级别:{A/B/C} - 执行后行为:{描述} - 禁止事项:{≥1条} - 输出前自检:格式/事实/范围/边界/语言 5项
"不做什么"必须列出所有易混淆的相邻Skill,用"→ SK-xx"标注正确路由。AI在边界模糊时据此自动路由。
3输入输出格式

3.1 输出公共信封(所有Skill必须遵守)

{ "skill_id": "SK-24", "skill_name": "尽调报告生成", "exec_status": "success", // success | partial | failed | cancelled "exec_boundary": "B", "need_confirm": true, // A=false, B/C=true "confirm_message": "尽调报告已生成,请确认", "data": { /* 业务数据 */ }, "progress": { // 进度提示(见第12节) "current_step": "B12 · 尽调报告生成", "current_stage": "S1 商机与尽调", "overall_progress": "12/31", "next_step": "B13 · 谈判问题清单 (SK-18)", "blocked": false }, "downstream_hint": { // 提示下游可消费的数据 "for_skills": ["SK-25"], "key_fields": ["report_id", "risk_level"] }, "errors": null, "timestamp": "2026-09-04T10:30:00+08:00" }

3.2 文档类Skill输出双结构

生成文档的Skill(报告/合同/材料)输出分structured(给下游Skill)+ document(给用户查看):

"data": { "structured": { "risk_level": "medium", "risk_score": 72 }, "document": { "format": "markdown", "content": "# 尽调报告\n..." } }
4Prompt工程规范

4.1 Prompt长度控制

Skill类型上限示例
简单型(查询/检索/归类)≤500 tokenSK-03/04/06/10
中等型(生成/检查/计算)≤1,200 tokenSK-05/07/24/27
复杂型(报告/合同/对账)≤2,000 tokenSK-24/25/43
超过2,000 token必须拆分。拆为2-3个串联小Skill,每个≤1,200 token。或使用references/引用文件模式(见4.5节)。

4.2 Prompt中必须包含的5类约束

约束说明示例
格式输出必须是什么格式"必须输出JSON,不输出任何其他内容"
事实禁止编造数据"只使用输入或API返回的数据,不可自行编造"
行为禁止越权"不评估风险等级(→SK-14)"
质量可检验标准"摘要≤6条""关键风险≤5条"
语言语言和风格"中文,正式商务语气"
第6类约束——默认值原则(对标Agent Skills "Provide defaults, not menus"):Prompt中应为可选参数提供合理默认值,而不是让AI/用户在多个选项中选择。例如SK-17额度测算应写"默认使用中等风险情景(profit_margin=0.15),用户未指定时按默认值执行",而不是"请选择风险情景:高/中/低"。减少决策负担,减少交互轮次。

4.3 Few-shot示例

Skill类型示例数说明
格式严格型1个输出格式固定,1个够
判断有弹性型2-3个需正反例
生成文档型1个模板给模板不给完整示例,避免照抄

4.4 输出长度控制

输出类型上限控制方式
结构化数据(JSON)≤2,000 tokenSchema限制≤20字段
摘要/列表≤500 token限制条数(摘要≤6,风险≤5)
文档(报告/合同)≤3,000 token分section输出,每section≤800
确认卡片≤300 token摘要≤6条,每条≤30字

4.5 复杂Skill的references/引用文件模式

对标Agent Skills规范的Progressive Disclosure。复杂Skill(SK-24尽调报告、SK-27合同初稿、SK-43对账单)如果规则太多塞不进2,000 token,使用引用文件拆分:

## SKILL.md(核心流程,≤1,000 token) 你是尽调报告生成助手。按照以下步骤生成报告: 1. 读取尽调数据包(上游交接1) 2. 按 references/report_template.md 的模板结构生成 3. 评分规则见 references/scoring_rules.md 4. 风险等级判定见 references/risk_matrix.md ## references/report_template.md(报告模板,按需加载) # 尽调报告模板 ## 一、企业基本信息 ## 二、工商与司法查询结果 ## 三、财务勾稽分析 ## 四、风险评级与纳入建议 ## references/scoring_rules.md(评分规则,按需加载) | 维度 | 权重 | 评分标准 | | 工商状态 | 20% | 注销=0, 存续=80, 异常=40 | ... ## references/risk_matrix.md(风险矩阵,按需加载) | 评分区间 | 风险等级 | 纳入建议 | | 0-30 | high | 不建议纳入 | | 31-60 | medium | 有条件纳入 | | 61-100 | low | 建议纳入 |
文件加载时机说明
SKILL.mdL3执行层核心流程指令,≤1,000 token,AI调用时加载
references/*.md按需详细规则/模板/矩阵,AI需要时才读取
scripts/*按需程序化计算脚本(如评分计算),运行后只输出结果不进上下文
引用原则:SKILL.md只放"做什么+怎么做"的流程指令,详细规则全部放references/。AI先加载SKILL.md执行,遇到需要详细规则时按需读references。这样2,000 token的Prompt限制下也能承载复杂业务逻辑。
5执行边界

5.1 三级边界

级别含义行为need_confirm
A级可自动执行直接返回结果,不弹卡片false
B级AI辅助人确认弹出确认卡片,用户确认后继续下游true
C级人工主责提供模板/预填,用户人工填写后提交true

5.2 四类自动化红线(AI不可自动执行)

红线说明涉及Skill
经营决策不可自动决定通过合作/纳入供应商SK-14, SK-24, SK-25
法务财务不可认定财务真实性/出具法务意见SK-15, SK-22, SK-28
资金动作不可自动发起付款/变更收款账户SK-35, SK-36
数据治理不可无边界爬取/自动脱敏后外传SK-09, SK-50
6人工确认卡片

6.1 统一格式(B/C级Skill执行后弹出)

{ "card_type": "confirm", "skill_id": "SK-24", "title": "尽调报告已生成,请确认", "summary": [ // ≤6条 {"label": "风险评级", "value": "中风险", "highlight": true}, {"label": "纳入建议", "value": "建议纳入,需追加担保"} ], "actions": [ {"id": "confirm", "label": "确认采纳", "primary": true}, {"id": "modify", "label": "我要修改", "primary": false}, {"id": "reject", "label": "不采纳", "primary": false} ], "next_hint": { // 接力棒(见第12节) "message": "确认后可进入谈判阶段,需要出谈判问题清单吗?", "suggested_skill": "SK-18", "auto_trigger": false // 不自动触发 }, "timeout": 86400, "on_timeout": "cancel" }

6.2 卡片设计规则

规则说明
摘要≤6条人能一眼扫完
高风险标红highlight=true的字段红色高亮
三按钮确认/修改/不采纳,不是二选一
超时取消B/C级超时一律cancel,不可auto_pass
修改入口点击后进入编辑模式,改完重新确认
拒绝有因点击"不采纳"后必填拒绝原因
7错误处理与降级

7.1 错误分类与处理

错误类型status处理策略重试
输入缺失/格式错误failed返回错误信息+正确格式示例否
外部API超时partial返回已获取部分+标注缺失,提示手动补充1次
外部API报错failed返回错误信息+API错误详情否
LLM生成异常failed自动重试1次(温度降0.3)1次
MCP工具不可用failed切换手工模式(见第11节)否
用户拒绝确认cancelled保存草稿,不触发下游否
写操作不自动重试:涉及资金/合同/商品的写操作失败后不自动重试,必须人工确认后手动重试。

7.2 Repair Loop(错误反馈修复循环)

对标LangChain ToolArgValidationMiddleware。Schema校验失败时,不是简单重试,而是把错误信息喂回LLM让它自修正:

## Repair Loop流程 1. LLM输出 → Schema校验 2. 校验失败 → 把错误信息+原始输出喂回LLM: "你上次的输出存在以下问题:{错误详情}。 请根据错误信息修正后重新输出。" 3. LLM修正输出 → 再次Schema校验 4. 通过 → 返回结果 5. 仍然失败 → 标记failed+返回原始输出供人工查看 // 最多2轮repair,超过则降级 // 温度策略:第1轮原温度,第2轮降0.3 // 示例: // 第1次输出:{"risk_level": "中风险", ...} ← 枚举值错误,应为"medium" // 反馈给LLM:"risk_level字段值'中风险'不在允许枚举[low,medium,high]内,请修正" // 第2次输出:{"risk_level": "medium", ...} ← 校验通过
场景Repair说明
格式错误(非JSON/字段缺失)2轮把具体错误喂回LLM,通常1轮就能修好
枚举值错误2轮把允许的枚举值列出来让LLM选
类型错误(string vs int)2轮把期望类型告诉LLM
语义错误(内容不对)不repair语义错误不是格式问题,repair无法解决,直接标记failed
写操作失败不repair资金/合同/商品操作不自动重试
Repair Loop vs 简单重试:简单重试是"再来一次"(同样温度同样Prompt,大概率犯同样错);Repair Loop是"告诉你错在哪了,改过来"(错误信息+原始输出一起喂回,修正率高得多)。

7.3 错误信封

{ "skill_id": "SK-11", "exec_status": "failed", "errors": [{ "code": "API_TIMEOUT", "message": "裁判文书网API请求超时", "detail": "请求耗时15s,超过5s阈值", "suggestion": "可稍后重试,或手动查询后录入", "retryable": true }], "data": null }
二、用户使用保障
8触发词防冲突

8.1 触发词三段式

所有触发词按 [动作]+[业务对象]+[限定词] 注册,禁止单动词:

// 正确 SK-07: "检查资料完整性" // 动作=检查 对象=资料 限定=完整性 SK-08: "检查主体一致性" // 动作=检查 对象=主体 限定=一致性 SK-24: "出尽调报告" // 动作=出 对象=尽调报告 // 禁止 SK-07: "检查" // 单动词,8个Skill冲突 SK-24: "出报告" // 单动词,4个Skill冲突

8.2 触发词注册规则

规则说明
每Skill ≤5条3-5条为最佳,太多增加冲突
主触发词唯一50个Skill主触发词两两不同,Day 1对齐会统一分配
带SOP阶段标签AI按当前阶段过滤,跨阶段时提示用户
{"skill_id":"SK-07","triggers":[ {"phrase":"检查资料完整性","type":"primary","sop_stage":"S1"}, {"phrase":"核对资料是否齐全","type":"secondary","sop_stage":"S1"} ]}

8.3 高频冲突词消解表

冲突词涉及Skill消解方案
"检查"SK-07/08/14/22/29/34/42/44加业务对象:检查资料/主体/偏离/材料/签署/差异/发票
"生成/出"SK-05/24/25/27/43/48加产出物名称:出清单/出尽调报告/出上会材料/生成合同
"查询/查"SK-03/10/11/12/39加对象:查案例/查工商/查司法/搜舆情/查核销
"算"SK-14/17/41加对象:算评分/算额度/复算公式
"监控"SK-38/47加对象:监控履约/监控风险变化
9职责边界防重叠

9.1 易混淆Skill对区分

重叠组区分原则
SK-07 vs SK-08SK-07管"有没有"(资料齐不齐),SK-08管"对不对"(主体信息一致不一致)
SK-07 vs SK-34SOP阶段隔离:SK-07在S1查尽调资料,SK-34在S4查签署要件
SK-29 vs SK-28SK-29横向(多份材料交叉比对),SK-28纵向(同份合同v1 vs v2)
SK-24 vs SK-25SK-24是尽调结论(风险视角),SK-25是上会包(决策视角,引用SK-24不重复生成)
SK-43 vs SK-44SK-43算账(应收/应付),SK-44开票(可开票项+税额),依赖SK-43
SK-38 vs SK-47SK-38监控交易执行(核销/付款),SK-47监控合作方自身(工商/司法/舆情)

9.2 职责矩阵(每个动作唯一主责)

业务动作主责不可越界
建档/录入项目SK-01其他Skill不可自动建档
评估风险等级SK-14SK-24引用SK-14,不自行评分
生成尽调报告SK-24SK-25引用SK-24,不重复生成
生成合同初稿SK-27SK-28只做版本对比,不生成初稿
计算对账金额SK-40SK-41只复算公式,不重新对账
生成对账单SK-43SK-44不生成对账单,只检查开票
10SOP全链路覆盖

10.1 B00-B30覆盖矩阵

步SOP动作主Skill状态说明
B00商机录入建档SK-01✓—
B01-B08识别/案例/模板/清单/归类/完整性/一致性/公开查询SK-02~08,10~13✓SK-10/11/12需API
B09-B12财务勾稽/数据标准化/额度测算/尽调报告SK-15,16,17,24✓—
B16.5商业方案四流检查SK-23△隐性SOP未独立编号,需在路由中显式标注
B13-B16谈判清单/转写/条款抽取/共识争议/偏离检查SK-18~22✓SK-19需ASR
B17-B20上会材料/审批路径/评论汇总/会议纪要SK-25,30~33✓SK-30需组织架构
B20.5律师对接资料组包SK-26△隐性SOP未独立编号,需在路由中显式标注
B21-B23合同初稿/版本对比/一致性/签署检查/付款/账户核验SK-27~29,34~36✓SK-36需银行接口
B24-B28商品上架/履约监控/核销对账/发票/逾期提醒SK-37~44,46✗MCPHermes断档,手工模式兜底
B29-B30续约复盘/归档/SOP提炼SK-48~50✓SK-50需全链路记录
2个隐性步骤必须标注:B16.5(SK-23四流检查)和B20.5(SK-26律师组包)在SOP中没有独立编号,但Skill链路中有。必须在路由表显式标注,否则AI串联时跳过。
覆盖结论:31步全覆盖,无空白。Hermes可跑25/31步,6步MCP断档有手工模式。
11断档兜底机制

11.1 三种断档与兜底

断档类型场景兜底
MCP未就绪B24-B28共6步手工模式(下方)
API不可用SK-10/11/12/19/30/36返回空数据+标注"待补充"+手动录入入口
上游缺失下游Skill的上游未执行null填充缺失字段+卡片高亮"数据缺失"

11.2 MCP手工模式规范

## 手工模式(MCP未就绪时自动切换) 1. 不执行实际业务操作(不创建商品/不导入核销/不开票) 2. 生成操作指引:目标系统+操作步骤+预填数据+确认方式 3. 告知用户:"当前为手工模式,我已生成操作指引和预填数据,请在ERP中操作后告诉我。" 4. 用户确认手工操作完成后,Skill继续下游 // 手工模式输出 { "mode": "manual", "reason": "MCP_TOOL_UNAVAILABLE", "instruction": { "target_system": "ERP-商品中心", "steps": ["1.登录ERP→商品管理→新建", "2.填写以下字段..."], "prefill_data": {"product_name":"...", "price":950000}, "confirm_method": "user_manual_confirm" } }
核心原则:断档不等于停摆。Skill跑不了实际操作,也要告诉用户"该干什么、怎么干、数据帮你填好了"。

11.3 上游检查(每个Skill执行前必须做)

1. 检查上游Skill是否已执行(project_id + upstream skill_id 有无输出) 2. 检查关键字段是否存在且非null 3. 关键字段缺失 → exec_status="partial" + 卡片高亮"数据缺失" 4. 关键字段全缺(上游未执行)→ exec_status="failed" + "请先完成XX步骤"
12进度提示与接力棒

12.1 进度提示(输出公共信封中的progress字段)

"progress": { "current_step": "B12 · 尽调报告生成", "current_stage": "S1 商机与尽调", "overall_progress": "12/31", "next_step": "B13 · 谈判问题清单 (SK-18)", "blocked": false }

12.2 接力棒(确认卡片中的next_hint)

Skill执行完成后主动提示下一步,但不自动触发(auto_trigger=false),用户点击才执行。

不自动触发的原因:用户可能要先讨论/等指示。auto_trigger=true仅限A级Skill间的纯自动链(如SK-10→SK-13→SK-14风险筛查链)。

三、AI适配与防偏
13AI上下文管理

13.1 三级上下文加载

级别token加载内容加载时机
L1 索引层
常驻
~3,00050个Skill精简索引(ID+名称+一句话描述+主触发词+阶段)对话开始常驻
L2 活跃层
按阶段
~8,000当前SOP阶段的全部Skill完整描述阶段切换时卸载旧/加载新
L3 执行层
按需
~2,000被调用Skill的完整Prompt+输入数据确定调用时加载
常驻上下文从85K降到~13K(L1+L2+L3),减少85%。AI注意力集中,调准率提升。

13.2 L1索引层格式

### S1 商机与尽调 (当前阶段) - SK-01 项目自动建档 | 触发:"建档" | A级 - SK-02 业务类型识别 | 触发:"识别业务类型" | A级 - SK-05 尽调清单生成 | 触发:"出尽调清单" | A级 - SK-07 资料完整性检查 | 触发:"检查资料完整性" | A级 - SK-10 公开工商查询 | 触发:"查工商" | A级 [需API] - SK-14 尽调评分辅助 | 触发:"算尽调评分" | B级 - SK-24 尽调报告生成 | 触发:"出尽调报告" | B级 ### S2 谈判与方案 (下一阶段) - SK-18 谈判问题清单 | 触发:"出谈判清单" | A级 ...

13.3 上下文压缩策略

策略说明
已执行Skill摘要化确认后保留摘要(skill_id+status+关键结论),丢弃完整输出
对话历史窗口保留最近5轮完整,更早压缩为摘要
交接数据外部存储不通过上下文传递,写入外部存储,下游按project_id读取
进度状态常驻SOP进度常驻上下文,但不保留每个Skill完整输出
14产出防偏机制

14.1 四类偏离及防护

偏离类型表现防护
幻觉编造API返回空,AI自己编数据①Prompt写"只使用输入或API数据,不可编造" ②API数据标注data_source ③空数据填null+标注"待补充"
格式漂移输出自由文本而非JSON①"必须输出JSON,不输出其他内容" ②输出后Schema校验,不过重试1次
越权执行SK-07顺手做了SK-08的事①Prompt写"不做什么"清单 ②输出Schema不含其他Skill字段
数值错误把分当成了元,结果放大100倍①"金额单位:分"写入Prompt ②输出含amount_unit:cent ③范围校验

14.2 输出前自检(每个Skill Prompt必须包含)

## 输出前自检 1. 格式:是否合法JSON,必填字段齐全 2. 事实:数据是否来自输入或API,有无编造 3. 范围:金额在1分~100亿元内,日期在合理范围 4. 边界:是否输出了不属于本Skill的字段 5. 语言:中文,正式商务语气 自检发现问题 → 修正后重新输出(格式/语言问题)或标注warning(范围/边界问题)

14.3 关键Skill双重校验(AI不做数学题)

Skill校验方式
SK-17 额度测算额度=采购价×(1+利润率),程序化复算
SK-41 公式复算按合同公式程序化计算,AI只提取参数
SK-40 逐笔对账核销与订单程序化匹配,AI只做差异分类
SK-14 尽调评分评分=加权求和(程序化),AI只做维度打分
核心原则:LLM负责"理解"和"判断",不负责"计算"。Skill实现="AI提取参数 → 程序化计算 → AI描述结果"。
15性能基准
指标基准说明
响应(纯LLM)≤8秒超过8秒用户感知明显延迟
响应(含API)≤15秒超时则降级
响应(含MCP)≤20秒超时则降级
Prompt token≤2,000单个Skill System Prompt上限
输出 token≤3,000单次输出上限
上下文 token≤15,000L1+L2+L3+对话历史
重试次数≤1次格式错误/LLM异常重试1次
确认超时24小时B/C级超时=取消

15.1 并行执行

用户一句话触发多个独立Skill时,AI应并行执行。Skill描述中声明parallelizable_with:

// "查一下工商、司法和舆情" → SK-10 ∥ SK-11 ∥ SK-12 并行 // "出尽调报告和上会材料" → SK-24 → SK-25 串行(有依赖) {"skill_id":"SK-10", "parallelizable_with":["SK-11","SK-12"], "depends_on":null, "blocks":["SK-13"]}
16Skill路由与调度

16.1 AI选Skill的4步路由

Step 1: 意图识别 // 动作=查询, 对象=工商信息 Step 2: 索引匹配 // 从L1索引匹配主触发词,命中1个→调用 Step 3: 消歧 // 命中多个→问用户"您要查工商(SK-10)还是司法(SK-11)?" Step 4: SOP阶段过滤 // 跨阶段→提示"当前在S1,对账单在S5,是否跳转?"

16.2 SOP阶段切换

场景行为
当前阶段未完成不允许跳转,提示"还有X步未完成"
当前阶段完成提示可进入下一阶段,用户确认
用户强制跳转允许但标注"跨阶段跳转,可能缺失前置数据"
回退已完成阶段允许,标注"回退修正"

16.3 Skill不可用时的路由降级

场景路由行为
API不可用调用Skill → 内部降级为partial+标注缺失
MCP未就绪调用Skill → 内部降级为手工模式
Skill未安装提示"需SK-xx,当前未安装"+提供操作指引
意图不明确列出最可能的3个Skill供用户选择
四、协作与交付
17跨FDE交接格式(6个)

Day 1开工前对齐会确认。格式变更必须通知全员并升大版本号。

交接1:尽调数据包 FDE-1 → FDE-2

SK-08+SK-14 → SK-24

{ "package_type": "due_diligence_pack", "project_id": "PRJ-2026-0904-001", "entity_info": {"company_name":"xxx旅游开发有限公司","credit_code":"91520...","legal_person":"张三","registered_capital":10000000}, "risk_screening": {"business_status":"normal","judicial_records":["..."],"disambiguation":"confirmed"}, "risk_score": 72, "risk_level": "medium", "completeness": {"total":15,"provided":13,"missing":["近三年审计报告"]} }

交接2:尽调报告 FDE-2 → FDE-3

SK-24 → SK-25

{ "package_type": "dd_report", "report_id": "DD-2026-0904-001", "risk_level": "medium", "risk_score": 72, "inclusion_advice": "recommend_with_conditions", "conditions": ["需追加担保", "需季度对账"], "key_findings": [{"finding":"存在2条被执行记录","severity":"medium"}], "document_ref": "DD-2026-0904-001.md" }

交接3:商务条件 FDE-2 → FDE-3

SK-23 → SK-27

{ "package_type": "business_terms", "business_type": "package_ticket", "terms": { "pricing": {"purchase_price":800000,"selling_price":950000}, "payment": {"method":"prepay_50_pct","prepay_amount":400000}, "guarantee": {"type":"deposit","amount":200000}, "non_standard_clauses": ["..."] }, "four_flow_check": "passed", "deviations": ["..."] }

交接4:合同结构化 FDE-3 → FDE-4

SK-27 → SK-45

{ "package_type": "contract_structured", "contract_id": "CT-2026-0904-001", "clauses": [ {"clause_id":"CL-001","type":"refund","title":"退票及退款条款","key_terms":{"refund_rate":0.8}}, {"clause_id":"CL-002","type":"payment","title":"付款条款","key_terms":{"prepay_rate":0.5}} ], "document_ref": "CT-2026-0904-001.md" }

交接5:风险基线 FDE-1 → FDE-4

SK-10~14 → SK-47

{ "package_type": "risk_baseline", "baseline_date": "2026-09-04", "snapshot": {"business_status":"normal","judicial_count":2,"opinion_sentiment":"neutral","risk_score":72}, "monitor_fields": ["business_status","judicial_count","opinion_sentiment"] }

交接6:全链路执行记录 F1+F2+F3 → FDE-4

全部Skill → SK-48+SK-50

{ "package_type": "execution_log", "timeline": [{"skill_id":"SK-01","exec_time":"2026-09-04T10:00:00+08:00","duration_sec":15,"confirm_result":"auto"}], "statistics": {"total":31,"auto":17,"confirmed":10,"modified":3,"rejected":1} }
格式变更协议:①每日站会提出 ②全体确认 ③当天18:00前更新文档并通知全员。禁止单方面修改。
18文档交付规范

18.1 每个Skill必须附带

文档必填内容
SKILL.md必填YAML frontmatter(10字段)+ Markdown body(5段式Prompt)
references/复杂Skill详细规则/模板/矩阵(SK-24/27/43等),简单Skill不需要
scripts/计算类程序化计算脚本(评分/公式/对账匹配)
tests/必填≥3组正常/边界/异常 + should-not-trigger用例(见20.1)
CHANGELOG.md必填版本变更记录
MCP适配说明MCP类迁移时需对接的工具名+参数映射
API对接说明API类endpoint/参数/鉴权/限流/错误码

18.2 目录结构(对标Agent Skills规范)

采用SKILL.md目录结构,与Agent Skills规范兼容,便于Hermes/工作台双向兼容及未来开源共享:

skills/ ├── FDE-1/ ├── FDE-2/ ├── FDE-3/ ├── FDE-4/ │ ├── sk-01-auto-archive/ # 目录名=skill_name_en │ │ ├── SKILL.md # 必填:YAML frontmatter + 5段式Prompt │ │ ├── references/ # 选填:详细规则/模板/矩阵 │ │ │ ├── report_template.md │ │ │ └── scoring_rules.md │ │ ├── scripts/ # 选填:程序化计算脚本 │ │ │ └── calc_score.py │ │ ├── tests/ # 必填:测试用例 │ │ │ ├── should_trigger.json # 该触发的场景 │ │ │ └── should_not_trigger.json # 不该触发的场景 │ │ └── CHANGELOG.md # 必填:版本记录 │ └── ... └── _shared/ ├── handoff_formats/ # 6个交接格式定义 ├── enums.json # 全局枚举值 └── prompt_fragments/ # 可复用Prompt片段
为什么从扁平文件改为目录结构:①与Agent Skills规范兼容,未来可直接在Claude/其他平台复用 ②references/按需加载,SKILL.md只放核心流程 ③tests/独立目录,should-trigger和should-not-trigger分离 ④一个Skill一个目录,版本管理更清晰。
19冲突检测矩阵(交付前必跑)

19.1 触发词冲突检测

触发词SK-07SK-08SK-14SK-22SK-29SK-34SK-42SK-44
检查冲突冲突冲突冲突冲突冲突冲突冲突
检查资料完整性✓主———————
检查主体一致性—✓主——————
算评分——✓主—————
检查条款偏离———✓主————
检查材料一致————✓主———
检查签署要件—————✓主——
单动词"检查"8路冲突,加业务对象后全部消解。交付前对50个主触发词跑一遍冲突检测。

19.2 交付前必跑8项检测

检测项方式通过标准
触发词冲突检测脚本50个主触发词两两不冲突
职责重叠检测人工每对相似Skill有区分原则
SOP覆盖检测矩阵B00-B30+2隐性步骤,每步有Skill
Prompt长度检测脚本全部≤2,000 token
Schema一致性脚本6个交接格式字段一致
上下文模拟手动50个Skill安装后常驻≤15K
包票前6步串联手动Hermes上对话走通B00-B23
should-not-trigger脚本每个Skill的"不该触发"用例全部通过

19.3 自动验证脚本(skill-validator)

对标Agent Skills社区的 skill-validator 和 skills-ref CLI。开发一个Node.js验证脚本,自动检测以下项目,减少人工验收时间:

# 运行验证(在skills/根目录执行) node _shared/validate.js // 验证项目: 1. 结构检测:每个Skill目录是否有SKILL.md 2. 字段检测:SKILL.md frontmatter 10字段是否齐全 3. 命名检测:目录名==skill_name_en,kebab-case 4. 描述检测:description 100-200字,含"做什么+何时触发+不做什么" 5. 触发词冲突:50个主触发词两两编辑距离和语义相似度 6. Prompt长度:SKILL.md body ≤2,000 token(按1 token≈1.5字估算) 7. allowed_tools:白名单字段格式合法 8. 测试文件:tests/下有should_trigger.json和should_not_trigger.json 9. 交接格式:6个交接Schema字段名/类型/枚举值一致 10. CHANGELOG:每个Skill目录有CHANGELOG.md // 输出: ✓ SK-01: 10/10 passed ✗ SK-07: 9/10 failed — description仅82字(需100-200字) ✗ SK-24: 8/10 failed — references/目录缺失,Prompt 2,400 token超限
20验收标准

20.1 单Skill验收Checklist

  • 命名规范:ID/目录名/字段名符合第1节,目录名=skill_name_en
  • 描述完整:10字段齐全,description 100-200字含三要素(做什么+何时触发+不做什么)
  • Prompt:5段式结构,无模糊词,≤2,000 token
  • 触发词:≥3条三段式,主触发词不冲突,带SOP标签
  • 输入参数:每个有类型+必填+说明
  • 输出格式:公共信封+业务数据,Schema完整
  • 执行边界:A/B/C标注+禁止事项≥1条+四类红线
  • 确认卡片:B/C级有卡片JSON,三按钮
  • 错误处理:≥3种场景+处理策略+Repair Loop
  • 测试用例:≥3组(正常/边界/异常)
  • should-not-trigger测试:≥2条"不该触发此Skill"的用例
  • 输出前自检:5项自检指令
  • 职责边界:Prompt含"不做什么"+相邻Skill路由
  • allowed_tools:工具白名单声明
  • compatibility:环境依赖声明
  • references/:复杂Skill有引用文件(SK-24/27/43等)
  • 默认值原则:Prompt中可选参数有合理默认值
  • 跨FDE交接:输出格式与第17节一致
  • Hermes可跑:实际执行通过
  • MCP适配说明:MCP类Skill有迁移映射
  • 并行声明:parallelizable_with字段
新增should-not-trigger测试:对标Agent Skills evaluating-skills规范。不仅测"该触发的触发了",还要测"不该触发的没触发"。例如SK-07(资料完整性)的should-not-trigger用例:用户说"检查主体一致性"→应该触发SK-08而不是SK-07。这对50个Skill的冲突检测至关重要。
21版本管理
版本号使用场景示例
v1.0首次交付SK-01 v1.0
v1.1小修改(调Prompt/改模板/修bug)SK-01 v1.1
v2.0大修改(改输出格式/改边界/改交接格式)SK-01 v2.0
v1.0-mcpMCP迁移版本SK-37 v1.0-mcp
格式变更=大版本:输出格式变更必须升v2.0,并在每日站会通知全员,确保下游同步适配。

21.1 CHANGELOG

## v1.2 (2026-09-05) - 修复:risk_score计算未考虑司法金额权重 - 优化:确认卡片摘要从8条精简为5条 ## v1.0 (2026-09-03) - 首次交付
22每日协作机制

22.1 三会制度

会议时间时长内容
早站会9:3015min昨天做了什么/今天做什么/有无阻塞
交接对齐13:3010min当天跨FDE交接的格式/数据对齐
晚验收17:3020min当天交付Skill互相演示+验收+记录问题

22.2 日报模板

# FDE-{n} 日报 {日期} ## 今日交付 - SK-{xx} {中文名} v{版本} — 已上Hermes,验收通过 ## 明日计划 - SK-{xx} {中文名} — 预计Day {n}交付 ## 阻塞与协调 - {无/描述} ## 交接确认 - 交接给FDE-{n}:已确认/待确认 - 从FDE-{n}接收:已确认/待确认

22.3 问题升级

级别时效处理
P0立即交接格式对不上/API不通/无法执行 → 立即拉相关FDE
P1当天输出质量不达标/卡片设计问题 → 晚验收前解决
P2次日Prompt优化/测试补充 → 次日站会确认
23速查清单(打印贴桌上)

命名

  • ID: SK-01~50不变
  • 目录名: sk-编号-英文代号
  • SKILL.md: 必填
  • 字段: snake_case

格式

  • 数据: JSON
  • 时间: ISO 8601
  • 金额: int分
  • 空值: null
  • 空数组: []

描述10字段

  • description: 100-200字三要素
  • allowed_tools: 工具白名单
  • compatibility: 环境依赖
  • version: 语义化版本

Prompt

  • 5段式: 角色/边界/输入/输出/执行
  • ≤2,000 token
  • 6类约束: 格式/事实/行为/质量/语言/默认值
  • 输出前5项自检
  • references/引用文件(复杂Skill)

触发词

  • 三段式: 动作+对象+限定
  • ≤5条/Skill
  • 主触发词唯一
  • 带SOP阶段标签
  • 禁单动词

确认卡片

  • 摘要≤6条
  • 三按钮: 确认/修改/不采纳
  • 高风险标红
  • 超时=取消
  • 拒绝必填原因
  • 含next_hint接力棒

上下文

  • L1索引 3K 常驻
  • L2活跃 8K 按阶段
  • L3执行 2K 按需
  • 合计≤15K
  • 已执行摘要化

防偏+Repair

  • API数据标注来源
  • 空数据填null不编造
  • 计算程序化AI不算数
  • Schema校验失败→Repair Loop 2轮
  • 写操作不自动repair

断档兜底

  • MCP断→手工模式
  • API断→降级+标注
  • 上游缺→null+高亮
  • 输出带progress
  • 卡片带next_hint

文档

  • SKILL.md(必填)
  • references/(复杂Skill)
  • tests/ should_trigger+should_not_trigger
  • CHANGELOG.md
  • MCP适配说明(MCP类)

验收

  • 命名✓描述10字段✓Prompt✓
  • 触发词✓输入✓输出✓
  • 边界✓禁止事项✓
  • 自检✓should-not-trigger✓
  • allowed_tools✓repair loop✓
  • Hermes可跑✓

每日

  • 9:30 早站会15min
  • 13:30 交接对齐10min
  • 17:30 晚验收20min
  • 日报17:00前发
  • 格式变更通知全员
  • validate.js自动检测