开源项目› 项目体检台› 概览
概览 · 01

项目体检台 RecoScan

约 2 分钟阅读 Apache-2.0 本文基于 v0.1.0(2026-11-01)

周会前一小时,老板问「这个项目现在什么情况」,你翻了三块看板、两个表格、一堆聊天记录,最后给了一句「还行」。

RecoScan 要解决的是这一下:按一个按钮,出一张体检表——这个项目下周大概率在哪三件事上出事,每件后头跟一句「先做哪个」。

01体检是诊断,推荐是处方

这两件事分开做,用户只会买其中一个;合成一件才成立:

  • 诊断:按指标算出这个项目现在几处不通——承诺的没兑现、卡在谁那里卡了多久、有没有依赖一直没闭合、会上拍板的事有没有落成任务。
  • 处方:把每条风险映射成一个动作,告诉你先动哪一个。不是给一张打分的表让你自己琢磨。

02开箱就能算的五个指标

  • 承诺兑现率
  • 阻塞时长
  • 依赖未闭合
  • 决策未落任务
  • 变更密度

每个都是纯函数:给定输入数据,结果可复现、可单测,不依赖任何模型。三档粗阈值决定「正常 / 注意 / 出事」。

03它不做什么

  • 不做跨项目组合视角。 一次看一个项目,这是刻意的边界。
  • 不做根因推断和风险预测。 它给的是「哪里不通」和「先动哪个」,不是「为什么会这样」。
  • 不用行业基线阈值。 阈值默认是通用三档,你的团队更看重什么,自己改权重。
  • 不自动从会议和知识库里抽数据。 数据怎么进来是你喂的事:check.analyze 认项目台账(JSON 数组或 CSV 文本),体检结果输出为标准 findings.json,可直接进 CI 或周报。

04你的调优也在文件里

指标权重、风险阈值、抽取参数——都写在 packs/project/rules.example.yaml(示例权重即引擎默认口径,全字段中文注释),改完用 rules.validate 校验,能导出、能版本化、能换给别人用。

05现在到哪一步

v0.1.0 已正式开源(2026-11-01,GitHub 仓库公开):体检面是纯函数引擎(core/js/,仅 Node.js 内置模块),经 stdio MCP 服务器接入,零联网、零第三方依赖;check.analyze / plan.suggest / rules.validate 三个工具随 v0.1.0 一并上线。

← 上一篇已是第一篇