agentleFS
hxhx-winhxhx-win/zhuanli-flow/skills/cn-patent-repo-scout/SKILL.md

cn-patent-repo-scout

Skill4 starsChanged 3 months agoMITView on GitHub

当用户只提供项目目录、代码仓库或技术资料,并要求“看看有什么能申专利 / 扫描项目 / 推荐专利方向 / 找核心资料”,但尚未明确技术主线或保护方向时使用。独立于完整起草编排器;扫描后由用户在 AskUserQuestion 中二选一:进入完整编排器或暂停。已有明确方向时改用 `cn-patent-mainline-analysis`;不做保护路径设计、不做现有技术检索、不起草正式稿。触发词:专利方向扫描、看看能申什么专利、推荐专利方向、找核心资料、`source-material-roles.json`、repo scout、direction scan。

The file

Files
SKILL.md

专利方向扫描

扫描项目资料,发现可申报方向,辅助用户确认技术方向和核心资料。只做方向发现和资料角色准备,不做保护路径设计、现有技术检索或专利起草。

边界

  • 本 skill 独立运行,不读取或创建 patent/<patent-slug>/state/patent-iteration-state.json。
  • 扫描产物是项目级缓存,可被多个专利方向复用。
  • Top-N 所有方向都要先落盘;完成方向记录后必须停住,让用户选择下一步。
  • 若用户已明确技术方向、保护客体或选定模块,改用 cn-patent-mainline-analysis 设计保护路径。
  • 若用户明确要完整起草专利或继续既有状态文件,改用 cn-patent-domain-runtime。

工作流

步骤动作产出Gate
S1确认扫描根目录、排除规则;必须呈现权重维度表并等待确认或调整确认后的权重用户确认权重
S2资料可读性预检:枚举待扫描文件的后缀,对照 references/material-readability.md 判断每类格式当前环境是否能完整读取;对不可完整读取的资料输出提示并按当前环境给出安装命令推荐patent/repo-scout/readability-report.md用户选择处理方式
S3运行只读扫描或 scripts/patent-repo-scout.py;若缓存可复用,可直接进入 S4patent/repo-scout/repo-profile.json—
S4逐问澄清:至少 2 轮,一次一问,优先多选题澄清记录和排序依据—
S5呈现 Top-N 推荐方向,并为所有方向生成独立记录recommendation-report.md + 每个方向的 direction-record.json 和 source-material-roles.json—
S6停住并通过 AskUserQuestion 控件让用户在「进入完整编排器」与「暂停」之间二选一;用户可指定任一 <direction-slug> 继续下一步选择用户选择下一步

资料可读性预检纪律

  • S2 必须先枚举扫描根目录下所有文件后缀(可结合 find / Get-ChildItem 或脚本输出),与 references/material-readability.md 对照判断每类格式在当前环境的可读取程度(完整 / 仅文本 / 不可读)。
  • 必须先检测当前操作系统(Linux / macOS / Windows)以及对应包管理器(apt / dnf / brew / winget / choco / scoop / pip),再据此挑选可执行命令。
  • 对每类不可完整读取的资料,必须明确告知用户:
    • 涉及的文件清单(或样例 + 数量);
    • 缺失的内容维度(如 PDF 页图像、docx 嵌入图、PNG 视觉内容、扫描件文字等);
    • 这种缺失对方向发现的潜在影响(例如附图缺失会削弱"证据完备性"评分)。
  • 必须基于当前操作系统和已检测到的命令,按 references/material-readability.md 中的工具表给出可执行的安装命令,并按"最小够用 / 完整办公套餐 / 含 OCR"分档推荐。Windows 环境优先给 winget 命令,缺失时回退到 choco 或 scoop,并显式提示需要 PowerShell 管理员权限。
  • 在用户选择以下任一处理方式之前,不得进入 S3:
    • 安装推荐工具后重跑预检;
    • 接受当前可读范围,标记缺失资料为 unreadable;
    • 用户手动补充内容(如手动粘贴关键截图文字、提供已转换文本)。
  • 预检结果必须写入 patent/repo-scout/readability-report.md,并在后续 repo-profile.json 与 recommendation-report.md 的"证据线索"小节里引用,方便用户第二次回看时知道哪些方向受可读性限制影响。
  • 违反:跳过预检直接扫描,或对不可读资料静默忽略 → 必须回退重做 S2。

子 agent 扫描

在 Claude Code 等支持子 agent 的环境中,仓库规模较大或目录较多时,可按目录或模块分派只读子 agent 并行扫描。子 agent 只能读取资料并返回结构化发现,不得写入 patent/repo-scout/,不得单独评分、排序或生成推荐报告。

子 agent 优先按目录或子模块分片,例如 src/、modules/、examples/、docs/、benchmark/ 等。避免多个子 agent 重复扫描同一目录。

每个目录扫描子 agent 返回结果时,再按以下字段归类发现:

  • 核心代码线索:算法、控制流程、数据处理、接口链路。
  • 文档线索:README、设计文档、技术交底、论文草稿。
  • 证据线索:benchmark、仿真结果、日志、图表。
  • 架构线索:模块关系、输入输出、执行平台、消息流。

