Agent Skills
返回列表
开源项目逻辑分析器

开源项目逻辑分析器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f5ff1e4f/open-source-logic-analyzer。

技能介绍

你真正缺的是什么

很多人接到「帮我看看这个项目」时,会先 ls 一圈、贴几张目录截图,最后变成文件清单复读。好的分析要能回答三件事:作者为什么这么设计、历史上踩了什么坑、你能带走哪几条逻辑——而不是把源码复制进对话。

技能如何组织分析

本技能按 6 个 Phase 推进(完整步骤见技能内 references/phase0-6-workflow.md),并强调「按需深入」:

  • 全局印象:目录结构、依赖清单(package.json / requirements.txt / go.mod)、入口文件(main.py、app.py、index.js 等)
  • 分层研读:按模块读核心路径;读不懂的块标注「未确定」,不写臆测
  • 结构化输出:使用报告模板存档,并可参考技能内 examples/rag-analysis-report.md 等示例

触发场景包括:发来 GitHub / Gitee / 任意 git 链接、对比两个项目优劣、或表达「想参考 XX 重做」。若仓库在国内访问困难,技能指引先查镜像与 references/common-traps.md 中的方案。项目过大时,优先分析登录、搜索、问答等核心功能,其余模块快速扫过。

边界与红线

  • 在独立目录 clone,不污染用户原有工程
  • 禁止臆造未读到的逻辑;必须产出可留存的技术报告(UTF-8,避免硬编码绝对路径)
  • 若下一步要做「更好的版本」,分析中的 ✅/🔧/❌ 标记可与 project-essence-refiner 衔接,把借鉴点转成可执行改造清单

使用场景

  • 评审前收到竞品 GitHub 链接,需要在不改代码的前提下梳理模块边界与入口调用链
  • 团队讨论是否借鉴某 RAG 开源实现,要先写清其检索链路与设计取舍再开会
  • 同时维护两个相似项目,要用同一套维度对比分层、依赖与可维护性风险
  • 朋友发来 Gitee 仓库让你帮忙看坑,需产出可存档的结构化分析报告而非聊天摘要

适合人员

  • 计划在两个月内 fork 某 Python 后端库的后端工程师,想先弄清扩展点与历史坑再动手改
  • 写技术选型 memo 的全栈开发者,需要把陌生仓库的依赖图和核心目录讲给评审同事听
  • 创业公司技术负责人评估竞品开源组件,要判断能否长期跟进上游与安全维护成本
  • 准备参考知名项目重做内部工具的产品工程师,需要提炼可迁移逻辑而不是抄文件结构