飞书工单处理

面向业务分析的上层 skill。负责“理解工单并给建议”，不重复实现飞书底层接口。

依赖

• 必须使用：feishu-project-tool
• 通过 feishu-project-tool 获取工单详情、必要时回写结果

使用方式

/feishu-workitem <project_key>:<type>:<id> [用户问题]

参数说明：

• project_key: 飞书项目 ID（如 65897e1d88801bb00421a552）
• type: 工单类型（issue / story / task）
• id: 工单 ID
• 用户问题: 可选，为空时使用该类型默认分析方式

示例：

/feishu-workitem 65897e1d88801bb00421a552:story:6775818994
/feishu-workitem 65897e1d88801bb00421a552:issue:6686747751 这个问题影响范围有多大？
/feishu-workitem 66d9810692fb20f8d99b4a59:task:6682511344 这个任务的风险点有哪些？

执行流程

1) 解析输入并获取工单详情

解析 project_key:type:id，根据 project_key 映射 namespace key，然后调用：

python $SKILL_DIR/feishu-project-tool/scripts/query_issue.py <id> --key <namespace_key> --type <type>

$SKILL_DIR 默认为 ~/.codex/skills

Project 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	修仙

2) 按类型选择分析模板

Issue（工单/Bug）默认模板

1. 现象总结：一句话总结问题现象
2. 原因分析：分析出现这个现象的原因
3. Bug 判定：说明是不是 Bug
4. 复现场景：描述如何复现
5. 修改方案（仅 Bug）：具体改动方案
6. 验证方法（仅 Bug）：测试验证步骤

输出格式：

## 问题分析

### 现象
<一句话总结问题现象>

### 原因分析
<分析原因；使用行内代码引用函数、变量、语句>

### 是否为 Bug
<是 / 否，以及判断依据>

### 复现场景
<复现步骤和条件>

### 修改方案
<仅在判定为 Bug 时输出>

### 验证方法
<仅在判定为 Bug 时输出>

Story（需求）默认模板

1. 需求点：无序列表列出需求点
2. 技术可行性：先说可行/不可行，再说原因
3. 方案建议：给出技术方案
4. 风险点：高/中/低 + 具体风险
5. 工作量评估：大/中/小 + 一句话原因

如果需求不明确，先输出待澄清问题，不继续深挖：

## 需求分析

### 待澄清问题
- <不明确点 1>
- <不明确点 2>

请补充以上信息后再进行分析。

需求明确时输出：

## 需求分析

### 需求点
- <需求点 1>
- <需求点 2>

### 技术可行性
<可行 / 不可行>，<原因说明>

### 技术方案建议
<方案建议>

### 风险点
<高 / 中 / 低>，<风险说明>

### 涉及模块
<可能涉及的模块>

### 工作量评估
<大 / 中 / 小>，<一句话原因>

Task（任务）默认模板

Task 默认按 Story 的简版处理，重点关注执行可落地性：

1. 任务目标与完成标准
2. 关键执行步骤
3. 依赖与阻塞项
4. 风险与回退方案
5. 预估工作量

3) 处理用户问题

• 用户问题为空：走对应类型默认模板
• 用户问题非空：优先回答用户问题，再补充模板化分析

注意事项

1. 分析应结合项目代码与工单上下文，不只复述工单文本
2. 默认只输出分析和建议，不直接改代码
3. 输出使用 Markdown，结构清晰、可直接贴飞书评论
4. 若需要回写，调用 feishu-project-tool 完成写操作

边界

• 不直接调用飞书 API
• 不承担排期计算与资源分配（由 feishu-schedule-assistant 负责）