# Project Health Report Skill

📖 简介

这是一个为 GitLink 平台设计的AI Agent Skill，能够自动分析指定仓库的健康状况并生成详细报告。

✨ 功能特性

• 多维度数据采集: 自动获取Issue、PR、贡献者等多维度数据。
• 核心指标计算: 计算Issue响应时间、PR合并效率、社区活跃度等关键指标。
• 智能报告生成: 生成结构清晰的Markdown报告，并附带改进建议。
• 跨平台通知 (可选): 支持将报告摘要推送到飞书/钉钉群。

🛠️ 安装与配置

1. 克隆本仓库。
2. 安装依赖: 确保已安装 gitlink-cli 和 Python 3。
3. 配置 gitlink-cli: 运行 gitlink-cli config init。

🚀 使用方法

在支持的AI Agent (如Cursor, Claude Code)中，输入以下指令： “请使用 project-health-report 技能，生成 Gitlink/gitlink-cli 仓库的健康度报告。”

📊 报告示例

（运行脚本后生成的报告截图）

🤝 贡献

欢迎提交Issue和PR！

📄 许可证

MulanPSL-2.0

🚀 使用示例

在终端中直接运行

python scripts/calc_health.py --issues tmp/clean_issues.json --prs tmp/clean_prs.json --contributors tmp/clean_contributors.json --output tmp/final_report.md

在 AI Agent 中调用（模拟）

将 SKILL.md 加载到支持 Skills 的 Agent（如 OpenCode、Cursor）中，然后输入：

请使用 project-health-report 技能，生成健康度报告。

✅ 已在 DeepSeek AI 上完成 Skill 的可执行性模拟验证，AI 能正确理解并规划执行步骤。 Agent 将按照 SKILL.md 定义的步骤自动执行。 =======

project-health-report-skill

212ca55f99734e5138d8d5fca8b1456af2e73c83