SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场semantic-slicing

semantic-slicing

编程与开发

查看项目

更新于 10-16 03:34

技能介绍

用途

Semantic Slicing 的目标是把一个大型仓库转化为带有证据的可审查语义切片。它把代码形态、威胁候选、issue 聚类和支持讨论结合起来，使审查预算落在系统中最需要关注的部分。

默认立场是：先本地映射，再排序，最后才花费智能体/安全审查预算。

主要能力

  • 组合 clawpatch 功能地图、deepsec 威胁候选、可视化审查地图，以及可选的 gitcrawl/discrawl 证据。
  • 生成机器可读的语义地图（默认输出到 stdout），并在需要时保留 HTML 和 JSON。
  • 提供人类审查泳道、焦点控制、智能体交接包，以及按视角排序的下一步命令与成本规模理由。
  • 支持稀疏模式（默认开启），省略 dotfile/配置树、文档、变更日志文件和移动应用树，使核心审查保持聚焦。
  • 支持通过 --no-sparse 或 --sparse false 处理完整仓库，并用 --sparse-exclude <csv> 和 --sparse-include <csv> 调整过滤。

使用方式

工作流大致如下：

  1. 复用合适的工具状态；仅在工具需要文件时创建任务专属的临时存储。
  2. 扫描前先读取目标仓库说明。对 OpenClaw，读取根目录 AGENTS.md；审查某个切片时子树指南也很重要。
  3. 验证工具安装：
    • clawpatch：克隆/构建 openclaw/clawpatch，然后运行 clawpatch init、clawpatch map、clawpatch status。
    • deepsec：克隆/构建 vercel-labs/deepsec，搭建临时工作区，然后运行 deepsec scan。
    • gitcrawl：运行 gitcrawl doctor --json，然后拉取相关 issue 证据的聚类/线程。
    • discrawl：运行 discrawl doctor --json 和 discrawl status --json；仅在支持讨论相关时使用 search/digest。
  4. 在 AI 审查之前运行确定性地图：
    • Clawpatch 功能地图，用于入口点/包/配置/测试切片。
    • Deepsec 正则扫描，用于候选威胁面。
    • 可选的仓库 git 叠加层，用于 CODEOWNERS 路由、跟踪文件、代码/测试/文档形态以及近期变更。
    • 可选的 gitcrawl/discrawl 查询，用于同一文件、组件或症状的历史痛点。
  5. 运行 scripts/semantic-map.mjs 将证据合并为 JSON 输出到 stdout。
  6. 为智能体检查选择有界字段。默认不保存中间输出。
  7. 仅在需要交付物或必需证据时使用 --out <path>；它默认保留 HTML 和 JSON。
  8. 使用 --format html|json|both 选择输出格式。单一格式只写入确切的 --out 路径。
  9. 当请求可视化看板时，按产品顺序审查：先审查泳道（语义形态、所有权路由、开发压力、安全压力、issue 压力、支持压力），其次是焦点控制（缩小矩阵而不重复行的镜头和系统过滤器），第三是整体镜头矩阵（单一切片行表格，带有语义、所有权、开发、安全、issue 和支持镜头的可比条），第四是智能体交接包（供后续智能体使用的紧凑 JSON），最后是证据表（用于审计的原始叠加层，不是主要阅读路径）。
  10. 在运行 AI 阶段之前选择成本规模：
    • low：仅确定性地图；不运行 deepsec 进程或真实 clawpatch 审查。
    • medium：一到三个明确文件/功能，使用高风险 slug，批量大小 1，并发 1，并设置轮次上限。
    • high：更广泛的 AI 处理或多个功能审查；需要明确的预算/时间决策。
  11. 仅在所选规模下运行 AI：
    • clawpatch review --feature <id> 或较小的 --limit。
    • deepsec process --files <csv> 或严格限定的 --filter 加 --only-slugs。
  12. 在聊天中报告保留路径、运行 ID、计数、成本规模、排除项和跳过的昂贵阶段。
  13. 仅在不再需要或不再使用时移除任务专属的一次性临时文件。保留命名交付物和恢复证据。

输入

  • target_repo：本地检出路径和/或 GitHub owner/repo。
  • scratch_root：可选的、任务专属的临时目录，供需要物理状态的工具使用。
  • out：可选的请求交付物或必需证据路径。省略则输出到 stdout。
  • format：html、json 或 both。默认：无 out 时为 json，否则为 both。
  • clawpatch_repo：openclaw/clawpatch 的本地克隆；如果 clawpatch 已在 PATH 中则可选。
  • deepsec_repo：vercel-labs/deepsec 的本地克隆；如果 deepsec 已在 PATH 中则可选。
  • focus：可选的路径前缀、issue 编号、slug、组件或频道，用于优先处理。
  • sparse：可选的地图过滤器，默认 true；除非配置，否则排除 dotfile/配置、文档/变更日志和移动应用路径。
  • cost_size：low、medium 或 high；默认 low。
  • budget_mode：map-only、targeted-ai 或 full-ai；默认跟随 cost_size。

输出

  • 工具安装状态和阻塞项列表。
  • Clawpatch 功能计数和污染检查。
  • Deepsec 扫描运行 ID、候选计数、顶级 slug 和顶级文件。
  • 可选的仓库叠加层（来自 --repo）：CODEOWNERS 路由、跟踪文件、代码/测试/文档形态、90 天变更和测试缺口压力。
  • 可选的 gitcrawl 聚类/线程证据和 discrawl 支持证据。
  • 默认在 stdout 输出机器可读的语义地图。仅在请求时保留 HTML 和 JSON。
  • 干净的语义桶、所有权叠加层、开发叠加层、安全叠加层、issue 叠加层、支持叠加层和规范化队列。
  • 人类审查泳道、焦点控制、智能体交接包，以及按视角排序的下一步命令与成本规模理由。

适用场景

  • 对目标仓库设置或运行 openclaw/clawpatch。
  • 对目标仓库设置或运行 vercel-labs/deepsec。
  • 生成功能切片、风险文件、所有权聚类或审查目标的本地可视化地图。
  • 用 gitcrawl 的 issue/PR 数据或 discrawl 的 Discord/支持数据交叉核对代码切片。
  • 为大型仓库规划聚焦的安全、回归、架构或维护者审查。

限制与护栏

  • 除非用户明确希望提交配置，否则将生成的产物保持在目标仓库之外。
  • 没有明确的高成本决策，不要运行完整的 deepsec 进程或广泛的 clawpatch 审查；这些可能昂贵且嘈杂。
  • 除非有意纳入范围，否则将本地嵌套工作树和 dot-agent 文件夹视为污染：.claude/、.codex/、.agents/、.deepsec/、.semantic-slicing/。
  • 如果工具映射了受污染路径，在排序前进行后过滤，并指出上游限制。
  • 切勿粘贴扫描输出中的机密。在外部 PR/评论前清除绝对个人路径。
  • 对 OpenClaw，仅当任务从映射进入验证时才使用 Testbox/Crabbox。

参考资料

  • 阅读 references/workflow.md 获取具体的本地设置和运行命令。
  • 选择切片类型或地图层时阅读 references/slicing-taxonomy.md。
  • 当目标是 openclaw/openclaw 时阅读 references/openclaw-profile.md。