飞书项目工具

飞书项目底层能力入口，供用户直接使用，也供上层 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	会玩

支持的命名空间（--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	测试	-

首次使用

# 查询能力依赖
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: 可执行下一步（若有）