القائمة
Skill 创建预检、可靠性验收与格式审查工具。本技能应在用户创建、重大改造或审查Skill，需要识别旧版 Skill 的指令遵循不稳定、产出漂移、验证模态错配、约束漏检，或检查 Harness 契约、候选绑定证据、故障注入、目录结构、业务流和安全风险时使用。不要用于：代替业务领域验证器、代码审查、应用功能测试、通用编程任务。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
将本地开发的 Skills 批量同步到 ClawHub 与腾讯 SkillHub 两个平台。支持智能 .gitignore 过滤、白名单控制、增量同步、单个 skill 同步、双平台分流发布。本技能应在用户需要将本地 skills 发布到 ClawHub/SkillHub、批量同步技能、检查发布状态时使用。
跨平台 Agent 任务协调枢纽。本技能应在多个不同平台的 Agent 需要围绕项目任务源分配任务、标记归属、能力路由和交接上下文时使用。不要用于单一平台内的本地并行执行，或 Git 分支、提交、PR、merge 安全规则。
输入各类视频网站/播客平台链接后，自动下载对应媒体文件并交付给用户。优先使用 yt-dlp 覆盖抖音(Douyin)、B站(Bilibili)、YouTube 等常见视频网站，也可用于可直接暴露音频地址的播客平台（如小宇宙单集链接）。当遇到 403/登录/年龄或地区限制时，支持使用 cookies.txt 重试；对于可能存在 DRM/加密或条款限制的平台（例如部分 Spotify 内容），应提示用户仅下载其有权保存的内容，并在不可下载时建议改用官方离线/导出渠道或提供原始 RSS/直链。抖音视频在 yt-dlp 撞签名墙（"Fresh cookies needed"）时会自动 fallback 到无登录直连 aweme.snssdk.com/v1/play（仅需 video_id，不需要 cookie/a_bogus 签名）；抖音图文笔记暂不支持自动下载，需手动处理。
元典法条与案例检索。本技能应在需要查询中国法律法规条文、检索相关案例、为法律分析提供数据支撑时使用。
PDF 处理工具，支持扫描件预处理、OCR 双层 PDF、页码添加、PDF 合并、解密、水印去除和压缩。本技能应在用户需要一键处理、优化或整理 PDF 文档时使用。不要用于：纯文本 PDF 内容编辑、PDF 阅读与批注、电子签名、非压缩目的的格式转换。
面向中国发明和实用新型专利的结构化初步分析工具。本技能应在用户需要拆解或解释权利要求、比较专利保护范围、进行产品侵权比对、等同分析、稳定性与无效风险分析、FTO、规避设计、专利价值评估或制作专利分析图表时使用。不要用于：代替专利律师或专利代理师出具正式意见、仅下载/OCR专利、撰写专利申请文件，或在未确认法域与有效权利要求时给出确定性结论；外观设计近似判断需另行采用专门方法并人工复核。
| name | skill-lint |
| homepage | https://github.com/cat-xierluo/legal-skills |
| author | 杨卫薪律师（微信ywxlaw） |
| version | 2.8.0 |
| license | MIT |
| description | Skill 创建预检、可靠性验收与格式审查工具。本技能应在用户创建、重大改造或审查Skill，需要识别旧版 Skill 的指令遵循不稳定、产出漂移、验证模态错配、约束漏检，或检查 Harness 契约、候选绑定证据、故障注入、目录结构、业务流和安全风险时使用。不要用于：代替业务领域验证器、代码审查、应用功能测试、通用编程任务。 |
本技能负责 Skill 创建前设计预检和创建后质量验收：审查一个 Skill 是否结构合规、文档一致、可发布、可评估、安全风险可控，判断它是否真实承载业务流程，并检查“完成”结论是否由候选绑定证据和多轮真实产物支撑。
本技能不代替主要创建者或领域验证器。创建或大改 Skill 时，用它先审查 Harness 设计，再由创建工具实现，完成后回到本技能做候选绑定验收。
审查时至少需要：
可选输入：
config/review-profile.local.yaml如需配置个人或项目的发布元数据策略，先复制 config/review-profile.example.yaml 为 config/review-profile.local.yaml，再填入本地值。个人偏好只作为本地上下文使用，不写入公开文件，不复制到审查报告中，除非用户明确要求公开。
references/harness-reliability-standards.md，产出七层 Harness 设计、Hard Fail 和至少一个逃逸反例；不要直接扩大提示词。NOT_VERIFIED，不得称功能已验收。references/instruction-stability-standards.md 并运行静态 assess；缺少约束追踪合同或多轮证据时标记 NOT_VERIFIED，不得用一次成功执行推断稳定。NOT_VERIFIED，除非用户明确授权并使用隔离环境。创建预检完成后，由用户指定的创建工具或实现者落地；本技能在实现完成后重新进入正式验收。这样既把可靠性理念前移，又不让审查器与生产器混成同一责任。
先读取 references/repository-skill-discovery-standards.md，判断输入目标是哪一类：
SKILL.mdSKILL.md 单元，但存在带 name / description frontmatter 的 Markdown 或 README 索引不要只因为仓库根目录缺少 SKILL.md 就判定整个仓库不合格。根目录缺少 SKILL.md 只有在用户明确指定根目录就是单个 Skill，或仓库声明自己是一个可加载 Skill 根目录时，才按严重问题处理。
发现候选单元后，先列出：
SKILL.mdname / description frontmatter，或 README 明确称为 skill如果候选单元很多，先按用户指定范围审查；用户未指定时，优先审查已确认 Skill 单元，并抽样检查 Skill-like 文档，报告中说明抽样范围。
对每个已确认或被选中的候选单元列出文件，并重点检查：
SKILL.mdCHANGELOG.mdLICENSE.txtconfig/*.example.*references/*.mdscripts/*assets/*templates/*archive/.gitkeep如果在 Skill 单元内出现 .env、真实密钥、__pycache__/、docs/、test/ 等发布版不应包含的内容，按严重程度记录。仓库根目录的 README、docs、LICENSE、CHANGELOG 可以是 monorepo 治理文件，不按单个 Skill 目录结构误判。
先读取 references/skill-standards.md 作为审查索引，再按问题类型读取对应模块。不要一次性把所有细则混在一份报告逻辑中。
默认模块：
repository-skill-discovery-standards.md：仓库类型、monorepo、最小 Skill 单元和候选文档发现structure-standards.md：目录结构、文件可达性、references 命名frontmatter-metadata-policy.md：通用字段与发布字段分层trigger-description-standards.md：name 与 description 触发边界configuration-privacy-standards.md：配置模板、本地配置隔离、公开内容去具体化security-assessment-standards.md：危险执行、敏感访问、数据外传、凭证、依赖、MCP 和提示词安全publishing-standards.md：LICENSE、CHANGELOG、version、README / marketplace 同步workflow-output-standards.md：SKILL.md 正文、依赖、脚本、输出和可编排性business-flow-rubric.md：业务流深度、Hard Fail 和可评估性基础harness-reliability-standards.md：七层 Harness、独立验证、候选绑定证据、故障注入和闭环instruction-stability-standards.md：约束追踪、验证模态、产物阶段、多轮覆盖和漂移判定reporting-standards.md：问题分级和报告结构LICENSE.txt、version、README 和 Marketplace 属于发布治理，不属于普通目录结构硬要求。审查私人或第三方普通 Skill 时，只有在用户给出发布目标或项目规则时才按发布模块判定。
读取 references/security-assessment-standards.md，对纳入审查的 Skill 单元做安全风险评估。
先运行确定性静态安全扫描（对应 NVIDIA SkillSpector 的漏洞模式）：
# 单个 Skill
python3 scripts/security_scan.py audit --candidate-root /path/to/skill
# Skill 集合 / monorepo（递归发现所有含 SKILL.md 的最小单元）
python3 scripts/security_scan.py batch --root /path/to/skills
# 联网查询 OSV 已知漏洞（默认离线只做版本 pin 检查）
python3 scripts/security_scan.py audit --candidate-root /path/to/skill --online
扫描器输出含文件、行号、能力信号、严重级、置信度与修正建议的结构化 JSON；存在 critical/high finding 时退出码 1（FAIL），未发现 SKILL.md 时退出码 2。覆盖：危险执行（subprocess/os.system/eval/exec/动态导入）、网络外传、环境变量/敏感文件访问、运行时自动安装、未固定依赖与已知 CVE、硬编码凭证、提示注入、污点流（env/argv/input → subprocess）、文件系统枚举、隐藏 Unicode 字符、MCP 通配权限，以及"能力存在但文档未披露/未声明权限"（Missing User Warnings / MCP Least Privilege / Context-Inappropriate Capability）与文档级 scope creep（commit 技能引导发布/改 allowlist 等未披露的高风险动作）。
重点检查：
SKILL.md 和 references 是否含提示注入、绕过安全限制、隐藏执行、敏感数据收集或欺骗性描述安全评估不等同于完整渗透测试。对扫描器命中项要结合上下文判断误报；但涉及凭证泄露、下载并执行、权限提升、持久化、无确认数据外传、隐藏提示词指令等问题时，默认按严重问题处理。
使用 references/business-flow-rubric.md 检查：
默认采用中等严格度：Hard Fail 是硬指标，五层评估对象是软指标。
创建预检、重大改造和正式验收必须读取 references/harness-reliability-standards.md，逐层检查 Contract / Producer / Verifier / Evidence Binding / Fault Injection / Closure / Composition。旧版、多维审阅、视觉生产或用户反馈“反复漏项/产出漂移”时还必须读取 references/instruction-stability-standards.md。
先运行不执行候选代码的具体失效审查。单 Skill：
python3 scripts/harness_failure_audit.py audit \
--candidate-root /path/to/skill
Skill 集合或 monorepo：
python3 scripts/harness_failure_audit.py batch \
--root /path/to/skills
该审查器递归发现包含 SKILL.md 的最小单元，输出带文件、行号、证据、影响和修正建议的稳定 JSON；hard finding 返回 1，范围错误或集合中零 Skill 返回 2。规则 ID 与边界见 references/harness-reliability-standards.md。默认只做静态审查，不执行、安装或联网。
旧版结构性稳定性审查：
python3 scripts/instruction_stability_gate.py assess \
--candidate-root /path/to/skill
缺少 config/instruction-stability-contract.json 时，assess 返回退出码 2 和 INSTRUCTION_STABILITY_NOT_VERIFIED，同时给出 ISG 结构性 finding 与 HFA/HRA 具体实现 finding。视觉/几何语义只从 SKILL.md 和 references/**/*.md 的规范性上下文识别，TASKS/DECISIONS/CHANGELOG 的历史讨论不触发视觉模态。此模式不执行候选代码，适合旧版和未知第三方 Skill。
ISG-002 会列出触发视觉/几何要求的规范来源和行号，但它只证明候选缺少合适模态的领域验证证据。不要据此声称已经检测出重叠、裁切或其他具体业务错误；应让目标 Skill 提供自己的 checker、最小违规反例与合法近似正例，再由正式门禁复算。
声称“指令遵循稳定”“多轮不漏项”前，目标 Skill 必须提供约束追踪合同。每条 hard constraint 在权威来源中使用唯一 <!-- skill-lint:constraint CONSTRAINT-ID --> 锚点；候选外 evaluator-signed 基线必须与全部锚点、规范行、合同和当前候选哈希一致。先取得当前候选可复算的 Harness 审查证据，再用相同输入/配置至少独立执行三轮；每轮保留唯一 execution nonce、evaluator-signed producer log 和独立目录内的真实产物。每条硬约束还必须有候选外 evaluator-signed held-out 正反例。完成静态安全审查、披露 checker 且用户确认候选为自有/可信代码后，运行：
python3 scripts/instruction_stability_gate.py verify \
--candidate-root /path/to/skill \
--evaluator-public-key /path/to/review/evaluator-public.pem \
--requirements-baseline /path/to/review/requirements-baseline.json \
--harness-evidence /path/to/review/harness-review.json \
--held-out-cases /path/to/review/held-out-cases.json \
--held-out-root /path/to/review/held-out \
--run-evidence /path/to/review/runs.json \
--runs-root /path/to/review/runs \
--receipt /path/to/review/instruction-stability-receipt-draft.json \
--confirm-trusted-candidate
该门禁固定使用当前受信 skill-lint 复算 HARNESS_REVIEW_VERIFIED，再逐轮重跑 active checker。它要求每条硬约束精确映射到显式来源锚点、自动发现并签名枚举的 requirements sources/exclusions、checker、正确验证模态、正确产物阶段、带类型/条件/阈值的 measurement、签名 hidden 正反例和已知历史回归；合同漏列规范行、签名无效、三轮复用路径、旧候选/旧 producer 日志重放、负向用例因其他约束失败、少报一个 constraint id、checker 修改产物或关键 observable 漂移都会阻塞。公开、隐藏和真实运行产物统一使用同类随机暂存路径，避免 checker 按样本类别分支。
verify 只生成 INSTRUCTION_STABILITY_EVIDENCE_READY 草稿。evaluator 必须在不执行候选代码的隔离环境用 Ed25519 私钥运行 sign-evidence --private-key ...，再用只持有候选外公钥的 verify-receipt 复验全部绑定；只有后一步输出 INSTRUCTION_STABILITY_VERIFIED 才能声明稳定。私钥不得出现在 producer/checker 的进程树、环境或可读工作区，完整命令见 references/instruction-stability-standards.md。
客观 Hard Fail 一律阻塞。正式验收应先用 scripts/harness_evidence_gate.py snapshot 固化候选与规则读集，填写候选内 checker、参数、超时和故障用例的预期失败码。完成静态安全审查并取得用户对自有/可信候选的确认后，再用 verify --confirm-trusted-candidate 亲自重跑。JSON 中不得填写或采信自报退出码、PASS 和日志。只有退出码为 0 且出现 HARNESS_REVIEW_VERIFIED，才能说“当前候选的 Harness 审查证据已验证”。该标记不替代目标 Skill 自己的 DOMAIN_VERIFIED，门禁也不是第三方代码沙箱。
完成标记不可互相替代：
HARNESS_REVIEW_VERIFIED：当前候选、规则、checker 和故障用例证据有效。INSTRUCTION_STABILITY_EVIDENCE_READY：动态复算已完成，但草稿尚未离线签名与验签，不能作为完成标记。INSTRUCTION_STABILITY_VERIFIED：evaluator Ed25519 签名回执已复验，外部硬约束基线/held-out、当前 Harness evidence、候选/producer 绑定和至少三轮真实产物逐约束通过，measurement/observable 未漂移。DOMAIN_VERIFIED：领域验证器确认具体业务产物正确。只要 Skill 声称“稳定完成”，就必须同时满足前两项；若还声称业务结果正确，再加第三项。未运行的层一律写 NOT_VERIFIED。
确认 Skill 是否具备后续 eval 的基础：
缺少这些内容不一定阻塞发布，但应作为质量风险记录。
审查报告应优先列出问题，再给摘要。严重问题必须具体到文件和位置。
如用户需要最终交付件、发布前意见或正式质量结论，使用 templates/skill-quality-opinion-report.md 生成“Skill 质量意见报告”，报告中必须写明问题、影响、修正方式和复查标准。
对承载设计原理的结构性建议（拆解披露、触发边界、上下文聚焦、自由度匹配、可机判验收等），在 finding 的「设计理念」字段一句话讲清背后写作原理，可回查对应 standards 文件的「设计理念」小节，使报告同时具备 skill 写作教学价值；纯事实问题（文件缺失、引用断裂、命名大小写）可省。稳定性 finding 必须具体指出漏的是哪条 constraint、验证模态、产物阶段、case 或 run，不使用“遵循不稳定”这类无法复查的泛称。
生成正式质量意见报告后，按 references/archive-standards.md 判断是否归档。需要归档时，在本技能 archive/YYYYMMDD_HHMMSS_<target-slug>/ 下保存报告、元数据和证据索引；真实归档内容不提交到 Git。
| 级别 | 说明 | 处理 |
|---|---|---|
| ❌ 严重 | 阻塞加载、发布、使用安全或质量验收 | 必须修复 |
| ⚠️ 警告 | 影响维护、复用、审查可信度或可评估性 | 建议修复 |
| ℹ️ 信息 | 风格、清晰度或后续改进建议 | 可选处理 |
Hard Fail 一律按严重问题处理。
正式质量意见报告模板见 templates/skill-quality-opinion-report.md。报告除原有结构、安全、业务流和可评估性外，必须单列 Harness 七层结论、证据等级和完成标记。
模板的设计理念要点（结构性建议必填「设计理念」字段，纯事实问题可省）：
references/skill-standards.md：审查索引和模块路由references/repository-skill-discovery-standards.md：仓库类型识别、monorepo 单元发现和候选文档分级references/structure-standards.md：目录结构、文件可达性和 references 命名references/frontmatter-metadata-policy.md：Frontmatter 通用字段与项目发布字段分层策略references/trigger-description-standards.md：name 与 description 触发边界references/configuration-privacy-standards.md：配置模板、本地配置隔离和公开内容去具体化references/security-assessment-standards.md：危险执行、敏感访问、数据外传、凭证、依赖、MCP 和提示词安全references/publishing-standards.md：LICENSE、CHANGELOG、version 与发布索引references/workflow-output-standards.md：正文工作流、依赖、脚本、输出和可编排性references/business-flow-rubric.md：业务流深度和可评估性判则references/harness-reliability-standards.md：Harness 七层可靠性、Hard Fail、创建预检和候选绑定证据门禁references/instruction-stability-standards.md：旧版识别、约束追踪、模态/阶段匹配、多轮执行和产出漂移门禁references/reporting-standards.md：问题分级和审查报告模板references/archive-standards.md：正式审查报告的内部归档机制references/skill-dev-guide.md：Skill 开发规范参考references/skill-orchestration-guide.md：复杂编排规范参考config/review-profile.example.yaml：个人/项目审查配置模板config/instruction-stability-contract.example.json：目标 Skill 的约束追踪合同示例config/instruction-stability-requirements-baseline.example.json：候选外独立硬约束基线格式示例config/instruction-stability-held-out-cases.example.json：evaluator-signed 候选外隐藏正反例清单格式scripts/harness_evidence_gate.py：生成和复算候选绑定的 Harness 审查证据scripts/harness_failure_audit.py：单 Skill / Skill 集合的具体 Harness 失效模式静态审查scripts/instruction_stability_gate.py：静态识别旧版结构风险，并验证多轮真实产物的逐约束覆盖稳定性templates/skill-quality-opinion-report.md：最终 Skill 质量意见报告模板