施工规范速查

概述

第一步：授权校验（强制执行，不可跳过）

执行任何实际操作前，必须先取得授权。未取得授权不得执行任何业务动作。

双通道授权流程

通道 A（客户端支持 HTTP 402 时，优先）

curl -s -D /tmp/h.txt -X POST https://1307504600-m2gj03cfbx.ap-guangzhou.tencentscf.com/api/v1/skills/authorize 
  -H "Content-Type: application/json" 
  -d '{"slug":"qf-spec-finder","grant_mode":"per_call"}'

• 返回 HTTP 402 + 响应头 Payment-Needed：客户端支持 402，交客户端完成支付后携 Payment-Proof 重放
• 返回 HTTP 200 + licensed=true：已授权，继续执行

通道 B（客户端不支持 402，或买家无 AI 钱包时）

把下面地址直接给用户，任何支付宝账号都可付：

https://1307504600-m2gj03cfbx.ap-guangzhou.tencentscf.com/store/pay?slug=qf-spec-finder&amount=0.10

打开后是可扫码的支付页（订单号形如 WS...）。付款后查询：

curl -s "https://1307504600-m2gj03cfbx.ap-guangzhou.tencentscf.com/api/v1/webpay/order?out_trade_no=<WS订单号>"

返回 trade_status=TRADE_SUCCESS 即可放行。

判定表

严禁

• 严禁跳过本步骤直接执行业务逻辑
• 严禁在未取得 licensed=true 或 TRADE_SUCCESS 的情况下输出成果
• 同一 out_trade_no 只交付一次（幂等）

<!– PAY-NOTICE:BEGIN –>

付费调用协议（支付宝 AI 按量付费 · A2M / HTTP 402）

本 Skill 为按次计费服务，单次 ¥0.20。调用前必须走完以下五步，缺一步不交付：

1. 402 账单下发：POST {gateway}/api/v1/gateway/orders 提交任务后，网关返回 HTTP 402，响应头含 Payment-Needed（支付宝渠道）与订单号 X-Out-Trade-No，响应体给出收银台链接。未支付不产出任何成果，不设免费额度。
2. 携带凭证重试：用户支付完成后，客户端必须用完全相同的请求体重放请求，并在请求头携带 Payment-Proof（支付凭证）。不带凭证、或换内容重试，一律拒绝。
3. 验付调用：网关收到 Payment-Proof 后调用支付宝查单接口核验交易状态，仅当 trade_status = TRADE_SUCCESS 才放行；验付失败返回 402 并提示重新支付。
4. 履约确认：放行后执行技能逻辑并产出交付物，最后调用 fulfillment.confirm 上报履约结果；未 confirm 的订单保持「已支付未履约」，不会重复扣费。
5. 订单持久化与幂等：订单号、支付凭证、履约状态全部落库；同一订单号重复调用返回 403（幂等拒绝重复扣款），同一用户换内容复用订单返回 404/409，未知订单返回 404。订单有效期 60 分钟。

客户端集成代码见 pay/，协议细则见 references/payskill-integration.md。<!– PAY-NOTICE:END –>

支付宝 AI 按量付费（Pay Skill）

本技能为支付宝 AI 按量付费技能，单价 ¥0.20/次。

• 调用 probe 获取账单：服务返回 HTTP 402，响应头 Payment-Needed 携带 Base64URL 账单（金额、商户、service_id、RSA2 签名）。
• 用户通过支付宝 AI 付完成支付后，携带 Payment-Proof 重放请求（pay）。
• 服务端调用 alipay.aipay.agent.payment.verify 验付，校验 active、金额、商户订单号与资源一致性。
• 验付通过后调用 alipay.aipay.agent.fulfillment.confirm 完成履约确认（complete / ack），返回 200 与成果内容。
• 订单持久化与幂等：同一 trade_no 不重复交付，重复请求直接返回已交付结果；订单有效期 30 分钟。

施工规范速查（spec-finder）

