@lark-project/cli/skills/meegle-plugin/references/polish-overview.md

飞书项目插件开发工具

---
name: meegle-plugin-polish
version: 1.0.0
description: |
  Meegle 插件信息完善（编排 skill）：AI 根据已实现的功能自动生成插件名称、短描述、详情描述，选择分类，更新到后台。
  当用户在插件工程中说"完善插件信息"、"改名称"、"改描述"、"改分类"、"更新插件描述"时触发，或由 workflow phase 内部调用。
  前提：feature phase 已执行完 Stage Code，代码已就绪。
metadata:
  requires:
    bins: ["npx"]
  cliHelp: "lpm update-description --help"
---

# meegle-plugin-polish Skill

> **前置**：先 Read [`shared.md`](shared.md) 获取共享规则；进入每个 mode 前 Read 对应的 `references/<mode>.md`。
>
> **独立进入 gate（非 workflow 编排时必跑）**：若不是被 workflow Phase 3 编排进入，先确认插件已有代码——`test -d src && find src -name '*.tsx' -o -name '*.ts' | head -1`。`src/` 无代码 → 告知"代码尚未就绪，请先走 feature phase 实现功能"，停下（polish 基于实际代码生成描述才准确）。

## 本 skill 的最少 Read 清单

- 共享规则 → Read [`shared.md`](shared.md)
- mode=analyze → Read [`polish-analyze.md`](polish-analyze.md)
- mode=generate → Read [`polish-generate.md`](polish-generate.md)
- mode=confirm → Read [`polish-confirm.md`](polish-confirm.md)
- mode=apply → Read [`polish-apply.md`](polish-apply.md)
- 不要预加载 4 个 mode reference；按当前 mode 按需 Read

## 核心理念

**在功��实现之后填充基本信息，AI 能基于实际代码生成高质量的描述。**

此时 AI 已经知道：
- 插件配置了哪些点位（page/view/dashboard/button/...）
- 每个点位的名���和功能描述
- 代码实际实现了什么逻辑

基于这些信息生成的名称和描述比创建时"猜"的要准确得多。

## 核心流程

```
mode=analyze → 读取点位配置 + 代码，理解插件实际功能
mode=generate → AI 生成名称/短描述/详情描述 + 获取分类列表并推荐
mode=confirm → 展示生成结果，用户确认或调整
mode=apply   → 调用 CLI update-description 命令更新到后台
mode=pipeline（默认）→ analyze → generate → confirm → apply
```

> **始终走完整 pipeline**——不存在"只跑 apply"：缺 analyze / generate 的产物时 apply 没有意义。

## 使用方式

本 phase 通常由 meegle-plugin 的 router 自动路由进入(见上层 [`../SKILL.md`](../SKILL.md) §1 入口 SOP)。触发本 skill 时用自然语言描述意图即可,router 会按 cwd context + 意图路由到本 phase。

**显式入口**(高级用法 / 调试 / 断点续跑):触发本 skill 时显式说 `phase=polish` 或 `phase=polish mode=<modename>`,可跳过 router 的 phase 选择,直接进入指定 step。

可用 mode:
- `mode=pipeline`(默认)— 端到端全流程
- `mode=analyze` — 仅分析功能
- `mode=generate` — 生成描述信息
- `mode=confirm` — 展示并确认
- `mode=apply` — 提交到后台

## 各模式详细流程

- `mode=analyze`  → 读取 `polish-analyze.md`
- `mode=generate` → 读取 `polish-generate.md`
- `mode=confirm`  → 读取 `polish-confirm.md`
- `mode=apply`    → 读取 `polish-apply.md`

## 输入

| 来源 | 用途 |
|------|------|
| `point.config.local.json` | 点位类型、名称、i18n_info 描述、适用工作项类型 |
| `src/` 代码文件 | 实际功能逻辑 |

## 输出

通过 `update-description` CLI ��令更新到后台：
- 插件名称（正式名称替换工作名称）
- 短描述（≤100字纯文本）
- 详情描述（多段纯文本，CLI 自动转富文本）
- 分类（从列表中选择）

> 前置依赖链由 `workflow phase` 统一维护（... → feature phase → polish phase → publish phase）。