docs(review): explain promoted skill deletion

Signed-off-by: FenjuFu <fufenjupku@gmail.com>

docs/skillhub/en/guide/review.md

@@ -108,6 +108,19 @@ If a developer discovers an issue, they can withdraw the submission before it is
 3. Click "Withdraw"
 4. Confirm the withdrawal
 
+### Deleting a Promoted Skill
+
+If permanent deletion reports "Use the reviewed revocation workflow to remove a promoted skill", manage the global publication from the source team skill's detail page. Hiding, archiving, or withdrawing a pending submission does not remove an approved global skill. Submitting a revocation request does not complete revocation either.
+
+1. Open the source skill, such as `@it/translate-document`. In "Promote to Global", choose "Request global revocation", enter a reason, and confirm.
+2. Ask a platform `SKILL_ADMIN` or `SUPER_ADMIN` to open "Revocations to review" at `/dashboard/promotions`, verify the source and global skill, and choose "Approve revocation". A `SKILL_ADMIN` cannot review their own request; a `SUPER_ADMIN` can.
+3. Refresh the source skill and check that the current request shows "Revoked" (`APPROVED`) in "Revocation history". `PENDING` or `REJECTED` means that this request has not completed revocation; ordinary deletion remains blocked while an active global link exists. A historical request's status is not a substitute for checking the current promotion relationship.
+4. Approval deletes the linked `@global/translate-document` and all its global versions while keeping the source team skill. To remove the source too, use its permanent-delete action afterward with the required deletion permissions.
+
+A platform `SKILL_ADMIN` or `SUPER_ADMIN` can also choose "Revoke directly as admin" on the source detail page when no revocation request is pending. Confirmation completes global revocation immediately and retains the revocation record. When a request is already pending, the detail page only shows its pending status; handle it through "Revocations to review" as described above. Check the confirmation carefully: this removes the entire global skill, including independently uploaded global versions, ratings, and statistics. Installed client files cannot be recalled, and another skill may later use the same address.
+
+If the revocation record is already `APPROVED` but the same error persists after refreshing, record the source/global skill IDs, revocation request ID, deployed version or image tag, and the deletion response and request ID. Also check whether a new global promotion was approved after revocation. If the revocation controls are missing, first verify that the deployment and database migrations match the intended version and ask a maintainer to investigate. Do not edit promotion relationships directly in the database to bypass the workflow.
+
 **Handling Reports**:
 
 1. Navigate to `/dashboard/reports`

docs/skillhub/guide/review.md

@@ -108,6 +108,19 @@ SkillHub 能保证的是结构正确、证据可追溯、版本快照不可变
 3. 点击「撤回」
 4. 确认撤回
 
+### 删除已提升到全局的技能
+
+如果永久删除时提示「已提升的技能须通过审核撤销流程删除」，请从团队来源技能的详情页处理全局发布。隐藏、归档或撤回待审提交不会删除已经批准的全局技能；提交撤销申请也不代表撤销已完成。
+
+1. 打开来源技能（例如 `@it/translate-document`），在「提升到全局」区域点击「申请撤销全局发布」，填写原因并确认。
+2. 请平台 `SKILL_ADMIN` 或 `SUPER_ADMIN` 访问 `/dashboard/promotions` 的「撤销待审核」页签，核对来源技能和全局技能后点击「批准撤销」。`SKILL_ADMIN` 不能审核自己提交的申请；`SUPER_ADMIN` 可以。
+3. 刷新来源技能详情，核对本次申请在「撤销记录」中显示「已撤销」（`APPROVED`）。「待审核」（`PENDING`）或「已拒绝」（`REJECTED`）表示该申请未完成撤销；活动全局关联仍存在时，普通删除仍会被阻止。历史申请的状态不能代替当前提升关系的检查。
+4. 撤销批准后，关联的 `@global/translate-document` 及其所有全局版本会被删除，团队来源技能保留。需要删除来源技能时，再使用该技能的「永久删除」，仍需具备删除权限。
+
+尚无待审撤销申请时，平台 `SKILL_ADMIN` 或 `SUPER_ADMIN` 也可以在来源技能详情页使用「管理员直接撤销」，确认后立即完成全局撤销并保留撤销记录。已有待审申请时，详情页只显示待审提示，请通过上述「撤销待审核」入口处理。请先核对确认框：该操作会删除整条全局技能，包括独立上传的全局版本、评价和统计；已安装到客户端的文件无法收回，原地址以后可能被其他技能使用。
+
+如果撤销记录已经是 `APPROVED`，刷新后仍提示同一错误，请记录来源/全局技能 ID、撤销申请 ID、当前部署版本或镜像标签，以及删除请求的响应和请求 ID。还需确认撤销后是否又进行了新的全局提升。若当前界面没有撤销入口，先核对部署版本和数据库迁移是否与对应版本一致，再由维护者检查；不要直接修改数据库中的提升关系来绕过流程。
+
 **处理举报**：
 
 1. 访问 `/dashboard/reports`