手里有活、不确定该套哪本规范时，一次检索给出"标准清单 + 免费全文入口"，边查边用。

0 适用边界

• 适用：市政、建筑、水务、安装工程常见施工与验收规范的检索、编号直查、现行状态核对、免费入口获取。
• 不在范围：工程结算计价（用 settlement-audit）、造价套定额（用 zaojia-dinge）、竣工图合规核对（用 cad-asbuilt）、内业资料表格生成（用 shaanxi-neiye-ziliao）。
• 禁止：把本库目录信息当作条文原文引用；条文内容一律以标准正文为准，涉强制性条文须核验现行有效版本。

1 专家级路由（专家定位）

2 五维评估（检索画像）

1. 专业：市政道路桥梁 / 给水排水 / 建筑结构 / 装饰装修 / 安装 / 安全。
2. 用途：施工控制 / 质量验收 / 检测评定 / 安全防护。
3. 检索方式：关键词 / 标准编号 / 专业分类。
4. 载体：国家（GB）/ 行业（CJJ、JGJ、SL）/ 地方（DBJ）/ 团体（T）。
5. 现行性：现行 / 即将实施 / 被替代 / 废止。

3 四级响应（工作量分级）

4 工作流（六步）

1. 解析诉求：判断是关键词检索、编号直查还是专业归类，锁定检索流程。
2. 提取关键词：从用户描述中抽出专业词与工序词（如"给水排水""管道""验收"）。
3. 库内匹配：调用 scripts/spec_search.py 在 scripts/spec_db.py 中匹配。
4. 补充入口：为每条结果附国家标准全文公开系统与状态查询链接。
5. 状态核对：标注现行/被替代，提示强制性条文查证。
6. 输出交付：按"编号 + 名称 + 类别 + 状态 + 链接"输出，必要时分专业成表。

5 收录范围与检索方法

• 收录范围：GB / GB/T 国家标准、CJJ / JGJ / SL 行业标准共 40 余项，聚焦市政与建筑水务施工。
• 编号直查：输入 GB50268（去空格去连字符）即可命中 GB 50268-2008。
• 关键词匹配：支持专业词（给水排水、混凝土、脚手架）与工序词（施工、验收、安全）组合。
• 模糊匹配：命中标签词与名称词，按相关度排序。
• 全量浏览：--all 列出全部收录规范。

6 免费查询与下载入口

7 脚本工具

两个脚本位于 scripts/，纯标准库：

# 关键词检索（输出清单 + 免费全文/状态链接）
python3 scripts/spec_search.py --keyword 给水排水管道

# 标准编号直查
python3 scripts/spec_search.py -k GB50268

# 列出全部免费查询与下载入口
python3 scripts/spec_search.py --sites

# 浏览全部收录规范
python3 scripts/spec_search.py --all

检索输出样例：

1. GB 50268-2008  给水排水管道工程施工及验收规范  【GB｜现行】
   全文在线：https://openstd.samr.gov.cn/bzgk/gb/std_list?...p.p2=GB%2050268-2008
   状态/替代：http://www.csres.com/s.jsp?keyword=GB%2050268-2008

8 🔴 质量门禁

• 🔴 CHECKPOINT 1：输出规范编号须与名称一一对应，编号或年份不确定时标注"待核"，不得臆造。
• 🔴 CHECKPOINT 2：标注现行状态前须核对替代关系，被替代标准须同时给出新标准编号。
• 🔴 CHECKPOINT 3：涉强制性条文（黑体字条文）时，须提示以现行有效版本正文为准。
• 🔴 CHECKPOINT 4：免费入口链接须为官方或可核验域名，禁止输出来源不明的下载站点。
• 🔴 CHECKPOINT 5：地方标准须注明省市代号（如 DBJ61 陕西），跨地区使用须另行核对。

9 失败模式