主 agent 负责统一合并发现、应用权重、排序 Top-N,并生成 recommendation-report.md、direction-record.json 和 source-material-roles.json。

权重确认纪律

  • 必须在对话中呈现四维度权重表:技术创新性、证据完备性、保护价值、实施清晰度。
  • 默认权重见 references/evaluation-dimensions.md。
  • 必须提供多选题让用户确认或调整,例如“默认 / 更看重保护价值 / 更看重创新性 / 自定义”。
  • 用户未确认前不得开始扫描或评估。
  • 用户回复“默认”视为确认;回复具体比例则按用户比例更新。

澄清纪律

  • 扫描完成后不得直接输出最终推荐表,必须先逐问澄清。
  • 一次只问一个问题,不堆叠。
  • 至少完成 2 轮澄清问答后才能呈现 Top-N 评估结果。
  • 根据用户回答动态调整推荐排序和权重。
  • 不替用户拍板,只收敛到可选范围。
  • 违反:直接输出评估表而跳过澄清问答 → 必须回退重做 S3。

输出路径

  • patent/repo-scout/readability-report.md:资料可读性预检结果,含每类后缀的可读取程度、缺失维度、按当前操作系统给出的安装命令以及用户所选处理方式。
  • patent/repo-scout/repo-profile.json:扫描元数据。
  • patent/repo-scout/recommendation-report.md:推荐方向报告,含可复用打分和澄清依据。
  • patent/repo-scout/directions/<direction-slug>/direction-record.json:每个推荐方向的独立记录,包含方向摘要、评分、证据线索、候选核心资料和确认状态。Top-N 中所有方向都必须生成。
  • patent/repo-scout/directions/<direction-slug>/source-material-roles.json:该方向的资料角色清单。未被用户选中时可记录候选核心资料,但必须标记为待确认;用户确认后才可作为主线分析或编排器输入。

这些路径相对于用户项目根目录,禁止写入 skill 目录。

<direction-slug> 应基于方向名称生成,使用小写字母、数字和连字符;中文方向可使用简短英文含义或拼音。若同名已存在,追加 -2、-3 等后缀。

recommendation-report.md 中每个方向必须列出对应的 direction-record.json 和 source-material-roles.json 路径,便于用户第二次打开报告时直接选择其他方向。

下一步选择

S6 必须通过 AskUserQuestion 控件呈现两个选项,禁止只用纯文本列出:

  • 进入 cn-patent-domain-runtime:启动完整起草编排器(包含主线分析、现有技术检索、技术交底、正式稿起草、代理师审稿、DOCX 导出),并用对应方向的 patent/repo-scout/directions/<direction-slug>/source-material-roles.json 初始化资料角色。
  • 暂停:只保留扫描报告和各方向记录,不创建编排状态文件。

进入编排器前,必须先得到用户明确选择的 <direction-slug>;只有用户在 S6 选择该方向后,selected_direction 才可标记为 repo-scout-confirmed。不得因为已生成方向记录就自动创建 patent/<patent-slug>/state/patent-iteration-state.json。

用户在 AskUserQuestion 中选择「进入编排器」后,本 skill 不得直接调用 cn-patent-domain-runtime。必须先输出以下提示并停住,等用户手动 /compact 后重新触发编排器:

已选择进入完整起草编排器。当前会话上下文已较重,建议先执行 /compact 压缩上下文,然后重新调用 cn-patent-domain-runtime 继续完整起草。编排器会从 patent/repo-scout/directions/<direction-slug>/source-material-roles.json 读取方向和资料,不依赖扫描过程中的对话上下文,所以压缩不会丢失已确认的选择。

常见错误

  • 把扫描脚本的数值得分当作最终创新性判断 → 脚本只做初筛。
  • 跳过权重确认直接扫描 → 必须先等用户确认权重。
  • 跳过资料可读性预检直接扫描 → 必须在 S2 输出 readability-report.md 并让用户选择处理方式。
  • 对不可读资料静默忽略,不告知用户 → 必须列出具体文件和缺失维度。
  • 推荐安装命令时不区分操作系统(例如在 Windows 上给 apt-get)→ 必须按检测到的 OS / 包管理器组装命令。
  • 跳过澄清直接推荐最终方向 → 必须完成至少 2 轮澄清。
  • 只给用户选中的方向生成记录 → Top-N 所有方向都必须生成独立记录。
  • 多个方向共用一个 source-material-roles.json → 必须按方向保存,避免覆盖。
  • 让子 agent 写扫描报告或方向记录 → 子 agent 只读返回发现,主 agent 统一落盘。
  • S6 用纯文本列出选项让用户回复 → 必须通过 AskUserQuestion 控件呈现「进入编排器 / 暂停」两选。
  • 用户选「进入编排器」后直接调用 cn-patent-domain-runtime → 必须先输出 /compact 提示并停住,由用户手动压缩上下文后重新触发编排器。
  • 自动进入编排器或创建状态文件 → 必须等用户选择下一步。
  • 把代码注释当作技术效果证据 → 优先用实验数据、性能对比和明确实现。

参考资料

  • 评估维度与打分指引:references/evaluation-dimensions.md
  • 资料可读性与工具映射:references/material-readability.md
  • 交接规则:references/handoff.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.