SuperAPI AI 工具集

create-evlog-map-rule

智能体与模型

查看项目

更新于 10-15 21:39

技能介绍

用途:扩展 @evlog/cli 中 evlog map 的覆盖率扫描能力,分两类:新增规则(常见,位于 packages/cli/src/lib/map/rules/),或新增框架适配器(较少且较重,位于 packages/cli/src/lib/map/adapters/)。

主要能力:规则需先判定为 requirement 还是 opportunity。requirement 失败时影响评分,可触发 CI 门禁(--min-score、--baseline),出现在报告的 FIX FIRST / THEN;opportunity 无权重,只在项目已使用该特性(appliesTo.when 基于 project.features / project.pairable)时出现,出现在 GOING FURTHER。规则文件导出一个满足 MapRule 的常量,包含 id、category、title、expects、question、weight(仅 requirement)、docs、fixSlot、appliesTo、suggest、create。优先读取 FileFacts 与 onEnd,减少 AST 监听。

使用方式:按检查清单改 8 处接触点——规则源文件、rules/index.ts 注册表、types.ts 的 CheckId 联合、test/map/rules.test.ts 用例、3.rules.md、4.scoring.md(仅 requirement)、code-review.md、.changeset。测试用 runRuleSet 隔离验证,命令:pnpm --filter @evlog/cli exec vitest run test/map/rules.test.ts。验证命令:pnpm --filter @evlog/cli run lint、run typecheck、run test,并用 pnpm cli:sandbox(--reset、--smoke)在真实项目检查。

适用场景:为 evlog map 增加入口点检查项或支持新框架。限制:规则 id 是抑制目标(evlog-map-disable {id})与 evlog.map.json 公开契约的一部分,改名属破坏性变更;权重需结合 score.ts 现有分布讨论,不自行设定先例;opportunity 不得设权重。框架适配器涉及路由发现与能力声明,并需同步更新文档与多份 SKILL.md。具体 PR 标题、变更集等以官方资料为准。