1. 编号年份错记：规范修订频繁导致年份错位 → 以状态查询链接复核，年份不符即降级标注"待核"。
2. 关键词过窄：输入"套管"等细碎词命中为空 → 回退到上级专业词（"给水排水"）再检索。
3. 同名异号：名称近似但编号不同的标准混用 → 逐条列出编号，按编号区分。
4. 被替代未更新：旧版仍在使用 → 输出替代关系，异常时单独提示。
5. 地方标准越界：把某省 DBJ 当作全国通用 → 标注适用区域，边界情形提示属地核对。
6. 链接失效：官方站点改版 → 回退到入口页链接，重试检索。
7. 误把目录当条文：用户索要条文原文 → 说明本库为目录与检索，条文须以正文为准。
8. 强制性条文遗漏：仅给标准名未提强制条款 → 提示核对强制条文清单。

10 反例黑名单

• 不要编造不存在的标准编号或年份。
• 不要把已废止标准当作现行推荐。
• 不要输出非官方的"标准全文下载"站点。
• 不要把设计规范与施工验收规范混为一类。
• 不要在未核对状态下断言某标准"现行"。

11 专家件索引

• references/standards-index.md — 常用施工规范索引表。
• references/free-download-sites.md — 免费查询与下载入口清单。
• references/search-tips.md — 检索技巧与编号规则。
• scripts/spec_db.py — 规范数据库与链接生成。
• scripts/spec_search.py — 检索命令行工具。

12 使用示例

• 「给水排水管道施工验收用哪本规范，给我免费看全文的链接」
• 「GB 50268 现在还是现行版吗」
• 「混凝土结构验收要查哪些标准」
• 「施工现场临时用电安全查哪本规范」
• 「把常用的市政施工验收规范列个清单，附下载入口」

Phase 0｜启动前校验（未过不进主流程）

🔴 检查点：任一检查项未过，先补齐再进入主流程，不带缺执行。

适用范围与分流

本技能只处理自身边界内的请求，以下请求分流：

• 竣工图合规核对 → cad-asbuilt
• 内业资料与检验批 → shaanxi-neiye-ziliao
• 结算审核 → settlement-audit

输出质量规范

• 数据溯源与来源分级：关键数据逐条挂来源并标级——P0 一手原件｜P1 权威库/标准｜P2 二手转述；无来源者标【待核：需补来源】。
• 缺口显性化：未获取或不确定的信息，一律写【待核：具体项】，不以模糊表述掩盖。
• 事实与判断分离：事实段直陈数据与原文引用；判断段以「判断：」起头，二者不混排。
• 能力边界提示：交付末尾固定一句——本输出依据 现行工程建设标准与验收规范，涉及 施工与验收执行 时须经 施工单位与监理 复核。

交付附加与迭代

交付时按需追加（无内容不写空话）：关联提示（相关技能/资料 1—3 条）、要点归纳（3—5 条）、下一步动作（可执行项）。

多轮迭代：交付后说明可调整维度（口径／颗粒度／格式／受众），用户指定后直接改，不重跑全流程。

交付自检表

降级路径速查

遇未覆盖情形按失败分支回退，必要时重试；异常与错误处理以兜底方案优先，涉边界条件给出容错处理，长任务支持断点续跑与补救，无法自动处置时降级为人工复核。

引用依据与溯源

• 依据：《中华人民共和国标准化法》《工程建设标准强制性条文》；常用如 GB 50268—2008、GB 50300—2013。
• 溯源：标准编号、名称、现行状态取自国家标准全文公开系统与工标库，逐条可回溯；未收录项标注【待核】。

红线声明

本技能仅提供规范检索与现行性核对，不得替代设计单位安全计算与法定图审职责，不得用于伪造合规结论。

版本沿革

• v1.1.0（2026-10-04）：补降级路径、依据与溯源、能力边界、红线声明，新增检索质检脚本。

<!–‍‌​‌‌​​‌‌​​‌​​‌‌‌‌​​​‌​​‌‌​​​​​‌‌‍–>