Taskbot-MVP README

The project's README from github.com/justDance-everybody/Taskbot-MVP. As one markdown file: README.md.

Taskbot-MVP 🤖

一个智能的飞书任务分配机器人 —— 让远程兼职任务管理从"手工分派"变为"10秒自动匹配"。

Tests


✨ 它能做什么?

想象一下,你不再需要在聊天记录里翻找候选人简历、手动催进度、重复验收作业——Taskbot 帮你:

核心价值:让 HR 和任务协调者把时间花在战略性工作上,而不是重复劳动。


🚀 快速开始

前置要求

5 分钟本地运行

# 1. 克隆项目
git clone https://github.com/justDance-everybody/Taskbot-MVP.git
cd Taskbot-MVP

# 2. 配置环境变量(参考 docs/task_bot_mvp_运行与环境配置.md)
cp .env.example .env
# 填入飞书 APP_ID、APP_SECRET、VERIFY_TOKEN 和至少一个模型密钥

# 3. 启动服务
docker-compose up -d

# 4. 使用 Ngrok 暴露公网地址
ngrok http 8000
# 将生成的 https://xxx.ngrok.io/webhook/feishu 填入飞书事件订阅 URL

# 5. 验证:在飞书群里 @机器人 ping

看到 pong 回复?恭喜,你已经跑通了!🎉


📖 核心功能演示

1️⃣ 智能候选人匹配

HR: @bot 新任务: 开发 React 登录页
Bot: 请描述任务内容...
HR: 需要暗黑模式适配
Bot: 验收标准是...
HR: 通过 UI 测试
Bot: 推荐以下候选人:
     ✅ 张三 - React 经验 3 年,可用时间充足
     ✅ 李四 - 熟悉 Tailwind,最近表现优秀
     [选择] [取消]

2️⃣ 简历自动解析

HR: [上传 resume.pdf]
Bot: ✅ 已解析候选人信息:
     姓名:王五
     技能:Python, Django, PostgreSQL
     可用时长:15 小时/周
     已添加到候选人库

3️⃣ 自动验收 & 提醒


🏗️ 技术架构

FastAPI (Bot 服务)
    ├── 飞书 Webhook (消息、卡片、群管理)
    ├── 多维表格 API (任务表、候选人表)
    ├── LLM Router (DeepSeek/Gemini/OpenAI)
    └── GitHub Webhook (CI 状态监听)

核心技术栈:Python 3.11+, FastAPI, Larksuite SDK, Docker


📚 完整文档

项目包含详尽的文档,帮助你快速上手或深度定制:


🤝 参与贡献

我们欢迎所有形式的贡献!无论你是:

贡献流程

# 1. Fork 并克隆项目
git clone https://github.com/YOUR_USERNAME/Taskbot-MVP.git

# 2. 创建功能分支
git checkout -b feature/your-feature

# 3. 开发与测试
make test  # 确保测试通过

# 4. 提交 PR
# 请在 PR 描述中说明改动目的和测试结果

开发指南:


🛣️ Roadmap

查看 Issues 了解正在开发的功能。


📄 许可证

本项目采用 MIT License 开源协议。


💬 联系我们


如果这个项目对你有帮助,别忘了给个 ⭐️ Star!

Taskbot-MVP (justDance-everybody/Taskbot-MVP)

Searching Database…

What is this?Taskbot-MVP is a Feishu (Lark) chat bot that automates assigning remote freelance tasks: it matches candidates to a task, lets you assign with one click, and checks/accepts the work automatically.
Is this a standalone chat bot or a library I import?It is a standalone backend service (FastAPI app using the Larksuite SDK) that runs via Docker and talks to Feishu, not a library you import into your own code.
How do I get it running?Set up a Feishu enterprise app with developer access, then run it locally with Docker and Docker Compose; the README says you should get a 'pong' reply within about 5 minutes once it's up.
Do I need a Feishu account and an LLM API key?Yes: you need a Feishu (Lark) enterprise account with developer permissions, Docker and Docker Compose, and at least one LLM API key (DeepSeek, Gemini, or OpenAI) for candidate matching and grading.
How reliable is the automatic grading and acceptance?Code tasks are accepted by checking GitHub PR CI status, while document tasks are graded by an LLM and pass only if the score is 80 or above, so acceptance quality depends on CI setup and LLM scoring accuracy.
Who is this built for?It's aimed at HR staff and task coordinators who manage remote/part-time contributors and want to spend less time manually chasing progress and reviewing submissions.
How does candidate matching work?Resumes uploaded as PDFs are automatically parsed into the system, and the LLM recommends the top 2 most suitable candidates along with its reasoning for the match.
What happens automatically while a task is in progress?Once a task is past the halfway point of its deadline, the bot automatically @-mentions the assignee and HR as a reminder, cutting down manual follow-up by about 50 percent.
Can I see stats on how tasks are going?Yes, a #report command shows daily task statistics such as the number of tasks and average time to assignment.
What's on the roadmap?Planned features include splitting tasks for multi-person collaboration, historical performance analytics, and multi-tenant SaaS support; task creation/matching, resume parsing, reminders, and auto-acceptance are already done.
Size
0.7 MB
Stars
82
Updated
CommitNov 14
Age
1y
Commits · 90 Days