飞书项目工具

飞书项目底层能力入口，供用户直接使用，也供上层 skill（如 feishu-workitem、feishu-schedule-assistant）调用。

能力边界

• 做：查、改、流转、创建、评论、获取元信息。
• 不做：需求分析结论、方案评审、估时策略。

脚本

• 查询脚本：$SKILL_DIR/feishu-project-tool/scripts/query_issue.py
• 排期/流转脚本：$SKILL_DIR/feishu-project-tool/scripts/schedule_cli.py

$SKILL_DIR 默认为 ~/.codex/skills

A. 工作项查询

查询飞书项目工作项信息，支持工单（issue）、迭代需求（story）和任务（task）。

使用方式

必须使用脚本 scripts/query_issue.py，不要使用 curl。

# 方式1：使用完整 URL（精确查询）
python $SKILL_DIR/feishu-project-tool/scripts/query_issue.py https://project.feishu.cn/weplay-fra/issue/detail/6686747751

# 方式2：只输入 ID（自动遍历查询）
python $SKILL_DIR/feishu-project-tool/scripts/query_issue.py 6682511344

# 方式3：指定 key + type 精确查询（推荐，最高效）
python $SKILL_DIR/feishu-project-tool/scripts/query_issue.py 6686747751 --key fra --type issue
python $SKILL_DIR/feishu-project-tool/scripts/query_issue.py 6669175215 --key weplay --type story

支持 project_key:type:id 格式

当用户输入 project_key:type:id（如 65a895e8cf7a6cd96951363b:issue:6669883493）时，先把 project_key 转为 --key 再调用查询脚本。

Project Key	Namespace Key	说明
65a895e8cf7a6cd96951363b	weplay	WepLay 客服
657949d8fe5d48e32035accc	wejoy	会玩 客服
67d17044af5c92106895411b	bigr	WePlay 大R 客服工单
65897e1d88801bb00421a552	fra	阿语服/中东
66d9810692fb20f8d99b4a59	jk	JK (Jackaroo)
6579ad56a15a38cbfd579067	tky	日韩
6579926ffe5d48e32035acdf	sc	后台风控
6582b0027e6dc00b463f8793	sgp	亚太
656f1f28b8a053b9e62e25fd	sv	欧美
691488e33b89dd94a6cb4431	tech	技术中台
68b0097a615c606d315c3b02	cultivation	修仙
65796f470710f8b6b1b38144	desertsafari	如来
656055657de066787879dd0f	huiwan	会玩
69cddfa3d9f9558b9dca4a74	d42vtw	刘森

支持的命名空间（--key）

Key	说明	URL Slug
weplay	WepLay 客服	weplay-userfeedback
wejoy	会玩 客服	huiwan-feedback
bigr	大R 客服工单	weplay-drticket
fra	阿语服/中东	weplay-fra
jk	JK (Jackaroo)	jackaroo
tky	日韩	weplay-kj
sc	后台风控	weplay-sc
sgp	亚太	weplay-sgp
sv	欧美	weplay-sv
tech	技术中台	weplay-tech
cultivation	修仙	cultivation
desertsafari	如来空间	desertsafari
huiwan	会玩	huiwan
test	测试	-
d42vtw	刘森	-

首次使用

# 查询能力依赖
pip install -r $SKILL_DIR/feishu-project-tool/scripts/requirements.txt

# 排期/流转能力依赖（按需）
pip install -r $SKILL_DIR/feishu-project-tool/scripts/requirements_schedule.txt

支持的 URL 格式

• 带前缀：https://project.feishu.cn/weplay-fra/issue/detail/xxx
• 不带前缀：https://project.feishu.cn/jackaroo/issue/detail/xxx
• 工单：URL 包含 /issue/
• 迭代需求：URL 包含 /story/
• 任务：URL 包含 /task/

输出示例

{
  "code": 0,
  "data": {
    "id": 6685363013,
    "name": "【前端】新增自定义字段时建议添加示例",
    "description": "[图片]\\n",
    "created_by": "黄奎"
  },
  "_namespace": "sc",
  "_work_item_type": "issue",
  "_url": "https://project.feishu.cn/weplay-sc/issue/detail/6685363013"
}

查询场景

• "查询工作项 6682511344"
• "帮我看看这个工单的详情"
• "查询迭代需求 6669175215"
• "帮我查一下 65a895e8cf7a6cd96951363b:issue:6669883493"
• "查询 fra 的 issue 6686747751"

B. 排期管理（来自 schedule-manager 能力）

1) 查看排期

python $SKILL_DIR/feishu-project-tool/scripts/schedule_cli.py get <url> [--detail] [--from <节点>] [--to <节点>] [--json]

2) 查看详情

python $SKILL_DIR/feishu-project-tool/scripts/schedule_cli.py detail <url> [--workflow] [--json]

3) 更新节点排期/负责人

python $SKILL_DIR/feishu-project-tool/scripts/schedule_cli.py update <url> --node <节点> [--start <YYYY-MM-DD>] [--end <YYYY-MM-DD>] [--owner <user_key>]

4) 流转到目标节点

python $SKILL_DIR/feishu-project-tool/scripts/schedule_cli.py flow <url> --to <目标节点>

5) 创建工作项

python $SKILL_DIR/feishu-project-tool/scripts/schedule_cli.py create --project <项目> --type story|issue --name <标题>

6) 添加评论

python $SKILL_DIR/feishu-project-tool/scripts/schedule_cli.py comment <url> --content <评论内容>

7) 查看类型元信息

python $SKILL_DIR/feishu-project-tool/scripts/schedule_cli.py meta --project <项目> --type story|issue|task [--json]

输入规范

优先按以下顺序解析工作项定位：

1. 完整 URL
2. project_key:type:id
3. id + --key + --type
4. 仅 ID（必要时再补充 key/type）

输出规范

统一返回：

• status: 成功/失败
• summary: 一句话结果
• data: 关键字段或执行结果
• errors: 失败明细（若有）
• next_actions: 可执行下一步（若有）