project-maturity

# Project Maturity Scanner 对任意项目进行 8 维度深度成熟度扫描，产出结构化 Markdown 报告。 --- ## 工作流概览 ``` 语言检测 → 加载 Reference → 并行收集 8 维度数据 → 综合评分 → 输出报告 ``` 三个核心原则： 1. **用数据说话，不做主观猜测** — 每个评分背后都有可复现的命令和数据 2. **先收集后评分** — 禁止在信息不全时下结论 3. **风险优先** — 高风险项放在报告最前面，方便读者优先关注 --- ## Step 1: 语言检测与 Reference 加载 ### 1.1 自动检测 扫描项目根目录，按优先级判断主语言： | 信号 | 判定 | |------|------| | `Cargo.toml` | Rust | | `package.json` + `tsconfig.json` | TypeScript | | `package.json`（无 tsconfig） | JavaScript/Node | | `go.mod` | Go | | `pyproject.toml` / `setup.py` / `requirements.txt` | Python | | `pom.xml` / `build.gradle` | Java/Kotlin | | `Gemfile` | Ruby | | `CMakeLists.txt` | C/C++ | | 以上皆无 | Generic（通用检查） | 多语言项目：按代码量占比识别主语言和次语言，报告中对每种语言分别评估。 ### 1.2 加载语言 Reference 根据检测结果，读对应 reference 文件获取语言特定的检查命令和指标： - `references/rust.md` — Rust 项目 - `references/typescript.md` — TypeScript/JavaScript 项目 - `references/python.md` — Python 项目 - `references/go.md` — Go 项目 - `references/generic.md` — 通用回退 Reference 文件包含的内容： - 该语言的代码统计命令 - 测试框架识别与运行命令 - 静态分析/lint 工具 - 依赖审计工具 - 语言特定的成熟度阈值 --- ## Step 2: 并行收集 8 维度数据 **关键**：所有收集操作必须并行执行。不要串行逐个询问。 ### 维度 1：项目规模 用语言 reference 提供的命令统计： ``` ✅ 源代码行数（排除依赖/target/node_modules/build） ✅ 源文件数量 ✅ 模块/包/crate 数量 ✅ 各模块代码分布（最大的 5 个模块） ✅ 按语言拆分的代码量（多语言项目） ``` 评价标准： - 小型 < 5,000 行 | 中型 5k-50k | 大型 50k-200k | 超大型 > 200k - 模块化程度 = 模块数量是否与代码规模匹配 ### 维度 2：开发活跃度 ``` ✅ 总提交数 + 首次/最后提交日期 ✅ 近 30 天提交趋势（每日统计） ✅ 贡献者数量 + Top 3 贡献者占比（识别总线因子） ✅ 活跃分支数 + 标签数 ✅ 版本标签命名规范度 ✅ 合并提交比例（反映协作模式） ``` 评价标准： - 近 30 天日均提...