用途:该技能是 EasyYapi 内置规则编写智能体的外部镜像,帮助用户编写或修改 EasyYapi 规则文件(.easyapi/ 下的 .rules / .properties 文件)。这些规则被 EasyYapi IntelliJ 插件读取,用于定制 API 导出(YApi/Postman/Markdown)、字段命名、注解等。
主要能力:运行与内置智能体相同的“感知→推理→执行”循环,暴露相同的能力面:相同的规则指南与键目录,以及每个内置感知工具的 CLI 等价物。区别在于交付方式——内置智能体调用 IntelliJ PSI 工具,本技能通过读取文件和搜索代码库实现。
使用方式:当用户打开或编辑项目 .easyapi/ 或全局 ~/.easyapi/ 中的文件,或请求添加规则、重命名字段、忽略类、为每个 POST 添加请求头等时调用。先阅读随附知识库(docs/、ai/detection/、ai/key-guides/、rule-keys.md、rule-contexts.md 等),再动手编写。可用 ./gradlew syncSkill 刷新全部镜像。CLI 脚本包括 scripts/list_rule_files.sh、scripts/read_rule_file.sh、scripts/get_existing_rules_for_key.sh、scripts/get_detection_prompt.sh、scripts/get_key_guide.sh、scripts/get_key_context.sh、scripts/list_detections.sh 等。
适用场景:编写或修改 EasyYapi 规则、排查已有规则、为特定规则键编写 Groovy 脚本值。
限制:list_project_endpoints 无 CLI 等价物,需要 IntelliJ 的 ApiIndex 缓存;不要发明 rule-keys.md 目录中不存在的键,未知键会被插件静默忽略;生成文件(rule-keys.、rule-contexts.、tools.md、locales.md、extensions.md)不得手动编辑。