SuperAPI AI 工具集

project-status-report

编程与开发

查看项目

更新于 10-15 16:49

技能介绍

用途:为开发者快速上手提供全面的项目健康与状态报告,帮助在开始会话、中途检查项目健康、切换上下文或在重大变更前了解当前状态。

主要能力:按优先级输出报告。健康指标(测试通过/失败、lint 错误、覆盖率、构建状态、来自 claude-context-manager 的上下文健康);Git 状态(当前分支、未提交变更、与远程同步状态、近期活跃分支);最近会话(上次检查点摘要、已完成内容、上次中断位置);开放工作项(会话目标、代码中的 TODO 与 FIXME);待办积压(已配置的规划特性、技术债务项);AI 建议(基于项目状态推荐下一步操作、工作量估算与优先级指导)。输出为 Markdown,按优先级分节,便于快速浏览。

使用方式:可独立运行 python scripts/report.py;在 Claude Code 中使用 /project-report;也可编程调用:from report import ReportGenerator; generator = ReportGenerator(); report = generator.generate(); print(report)。

集成与配置:被 session-management 在 /session-start 时自动调用以提供上手上下文,也可独立作为工具使用。无需配置,自动检测 Git 仓库、测试框架(pytest)、会话状态(.sessions/ 目录)和 CCMP 插件状态(.ccmp/state.json)。

适用场景:随时需要项目概览时运行 /project-report;开始新工作前检查健康指标;切换上下文后回到项目的第一条命令;为交接或状态更新生成报告分享给团队。

限制:资料未提供价格、收费、平台兼容性及其他未述明事项。