Github 增速 Top5 业务解决方案推荐
将 Github Trending 24h 增速项目转成围绕业务项目与痛点的可落地解决方案。使用 WorkBuddy 当前模型完成匹配和分析；不得请求或配置任何外部模型 API Key。
工作模式
根据用户意图选择一个流程：
- 用户首次配置、修改项目或修改痛点：执行“配置流程”。
- 用户要求立即推荐、测试推荐或自动化任务触发：执行“推荐流程”。
- 用户询问如何设置定时任务：执行“自动化引导”。
- 用户要求测试机器人：执行“测试推送”，不得发送正式推荐。
脚本路径统一使用：
${CODEBUDDY_SKILL_DIR}/scripts/trending_tool.py
配置流程
1. 检查现有状态
运行：
python3 "${CODEBUDDY_SKILL_DIR}/scripts/trending_tool.py" status
若尚未配置，说明只需在 WorkBuddy 对话中回答问题，不需要打开网页或编辑文件。
2. 逐项收集信息
一次只问一个问题，按以下顺序收集：
负责人/填写人：可选；未填写时使用“项目负责人”。当前项目：可空。当前痛点：可空；与当前项目至少填写一个。预期目标：必填，优先追问可量化时间和结果。关注关键词：可选；允许中文、英文、逗号或换行。- 是否继续新增另一条业务上下文。
飞书 Webhook：首次配置必填；只接受https://open.feishu.cn/open-apis/bot/v2/hook/开头的机器人地址。
用户只给出一句模糊描述时，主动拆分并请用户确认。例如：
当前项目：游戏客户端性能优化
当前痛点：崩溃和卡顿定位依赖人工经验
预期目标：两周内找到能接入现有工具链的性能分析方案
关注关键词：profiling, crash, game engine
不得要求用户填写候选数量、TopN、推送时段、模型名称或模型 API Key。固定默认值为：
- Github 24h 增速候选：Top100
- 最终推荐：Top5
- 允许推送时间：09:00-21:00
- 推荐频率：WorkBuddy 自动化每 1 小时
- 分析模型：WorkBuddy 当前模型
3. 确认并保存
先以可读格式回显业务上下文，不回显完整 Webhook。用户确认后，将以下 JSON 写入临时文件：
{
"feishu_webhook": "用户提供的完整 Webhook",
"business_contexts": [
{
"owner_name": "负责人",
"current_project": "当前项目，可空",
"current_pain": "当前痛点，可空",
"expected_goal": "预期目标，必填",
"focus_keywords": ["关键词1", "关键词2"],
"enabled": true
}
]
}
保存时使用权限为 600 的临时文件，执行配置后立即删除：
mkdir -p "$HOME/.workbuddy/github-trending-business-radar"
chmod 700 "$HOME/.workbuddy/github-trending-business-radar"
chmod 600 "$HOME/.workbuddy/github-trending-business-radar/setup-input.json"
python3 "${CODEBUDDY_SKILL_DIR}/scripts/trending_tool.py" configure \
--input "$HOME/.workbuddy/github-trending-business-radar/setup-input.json"
rm -f "$HOME/.workbuddy/github-trending-business-radar/setup-input.json"
不得把 Webhook 写入自动化提示词、回复正文或日志摘要。
推荐流程
1. 准备候选
运行：
python3 "${CODEBUDDY_SKILL_DIR}/scripts/trending_tool.py" prepare \
> "$HOME/.workbuddy/github-trending-business-radar/candidates.json"
读取结果：
status=skipped：原样说明原因并停止，不抓取、不分析、不推送。status=error：说明错误并停止。status=ready：继续业务匹配。
2. 使用 WorkBuddy 当前模型分析
严格根据 business_contexts 和 candidates 选择最多 5 条，不调用其他模型接口。
匹配优先级：
- 预期目标命中度。
- 当前项目或当前痛点相关性。
- 两周内可试点的落地性。
- Github 24h 增速和技术成熟度。
每条输出必须包含：
{
"repo_name": "owner/repo",
"repo_url": "https://github.com/owner/repo",
"stars_today": 123,
"total_stars": 4567,
"context_id": "ctx_xxx",
"matched_project": "命中的当前项目",
"matched_pain": "命中的当前痛点",
"expected_goal": "对应预期目标",
"solution": "如何作为解决方案落地",
"business_reason": "AI分析(业务推荐)",
"action_draft": "给项目负责人的建议行动草稿",
"fit_score": 0
}
fit_score 必须是 0-100 整数。不得因为仓库热度高而虚构业务价值；没有合适项目时允许少于 5 条，完全没有合适项目时不推送。
3. 推送飞书
将推荐 JSON 数组写入权限为 600 的临时文件，然后执行：
chmod 600 "$HOME/.workbuddy/github-trending-business-radar/recommendations.json"
python3 "${CODEBUDDY_SKILL_DIR}/scripts/trending_tool.py" push \
--input "$HOME/.workbuddy/github-trending-business-radar/recommendations.json"
rm -f "$HOME/.workbuddy/github-trending-business-radar/recommendations.json"
推送成功后，只汇报推荐数量和执行时间。不得输出 Webhook。
自动化引导
引导用户在 WorkBuddy 的“自动化”中新建任务，并选择本技能。自动化提示词只需：
使用 github-trending-business-radar 技能执行一次 Github 增速 Top5 业务解决方案推荐。严格按技能的推荐流程运行；非 09:00-21:00 时直接结束，不抓取、不分析、不推送。
设置：
- 模型：用户希望使用的 WorkBuddy 模型。
- 权限：完全访问权限。
- 执行频率：按间隔，每 1 小时，周一至周日。
- 连接器：不需要选择；飞书 Webhook 由技能脚本发送。
- WorkBuddy 微信小程序推送：关闭，除非用户明确需要。
自动化只负责调度本技能。不得在提示词中放项目、痛点、Webhook 或 API Key；这些信息由配置流程维护。
测试推送
测试前确认配置存在。构造一条明确标注“测试”的样例推荐并通过 push 命令发送。发送属于外部消息操作，执行前必须向用户确认。
安全要求
- 永远不显示、复述或记录完整飞书 Webhook。
- 永远不要求模型 API URL、模型 API Key 或 Github Token。
- 不自动创建飞书待办。
- 不在 09:00-21:00 之外抓取或推送。
- 不调用配置页、本地 Web 服务或其他 Agent 调度器。
- 只让 bundled script 执行抓取、配置校验和 Webhook 发送；业务判断由 WorkBuddy 当前模型完成。
