czz-project-analyzer 用于对开源项目进行系统化分析并输出结构化报告,适合在用户要求“分析、评审、评估”某个项目、理解代码库架构、获取项目报告或改进建议时使用。
主要能力:按 12 个主题顺序分析——项目基本信息(语言、文件数、结构)、项目结构(目录与模块关系)、技术栈(依赖与框架)、核心功能(含时序图)、架构设计(含架构图)、代码质量(风格、测试、复杂度)、文档质量(README、API 文档、指南)、项目活跃度(提交、issue、PR,需 git 可用)、优缺点、适用场景、学习价值与总结。对复杂项目可启用深度分析模式,追加源码深潜、实现机制、组件分析、协议与接口分析、工作流追踪、安全分析、性能分析、测试策略分析。图表使用 Mermaid,并按技能内语法规则生成(节点标签加引号、避免保留字、decision 节点用 {条件?} 等)。
使用方式:支持本地目录(如 ~/work/my-project、.、相对或绝对路径)为主,也支持远程 GitHub 仓库(owner/repo、Git URL),远程通过 gh api 或 git clone 收集信息,本地通过文件系统、README、配置文件和构建脚本收集。分析时先做重复检查:若输出目录 ~/ai/code-analysi/{project-name}/ 或 registry.ts 中已有该项目,需让用户选择跳过、查看、追加或重新分析(重新分析需明确确认)。随后读取模板、创建 topics 子目录与 analysis-todo.md,逐主题生成文档并更新 registry.ts,最后重建站点:cd ~/ai/code-analysi/site && bun run build,站点不存在时先用 /docs-site ~/ai/code-analysi --multi 初始化。
限制:远程分析依赖 gh 或 git 与网络;项目活跃度需要 git 历史;registry.ts 的导入必须使用 ?url 而非 ?raw;各主题文档须按模板与 Mermaid 语法规则生成;具体收费、价格与更详细的平台支持信息暂未提供。