@amaster.ai/pi-lark 0.1.4 → 0.1.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +3 -3
- package/skills/lark-approval/SKILL.md +99 -0
- package/skills/lark-approval/references/lark-approval-approvals-get.md +128 -0
- package/skills/lark-approval/references/lark-approval-approvals-search.md +103 -0
- package/skills/lark-approval/references/lark-approval-initiate.md +221 -0
- package/skills/lark-approval/references/lark-approval-instance-form-control-parameters.md +606 -0
- package/skills/lark-approval/references/lark-approval-instance-value-sourcing.md +108 -0
- package/skills/lark-approval/references/lark-approval-instances-cancel.md +78 -0
- package/skills/lark-approval/references/lark-approval-instances-cc.md +105 -0
- package/skills/lark-approval/references/lark-approval-instances-get.md +145 -0
- package/skills/lark-approval/references/lark-approval-instances-initiated.md +128 -0
- package/skills/lark-approval/references/lark-approval-tasks-add-sign.md +120 -0
- package/skills/lark-approval/references/lark-approval-tasks-approve.md +81 -0
- package/skills/lark-approval/references/lark-approval-tasks-query.md +85 -0
- package/skills/lark-approval/references/lark-approval-tasks-reject.md +73 -0
- package/skills/lark-approval/references/lark-approval-tasks-remind.md +82 -0
- package/skills/lark-approval/references/lark-approval-tasks-rollback.md +89 -0
- package/skills/lark-approval/references/lark-approval-tasks-transfer.md +91 -0
- package/skills/lark-apps/SKILL.md +110 -0
- package/skills/lark-apps/references/lark-apps-access-scope-get.md +28 -0
- package/skills/lark-apps/references/lark-apps-access-scope-set.md +40 -0
- package/skills/lark-apps/references/lark-apps-automation.md +164 -0
- package/skills/lark-apps/references/lark-apps-cloud-dev.md +120 -0
- package/skills/lark-apps/references/lark-apps-create.md +40 -0
- package/skills/lark-apps/references/lark-apps-db-execute.md +228 -0
- package/skills/lark-apps/references/lark-apps-db.md +162 -0
- package/skills/lark-apps/references/lark-apps-env-pull.md +37 -0
- package/skills/lark-apps/references/lark-apps-env.md +48 -0
- package/skills/lark-apps/references/lark-apps-file.md +96 -0
- package/skills/lark-apps/references/lark-apps-get.md +43 -0
- package/skills/lark-apps/references/lark-apps-git-credential.md +37 -0
- package/skills/lark-apps/references/lark-apps-html-publish.md +62 -0
- package/skills/lark-apps/references/lark-apps-init.md +36 -0
- package/skills/lark-apps/references/lark-apps-list.md +37 -0
- package/skills/lark-apps/references/lark-apps-local-dev.md +78 -0
- package/skills/lark-apps/references/lark-apps-observability.md +48 -0
- package/skills/lark-apps/references/lark-apps-openapi-key.md +79 -0
- package/skills/lark-apps/references/lark-apps-plugin-install.md +36 -0
- package/skills/lark-apps/references/lark-apps-plugin-list.md +23 -0
- package/skills/lark-apps/references/lark-apps-plugin-uninstall.md +25 -0
- package/skills/lark-apps/references/lark-apps-release-create.md +32 -0
- package/skills/lark-apps/references/lark-apps-release-get.md +28 -0
- package/skills/lark-apps/references/lark-apps-release-list.md +31 -0
- package/skills/lark-apps/references/lark-apps-role.md +133 -0
- package/skills/lark-apps/references/lark-apps-session-messages-list.md +53 -0
- package/skills/lark-apps/references/lark-apps-update.md +30 -0
- package/skills/lark-attendance/SKILL.md +57 -0
- package/skills/lark-base/SKILL.md +161 -0
- package/skills/lark-base/references/dashboard-block-data-config.md +376 -0
- package/skills/lark-base/references/formula-field-guide.md +737 -0
- package/skills/lark-base/references/lark-base-cell-value.md +158 -0
- package/skills/lark-base/references/lark-base-dashboard-block-get-data.md +717 -0
- package/skills/lark-base/references/lark-base-dashboard.md +247 -0
- package/skills/lark-base/references/lark-base-data-analysis-sop.md +210 -0
- package/skills/lark-base/references/lark-base-data-query-guide.md +61 -0
- package/skills/lark-base/references/lark-base-data-query.md +454 -0
- package/skills/lark-base/references/lark-base-field-create.md +105 -0
- package/skills/lark-base/references/lark-base-field-json.md +527 -0
- package/skills/lark-base/references/lark-base-field-update.md +173 -0
- package/skills/lark-base/references/lark-base-form-detail.md +71 -0
- package/skills/lark-base/references/lark-base-form-questions-create.md +118 -0
- package/skills/lark-base/references/lark-base-form-questions-update.md +92 -0
- package/skills/lark-base/references/lark-base-form-submit.md +170 -0
- package/skills/lark-base/references/lark-base-record-batch-create.md +57 -0
- package/skills/lark-base/references/lark-base-record-batch-update.md +52 -0
- package/skills/lark-base/references/lark-base-record-history-list.md +43 -0
- package/skills/lark-base/references/lark-base-record-upsert.md +63 -0
- package/skills/lark-base/references/lark-base-role-guide.md +65 -0
- package/skills/lark-base/references/lark-base-view-set-filter.md +191 -0
- package/skills/lark-base/references/lark-base-workflow-guide.md +830 -0
- package/skills/lark-base/references/lark-base-workflow-schema.md +1071 -0
- package/skills/lark-base/references/lookup-field-guide.md +512 -0
- package/skills/lark-base/references/role-config.md +549 -0
- package/skills/lark-calendar/SKILL.md +198 -0
- package/skills/lark-calendar/references/lark-calendar-create.md +83 -0
- package/skills/lark-calendar/references/lark-calendar-meeting.md +40 -0
- package/skills/lark-calendar/references/lark-calendar-recurring.md +90 -0
- package/skills/lark-calendar/references/lark-calendar-room-find.md +109 -0
- package/skills/lark-calendar/references/lark-calendar-rsvp.md +38 -0
- package/skills/lark-calendar/references/lark-calendar-schedule-clear-time.md +59 -0
- package/skills/lark-calendar/references/lark-calendar-schedule-fuzzy-time.md +88 -0
- package/skills/lark-calendar/references/lark-calendar-schedule-meeting.md +122 -0
- package/skills/lark-calendar/references/lark-calendar-suggestion.md +121 -0
- package/skills/lark-calendar/references/lark-calendar-update.md +100 -0
- package/skills/lark-contact/SKILL.md +55 -0
- package/skills/lark-contact/references/lark-contact-get-user.md +19 -0
- package/skills/lark-contact/references/lark-contact-search-user.md +123 -0
- package/skills/lark-doc/SKILL.md +84 -0
- package/skills/lark-doc/references/lark-doc-create.md +80 -0
- package/skills/lark-doc/references/lark-doc-fetch.md +140 -0
- package/skills/lark-doc/references/lark-doc-history.md +107 -0
- package/skills/lark-doc/references/lark-doc-md.md +76 -0
- package/skills/lark-doc/references/lark-doc-media-download.md +50 -0
- package/skills/lark-doc/references/lark-doc-media-insert.md +114 -0
- package/skills/lark-doc/references/lark-doc-media-preview.md +41 -0
- package/skills/lark-doc/references/lark-doc-mindnote.md +128 -0
- package/skills/lark-doc/references/lark-doc-resource-cover.md +70 -0
- package/skills/lark-doc/references/lark-doc-update.md +260 -0
- package/skills/lark-doc/references/lark-doc-whiteboard.md +158 -0
- package/skills/lark-doc/references/lark-doc-word-stat.md +93 -0
- package/skills/lark-doc/references/lark-doc-xml-extended-blocks.md +35 -0
- package/skills/lark-doc/references/lark-doc-xml.md +182 -0
- package/skills/lark-doc/references/style/lark-doc-create-workflow.md +47 -0
- package/skills/lark-doc/references/style/lark-doc-style.md +68 -0
- package/skills/lark-doc/references/style/lark-doc-update-workflow.md +48 -0
- package/skills/lark-doc/scripts/doc_word_stat.py +1243 -0
- package/skills/lark-drive/SKILL.md +232 -0
- package/skills/lark-drive/references/lark-drive-add-comment.md +193 -0
- package/skills/lark-drive/references/lark-drive-apply-permission.md +77 -0
- package/skills/lark-drive/references/lark-drive-comment-location.md +205 -0
- package/skills/lark-drive/references/lark-drive-comments-guide.md +80 -0
- package/skills/lark-drive/references/lark-drive-cover.md +79 -0
- package/skills/lark-drive/references/lark-drive-create-folder.md +73 -0
- package/skills/lark-drive/references/lark-drive-create-shortcut.md +103 -0
- package/skills/lark-drive/references/lark-drive-delete.md +103 -0
- package/skills/lark-drive/references/lark-drive-download.md +31 -0
- package/skills/lark-drive/references/lark-drive-export-download.md +50 -0
- package/skills/lark-drive/references/lark-drive-export.md +174 -0
- package/skills/lark-drive/references/lark-drive-files-list.md +183 -0
- package/skills/lark-drive/references/lark-drive-import.md +178 -0
- package/skills/lark-drive/references/lark-drive-inspect.md +52 -0
- package/skills/lark-drive/references/lark-drive-list-comments.md +125 -0
- package/skills/lark-drive/references/lark-drive-member-add.md +66 -0
- package/skills/lark-drive/references/lark-drive-move.md +122 -0
- package/skills/lark-drive/references/lark-drive-permission-guide.md +53 -0
- package/skills/lark-drive/references/lark-drive-preview.md +87 -0
- package/skills/lark-drive/references/lark-drive-pull.md +137 -0
- package/skills/lark-drive/references/lark-drive-push.md +189 -0
- package/skills/lark-drive/references/lark-drive-reactions.md +113 -0
- package/skills/lark-drive/references/lark-drive-search.md +273 -0
- package/skills/lark-drive/references/lark-drive-secure-label.md +52 -0
- package/skills/lark-drive/references/lark-drive-status.md +135 -0
- package/skills/lark-drive/references/lark-drive-task-result.md +355 -0
- package/skills/lark-drive/references/lark-drive-upload.md +101 -0
- package/skills/lark-drive/references/lark-drive-version-delete.md +38 -0
- package/skills/lark-drive/references/lark-drive-version-get.md +71 -0
- package/skills/lark-drive/references/lark-drive-version-history.md +73 -0
- package/skills/lark-drive/references/lark-drive-version-revert.md +35 -0
- package/skills/lark-drive/references/lark-drive-workflow-knowledge-organize-analysis.md +249 -0
- package/skills/lark-drive/references/lark-drive-workflow-knowledge-organize-discovery.md +253 -0
- package/skills/lark-drive/references/lark-drive-workflow-knowledge-organize-execution.md +200 -0
- package/skills/lark-drive/references/lark-drive-workflow-knowledge-organize-planning.md +336 -0
- package/skills/lark-drive/references/lark-drive-workflow-knowledge-organize-rollback.md +308 -0
- package/skills/lark-drive/references/lark-drive-workflow-knowledge-organize.md +232 -0
- package/skills/lark-drive/references/lark-drive-workflow-permission-governance-commands.md +168 -0
- package/skills/lark-drive/references/lark-drive-workflow-permission-governance-outputs.md +424 -0
- package/skills/lark-drive/references/lark-drive-workflow-permission-governance.md +207 -0
- package/skills/lark-drive/references/lark-drive-workflow.md +131 -0
- package/skills/lark-event/SKILL.md +155 -0
- package/skills/lark-event/references/lark-event-approval.md +170 -0
- package/skills/lark-event/references/lark-event-im.md +87 -0
- package/skills/lark-event/references/lark-event-minutes.md +54 -0
- package/skills/lark-event/references/lark-event-task.md +78 -0
- package/skills/lark-event/references/lark-event-vc.md +106 -0
- package/skills/lark-event/references/lark-event-whiteboard.md +67 -0
- package/skills/lark-im/SKILL.md +249 -0
- package/skills/lark-im/references/card/card-2.0-schema.md +107 -0
- package/skills/lark-im/references/card/components/button.md +63 -0
- package/skills/lark-im/references/card/components/chart.md +57 -0
- package/skills/lark-im/references/card/components/checker.md +38 -0
- package/skills/lark-im/references/card/components/collapsible_panel.md +46 -0
- package/skills/lark-im/references/card/components/column_set.md +53 -0
- package/skills/lark-im/references/card/components/date_picker.md +34 -0
- package/skills/lark-im/references/card/components/div.md +36 -0
- package/skills/lark-im/references/card/components/form.md +51 -0
- package/skills/lark-im/references/card/components/header.md +34 -0
- package/skills/lark-im/references/card/components/hr.md +17 -0
- package/skills/lark-im/references/card/components/img.md +34 -0
- package/skills/lark-im/references/card/components/img_combination.md +30 -0
- package/skills/lark-im/references/card/components/input.md +43 -0
- package/skills/lark-im/references/card/components/interactive_container.md +46 -0
- package/skills/lark-im/references/card/components/markdown.md +56 -0
- package/skills/lark-im/references/card/components/multi_select_person.md +40 -0
- package/skills/lark-im/references/card/components/multi_select_static.md +40 -0
- package/skills/lark-im/references/card/components/overflow.md +36 -0
- package/skills/lark-im/references/card/components/person.md +30 -0
- package/skills/lark-im/references/card/components/person_list.md +31 -0
- package/skills/lark-im/references/card/components/picker_datetime.md +34 -0
- package/skills/lark-im/references/card/components/picker_time.md +34 -0
- package/skills/lark-im/references/card/components/recycling_container.md +35 -0
- package/skills/lark-im/references/card/components/select_img.md +42 -0
- package/skills/lark-im/references/card/components/select_person.md +39 -0
- package/skills/lark-im/references/card/components/select_static.md +43 -0
- package/skills/lark-im/references/card/components/table.md +53 -0
- package/skills/lark-im/references/card/lark-im-card-create.md +180 -0
- package/skills/lark-im/references/card/lark-im-card-style.md +281 -0
- package/skills/lark-im/references/card/resource/colors.md +34 -0
- package/skills/lark-im/references/card/resource/icons.md +38 -0
- package/skills/lark-im/references/lark-im-card-action-reply.md +175 -0
- package/skills/lark-im/references/lark-im-chat-create.md +162 -0
- package/skills/lark-im/references/lark-im-chat-identity.md +55 -0
- package/skills/lark-im/references/lark-im-chat-list.md +166 -0
- package/skills/lark-im/references/lark-im-chat-members-list.md +83 -0
- package/skills/lark-im/references/lark-im-chat-messages-list.md +157 -0
- package/skills/lark-im/references/lark-im-chat-search.md +142 -0
- package/skills/lark-im/references/lark-im-chat-update.md +84 -0
- package/skills/lark-im/references/lark-im-feed-group-list-item.md +68 -0
- package/skills/lark-im/references/lark-im-feed-group-list.md +65 -0
- package/skills/lark-im/references/lark-im-feed-group-query-item.md +44 -0
- package/skills/lark-im/references/lark-im-feed-groups.md +452 -0
- package/skills/lark-im/references/lark-im-feed-shortcut-create.md +97 -0
- package/skills/lark-im/references/lark-im-feed-shortcut-list.md +103 -0
- package/skills/lark-im/references/lark-im-feed-shortcut-remove.md +48 -0
- package/skills/lark-im/references/lark-im-flag-cancel.md +67 -0
- package/skills/lark-im/references/lark-im-flag-create.md +67 -0
- package/skills/lark-im/references/lark-im-flag-list.md +100 -0
- package/skills/lark-im/references/lark-im-message-enrichment.md +54 -0
- package/skills/lark-im/references/lark-im-messages-mget.md +99 -0
- package/skills/lark-im/references/lark-im-messages-reply.md +277 -0
- package/skills/lark-im/references/lark-im-messages-resources-download.md +94 -0
- package/skills/lark-im/references/lark-im-messages-search.md +234 -0
- package/skills/lark-im/references/lark-im-messages-send.md +279 -0
- package/skills/lark-im/references/lark-im-reactions.md +299 -0
- package/skills/lark-im/references/lark-im-threads-messages-list.md +115 -0
- package/skills/lark-mail/SKILL.md +290 -0
- package/skills/lark-mail/assets/templates/job-application--resume.html +33 -0
- package/skills/lark-mail/assets/templates/newsletter--weekly-brief.html +50 -0
- package/skills/lark-mail/assets/templates/research--market-report.html +256 -0
- package/skills/lark-mail/assets/templates/weekly--personal-report.html +43 -0
- package/skills/lark-mail/assets/templates/weekly--team-report.html +9 -0
- package/skills/lark-mail/references/lark-mail-calendar-invite.md +36 -0
- package/skills/lark-mail/references/lark-mail-decline-receipt.md +115 -0
- package/skills/lark-mail/references/lark-mail-draft-create.md +127 -0
- package/skills/lark-mail/references/lark-mail-draft-edit.md +404 -0
- package/skills/lark-mail/references/lark-mail-forward.md +239 -0
- package/skills/lark-mail/references/lark-mail-html.md +333 -0
- package/skills/lark-mail/references/lark-mail-lint-html.md +243 -0
- package/skills/lark-mail/references/lark-mail-message-modify.md +48 -0
- package/skills/lark-mail/references/lark-mail-message-trash.md +41 -0
- package/skills/lark-mail/references/lark-mail-message.md +233 -0
- package/skills/lark-mail/references/lark-mail-messages.md +108 -0
- package/skills/lark-mail/references/lark-mail-recall.md +66 -0
- package/skills/lark-mail/references/lark-mail-recipient-search.md +59 -0
- package/skills/lark-mail/references/lark-mail-reply-all.md +213 -0
- package/skills/lark-mail/references/lark-mail-reply.md +249 -0
- package/skills/lark-mail/references/lark-mail-rules.md +31 -0
- package/skills/lark-mail/references/lark-mail-send-as.md +44 -0
- package/skills/lark-mail/references/lark-mail-send-receipt.md +120 -0
- package/skills/lark-mail/references/lark-mail-send-status.md +46 -0
- package/skills/lark-mail/references/lark-mail-send.md +222 -0
- package/skills/lark-mail/references/lark-mail-share-to-chat.md +87 -0
- package/skills/lark-mail/references/lark-mail-signature.md +98 -0
- package/skills/lark-mail/references/lark-mail-template-create.md +129 -0
- package/skills/lark-mail/references/lark-mail-template-update.md +150 -0
- package/skills/lark-mail/references/lark-mail-template.md +54 -0
- package/skills/lark-mail/references/lark-mail-thread.md +111 -0
- package/skills/lark-mail/references/lark-mail-triage.md +131 -0
- package/skills/lark-mail/references/lark-mail-watch.md +94 -0
- package/skills/lark-markdown/SKILL.md +70 -0
- package/skills/lark-markdown/references/lark-markdown-create.md +114 -0
- package/skills/lark-markdown/references/lark-markdown-diff.md +156 -0
- package/skills/lark-markdown/references/lark-markdown-fetch.md +79 -0
- package/skills/lark-markdown/references/lark-markdown-overwrite.md +85 -0
- package/skills/lark-markdown/references/lark-markdown-patch.md +160 -0
- package/skills/lark-minutes/SKILL.md +207 -0
- package/skills/lark-minutes/references/lark-minutes-detail.md +62 -0
- package/skills/lark-minutes/references/lark-minutes-download.md +135 -0
- package/skills/lark-minutes/references/lark-minutes-search.md +202 -0
- package/skills/lark-minutes/references/lark-minutes-speaker-replace.md +107 -0
- package/skills/lark-minutes/references/lark-minutes-summary.md +120 -0
- package/skills/lark-minutes/references/lark-minutes-todo.md +136 -0
- package/skills/lark-minutes/references/lark-minutes-update.md +39 -0
- package/skills/lark-minutes/references/lark-minutes-upload.md +104 -0
- package/skills/lark-note/SKILL.md +94 -0
- package/skills/lark-note/references/lark-note-detail.md +26 -0
- package/skills/lark-note/references/lark-note-transcript.md +23 -0
- package/skills/lark-okr/SKILL.md +122 -0
- package/skills/lark-okr/references/lark-okr-alignments.md +180 -0
- package/skills/lark-okr/references/lark-okr-batch-create.md +106 -0
- package/skills/lark-okr/references/lark-okr-contentblock.md +427 -0
- package/skills/lark-okr/references/lark-okr-cycle-detail.md +91 -0
- package/skills/lark-okr/references/lark-okr-cycle-list.md +93 -0
- package/skills/lark-okr/references/lark-okr-entities.md +329 -0
- package/skills/lark-okr/references/lark-okr-image-upload.md +116 -0
- package/skills/lark-okr/references/lark-okr-indicator-update.md +80 -0
- package/skills/lark-okr/references/lark-okr-indicators.md +223 -0
- package/skills/lark-okr/references/lark-okr-patch.md +104 -0
- package/skills/lark-okr/references/lark-okr-progress-create.md +85 -0
- package/skills/lark-okr/references/lark-okr-progress-delete.md +47 -0
- package/skills/lark-okr/references/lark-okr-progress-get.md +93 -0
- package/skills/lark-okr/references/lark-okr-progress-list.md +80 -0
- package/skills/lark-okr/references/lark-okr-progress-update.md +85 -0
- package/skills/lark-okr/references/lark-okr-reorder.md +81 -0
- package/skills/lark-okr/references/lark-okr-weight.md +96 -0
- package/skills/lark-openapi-explorer/SKILL.md +153 -0
- package/skills/lark-shared/SKILL.md +211 -0
- package/skills/lark-shared/references/lark-wiki-token-routing.md +42 -0
- package/skills/lark-sheets/SKILL.md +234 -0
- package/skills/lark-sheets/references/lark-sheets-batch-update.md +200 -0
- package/skills/lark-sheets/references/lark-sheets-changeset.md +105 -0
- package/skills/lark-sheets/references/lark-sheets-chart.md +332 -0
- package/skills/lark-sheets/references/lark-sheets-conditional-format.md +181 -0
- package/skills/lark-sheets/references/lark-sheets-filter-view.md +137 -0
- package/skills/lark-sheets/references/lark-sheets-filter.md +130 -0
- package/skills/lark-sheets/references/lark-sheets-float-image.md +159 -0
- package/skills/lark-sheets/references/lark-sheets-formula-translation.md +276 -0
- package/skills/lark-sheets/references/lark-sheets-formula-verify.md +77 -0
- package/skills/lark-sheets/references/lark-sheets-history.md +93 -0
- package/skills/lark-sheets/references/lark-sheets-pivot-table.md +171 -0
- package/skills/lark-sheets/references/lark-sheets-range-operations.md +297 -0
- package/skills/lark-sheets/references/lark-sheets-read-data.md +235 -0
- package/skills/lark-sheets/references/lark-sheets-search-replace.md +111 -0
- package/skills/lark-sheets/references/lark-sheets-sheet-structure.md +212 -0
- package/skills/lark-sheets/references/lark-sheets-sparkline.md +149 -0
- package/skills/lark-sheets/references/lark-sheets-visual-standards.md +205 -0
- package/skills/lark-sheets/references/lark-sheets-workbook.md +420 -0
- package/skills/lark-sheets/references/lark-sheets-write-cells.md +575 -0
- package/skills/lark-sheets/scripts/sheets_df.py +32 -0
- package/skills/lark-skill-maker/SKILL.md +85 -0
- package/skills/lark-slides/SKILL.md +285 -0
- package/skills/lark-slides/references/asset-planning.md +135 -0
- package/skills/lark-slides/references/examples.md +91 -0
- package/skills/lark-slides/references/iconpark-index.json +41901 -0
- package/skills/lark-slides/references/iconpark.md +46 -0
- package/skills/lark-slides/references/lark-slides-create.md +156 -0
- package/skills/lark-slides/references/lark-slides-edit-workflows.md +144 -0
- package/skills/lark-slides/references/lark-slides-media-upload.md +127 -0
- package/skills/lark-slides/references/lark-slides-pptx-template-workflows.md +89 -0
- package/skills/lark-slides/references/lark-slides-replace-pages.md +95 -0
- package/skills/lark-slides/references/lark-slides-replace-slide.md +240 -0
- package/skills/lark-slides/references/lark-slides-screenshot.md +97 -0
- package/skills/lark-slides/references/lark-slides-whiteboard.md +331 -0
- package/skills/lark-slides/references/lark-slides-xml-get.md +100 -0
- package/skills/lark-slides/references/lark-slides-xml-presentation-slide-delete.md +125 -0
- package/skills/lark-slides/references/lark-slides-xml-presentation-slide-get.md +110 -0
- package/skills/lark-slides/references/lark-slides-xml-presentation-slide-replace.md +189 -0
- package/skills/lark-slides/references/lark-slides-xml-presentations-get.md +99 -0
- package/skills/lark-slides/references/planning-layer.md +246 -0
- package/skills/lark-slides/references/slide-templates.md +201 -0
- package/skills/lark-slides/references/slides_chart_demo.xml +1 -0
- package/skills/lark-slides/references/slides_demo.xml +226 -0
- package/skills/lark-slides/references/slides_xml_schema_definition.xml +3054 -0
- package/skills/lark-slides/references/troubleshooting.md +45 -0
- package/skills/lark-slides/references/validation-checklist.md +119 -0
- package/skills/lark-slides/references/visual-planning.md +255 -0
- package/skills/lark-slides/references/xml-format-guide.md +433 -0
- package/skills/lark-slides/references/xml-schema-quick-ref.md +249 -0
- package/skills/lark-slides/scripts/iconpark_tool.py +362 -0
- package/skills/lark-slides/scripts/iconpark_tool_test.py +177 -0
- package/skills/lark-slides/scripts/xml_text_overlap_lint.py +1220 -0
- package/skills/lark-slides/scripts/xml_text_overlap_lint_test.py +1170 -0
- package/skills/lark-task/SKILL.md +168 -0
- package/skills/lark-task/references/lark-task-assign.md +38 -0
- package/skills/lark-task/references/lark-task-comment.md +28 -0
- package/skills/lark-task/references/lark-task-complete.md +27 -0
- package/skills/lark-task/references/lark-task-create.md +70 -0
- package/skills/lark-task/references/lark-task-followers.md +35 -0
- package/skills/lark-task/references/lark-task-get-my-tasks.md +61 -0
- package/skills/lark-task/references/lark-task-get-related-tasks.md +53 -0
- package/skills/lark-task/references/lark-task-reminder.md +36 -0
- package/skills/lark-task/references/lark-task-reopen.md +27 -0
- package/skills/lark-task/references/lark-task-search.md +41 -0
- package/skills/lark-task/references/lark-task-set-ancestor.md +32 -0
- package/skills/lark-task/references/lark-task-tasklist-create.md +35 -0
- package/skills/lark-task/references/lark-task-tasklist-members.md +36 -0
- package/skills/lark-task/references/lark-task-tasklist-search.md +38 -0
- package/skills/lark-task/references/lark-task-tasklist-task-add.md +38 -0
- package/skills/lark-task/references/lark-task-update.md +37 -0
- package/skills/lark-task/references/lark-task-upload-attachment.md +59 -0
- package/skills/lark-vc/SKILL.md +205 -0
- package/skills/lark-vc/references/lark-vc-detail.md +44 -0
- package/skills/lark-vc/references/lark-vc-recording.md +152 -0
- package/skills/lark-vc/references/lark-vc-search.md +163 -0
- package/skills/lark-vc/references/vc-domain-boundaries.md +196 -0
- package/skills/lark-vc-agent/SKILL.md +201 -0
- package/skills/lark-vc-agent/references/lark-vc-agent-meeting-events.md +315 -0
- package/skills/lark-vc-agent/references/lark-vc-agent-meeting-join.md +141 -0
- package/skills/lark-vc-agent/references/lark-vc-agent-meeting-leave.md +105 -0
- package/skills/lark-vc-agent/references/lark-vc-agent-meeting-list-active.md +91 -0
- package/skills/lark-vc-agent/references/lark-vc-agent-meeting-message-send.md +134 -0
- package/skills/lark-whiteboard/SKILL.md +47 -0
- package/skills/lark-whiteboard/elements/connectors.md +102 -0
- package/skills/lark-whiteboard/elements/content.md +40 -0
- package/skills/lark-whiteboard/elements/image.md +80 -0
- package/skills/lark-whiteboard/elements/layout.md +374 -0
- package/skills/lark-whiteboard/elements/schema.md +357 -0
- package/skills/lark-whiteboard/elements/style.md +318 -0
- package/skills/lark-whiteboard/elements/typography.md +73 -0
- package/skills/lark-whiteboard/references/lark-whiteboard-query.md +60 -0
- package/skills/lark-whiteboard/references/lark-whiteboard-update.md +122 -0
- package/skills/lark-whiteboard/references/lark-whiteboard-workflow.md +97 -0
- package/skills/lark-whiteboard/routes/dsl.md +107 -0
- package/skills/lark-whiteboard/routes/mermaid.md +27 -0
- package/skills/lark-whiteboard/routes/svg-edit.md +85 -0
- package/skills/lark-whiteboard/routes/svg.md +54 -0
- package/skills/lark-whiteboard/scenes/architecture.md +433 -0
- package/skills/lark-whiteboard/scenes/bar-chart.md +187 -0
- package/skills/lark-whiteboard/scenes/comparison.md +135 -0
- package/skills/lark-whiteboard/scenes/fishbone.md +238 -0
- package/skills/lark-whiteboard/scenes/flowchart.md +185 -0
- package/skills/lark-whiteboard/scenes/flywheel.md +195 -0
- package/skills/lark-whiteboard/scenes/funnel.md +101 -0
- package/skills/lark-whiteboard/scenes/line-chart.md +214 -0
- package/skills/lark-whiteboard/scenes/mermaid.md +130 -0
- package/skills/lark-whiteboard/scenes/milestone.md +139 -0
- package/skills/lark-whiteboard/scenes/organization.md +173 -0
- package/skills/lark-whiteboard/scenes/photo-showcase.md +126 -0
- package/skills/lark-whiteboard/scenes/pyramid.md +99 -0
- package/skills/lark-whiteboard/scenes/swimlane.md +371 -0
- package/skills/lark-whiteboard/scenes/treemap.md +216 -0
- package/skills/lark-wiki/SKILL.md +114 -0
- package/skills/lark-wiki/references/lark-wiki-delete-space.md +205 -0
- package/skills/lark-wiki/references/lark-wiki-member-add.md +67 -0
- package/skills/lark-wiki/references/lark-wiki-member-list.md +76 -0
- package/skills/lark-wiki/references/lark-wiki-member-remove.md +61 -0
- package/skills/lark-wiki/references/lark-wiki-move-to-drive.md +122 -0
- package/skills/lark-wiki/references/lark-wiki-move.md +185 -0
- package/skills/lark-wiki/references/lark-wiki-node-copy.md +72 -0
- package/skills/lark-wiki/references/lark-wiki-node-create.md +127 -0
- package/skills/lark-wiki/references/lark-wiki-node-delete.md +62 -0
- package/skills/lark-wiki/references/lark-wiki-node-get.md +57 -0
- package/skills/lark-wiki/references/lark-wiki-node-list.md +95 -0
- package/skills/lark-wiki/references/lark-wiki-space-create.md +46 -0
- package/skills/lark-wiki/references/lark-wiki-space-list.md +68 -0
- package/skills/lark-workflow-meeting-summary/SKILL.md +122 -0
- package/skills/lark-workflow-standup-report/SKILL.md +122 -0
|
@@ -0,0 +1,336 @@
|
|
|
1
|
+
# 知识整理工作流:Planning
|
|
2
|
+
|
|
3
|
+
Loaded by states: `PLAN_GENERATION`, `EXEC_CONFIRM`.
|
|
4
|
+
|
|
5
|
+
This file owns plan generation, plan revision, user-facing pagination, and execution confirmation. It MUST NOT perform write operations.
|
|
6
|
+
|
|
7
|
+
## Required Context
|
|
8
|
+
|
|
9
|
+
Before executing rules in this file:
|
|
10
|
+
|
|
11
|
+
1. `resource_items`, `classification_rules`, and `target_tree` MUST already exist.
|
|
12
|
+
2. Follow command syntax, scope requirements, and confirmation behavior from referenced shortcut docs.
|
|
13
|
+
3. Follow `Non-goals` from the main workflow entry. Do not execute excluded operations from this file.
|
|
14
|
+
|
|
15
|
+
## State: PLAN_GENERATION
|
|
16
|
+
|
|
17
|
+
Entry: `target_tree` exists after the user confirmed the organization approach.
|
|
18
|
+
|
|
19
|
+
MUST:
|
|
20
|
+
|
|
21
|
+
1. Generate complete internal `plan_items`.
|
|
22
|
+
2. Build `DisplayItem` only for user-facing pages.
|
|
23
|
+
3. Apply `Plan Generation`.
|
|
24
|
+
4. Apply `Plan Pagination`.
|
|
25
|
+
5. Set `active_plan_items` to the latest complete plan.
|
|
26
|
+
6. Keep complete plan internally even if only one page is displayed.
|
|
27
|
+
7. Apply `Plan Generation Progress Reporting`.
|
|
28
|
+
8. Output `Target Tree And Plan Overview` or requested plan page, then wait.
|
|
29
|
+
|
|
30
|
+
### Plan Generation
|
|
31
|
+
|
|
32
|
+
| Condition | Agent MUST Do |
|
|
33
|
+
|-----------|---------------|
|
|
34
|
+
| Target path appears in any plan item | Ensure the path exists in `target_tree` |
|
|
35
|
+
| Source parent and descendants share same target subtree | Move parent only; mark descendants `covered_by_parent_move=true` |
|
|
36
|
+
| A child target differs from parent target | Move divergent child before parent; order by `source_depth` from deep to shallow |
|
|
37
|
+
| Target directory / node does not exist | Add `create_folder` / `create_node` before move |
|
|
38
|
+
| Resource is root-level and target path differs from current path | Add a `move` plan item; do not leave root-level resources in place by default |
|
|
39
|
+
| Resource has `needs_review=true` because classification evidence is insufficient | Set `target_path` to manual confirmation target, set `action=move`, and preserve `needs_review_reason` |
|
|
40
|
+
| Top-level folder / Wiki node has descendants that share the same target subtree | Move the parent folder / node only; descendants are covered by parent move |
|
|
41
|
+
| Top-level folder / Wiki node has descendants with divergent target subtrees | Move divergent descendants first; then move the parent only if it still has a target path or needs manual confirmation |
|
|
42
|
+
| Source container is reused as a target container | Keep the container in place; do not move it as source-container cleanup |
|
|
43
|
+
| Non-reused source container has descendants moved elsewhere | Add an explicit folder / node move plan item after descendant moves; target defaults to the source-container cleanup target |
|
|
44
|
+
| Source container handling is ambiguous | Move it to the manual confirmation target or mark `needs_review=true`; do not leave it in the root by default |
|
|
45
|
+
| Target parent token unresolved | Keep plan item but block execution until token is resolved |
|
|
46
|
+
| Resource title is poor or inconsistent | Report the naming issue only; do not create rename or title-patch plan items |
|
|
47
|
+
|
|
48
|
+
### Plan Generation Progress Reporting
|
|
49
|
+
|
|
50
|
+
Plan generation can be long-running when `resource_items` is large or source-container parent / child move ordering is complex.
|
|
51
|
+
|
|
52
|
+
Rules:
|
|
53
|
+
|
|
54
|
+
1. If plan generation starts with more than 500 `resource_items`, output one concise start notice with the resource count and that no write operation is being executed.
|
|
55
|
+
2. If plan generation runs longer than about 60 seconds, output progress about every 60 seconds.
|
|
56
|
+
3. Progress reports SHOULD include only fields currently known: processed resource count, generated plan item count, create count, move count, source-container move count, review count, and current step.
|
|
57
|
+
4. Do not display unpaginated plan details as progress. Complete `plan_items` remain internal until the normal paginated output.
|
|
58
|
+
5. Do not ask the user to continue during plan generation unless auth, permission, API, target scope, or environment blockers occur.
|
|
59
|
+
6. Do not output filler such as "still running" without current counts or current step.
|
|
60
|
+
|
|
61
|
+
Example:
|
|
62
|
+
|
|
63
|
+
```text
|
|
64
|
+
计划生成进度:已处理 <processed_count>/<resource_count> 项资源,生成 <plan_item_count> 项计划,其中创建 <create_count> 项、移动 <move_count> 项。继续计算父子目录移动顺序,不会执行创建或移动。
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
## PlanItem
|
|
68
|
+
|
|
69
|
+
`PlanItem` is for internal execution. It may contain tokens and internal enums.
|
|
70
|
+
|
|
71
|
+
| Field | Meaning |
|
|
72
|
+
|-------|---------|
|
|
73
|
+
| `plan_id` | Stable unique ID for plan / verification, such as `P001` |
|
|
74
|
+
| `source_path` | Current path |
|
|
75
|
+
| `title` | Resource title |
|
|
76
|
+
| `type` | Resource type |
|
|
77
|
+
| `source_token` | Drive token or normal resource token |
|
|
78
|
+
| `source_node_token` | Wiki node token; empty for non-Wiki resources |
|
|
79
|
+
| `source_parent_token` | Current parent folder token or parent Wiki node token |
|
|
80
|
+
| `source_depth` | Original depth in source tree |
|
|
81
|
+
| `target_path` | Target path |
|
|
82
|
+
| `target_parent_path` | Target parent path |
|
|
83
|
+
| `target_parent_token` | Target parent token; may be empty during planning, MUST be resolved before execution |
|
|
84
|
+
| `action` | Internal enum: `keep` / `create_folder` / `create_node` / `move` |
|
|
85
|
+
| `covered_by_parent_move` | Whether an ancestor move already covers this item |
|
|
86
|
+
| `reason` | Classification reason |
|
|
87
|
+
| `evidence_paths` | Evidence paths |
|
|
88
|
+
| `evidence_count` | Evidence count or hit count |
|
|
89
|
+
| `confidence` | Internal enum: `high` / `medium` / `low` |
|
|
90
|
+
| `needs_review` | Whether human review is required |
|
|
91
|
+
| `needs_review_reason` | Reason requiring human review |
|
|
92
|
+
| `rollback_origin_kind` | Internal recovery origin marker: `drive_folder` / `drive_root` / `wiki_node` / `wiki_space_root` / `unknown` |
|
|
93
|
+
| `rollback_origin_token` | Original parent token when applicable; empty for root markers |
|
|
94
|
+
| `rollback_origin_space_id` | Original Wiki space ID when `rollback_origin_kind=wiki_space_root` |
|
|
95
|
+
| `rollback_supported` | Whether this move item can be restored automatically if recovery is requested |
|
|
96
|
+
| `rollback_blocker` | Internal reason when `rollback_supported=false` |
|
|
97
|
+
|
|
98
|
+
### Rollback Origin Readiness
|
|
99
|
+
|
|
100
|
+
This is an internal execution-safety rule. Do not expose rollback readiness on the normal user-facing execution confirmation path.
|
|
101
|
+
|
|
102
|
+
Rules:
|
|
103
|
+
|
|
104
|
+
1. `action=move` items entering execution SHOULD have `rollback_origin_kind`.
|
|
105
|
+
2. `rollback_origin_kind` can be:
|
|
106
|
+
- `drive_folder`: original Drive parent folder token is known.
|
|
107
|
+
- `drive_root`: original location is the Drive root.
|
|
108
|
+
- `wiki_node`: original Wiki parent node token is known.
|
|
109
|
+
- `wiki_space_root`: original location is the Wiki space root and `rollback_origin_space_id` is known.
|
|
110
|
+
3. If `rollback_origin_kind` is missing or `unknown`, the agent MUST try to resolve it before execution from `ResourceItem.parent_token`, traversal context, `source_path`, `space_id`, or `wiki +node-get` for Wiki resources.
|
|
111
|
+
4. If the origin is still unresolved, set `rollback_supported=false` and `rollback_blocker`, but do not block the entire execution solely because recovery is unsupported.
|
|
112
|
+
5. Target resolution remains mandatory: a move item with unresolved `target_parent_token` MUST NOT execute.
|
|
113
|
+
6. Internal recovery metadata MUST NOT change `DisplayItem` output on the normal successful path.
|
|
114
|
+
|
|
115
|
+
## DisplayItem
|
|
116
|
+
|
|
117
|
+
`DisplayItem` is for user-facing output. It MUST NOT expose raw internal enum values.
|
|
118
|
+
|
|
119
|
+
| Display Field | Source |
|
|
120
|
+
|---------------|--------|
|
|
121
|
+
| `序号` | Page-local row number |
|
|
122
|
+
| `当前位置` | `source_path` |
|
|
123
|
+
| `标题` | `title` |
|
|
124
|
+
| `类型` | Human-readable `type` when possible; raw type is acceptable only when there is no clearer label |
|
|
125
|
+
| `目标位置` | `target_path` |
|
|
126
|
+
| `动作` | Convert from `action` using action display map |
|
|
127
|
+
| `原因` | `reason` |
|
|
128
|
+
| `置信度` | Convert from `confidence` using confidence display map |
|
|
129
|
+
| `待确认原因` | `needs_review_reason` |
|
|
130
|
+
|
|
131
|
+
Action display map:
|
|
132
|
+
|
|
133
|
+
| Internal Enum | User-Facing Label |
|
|
134
|
+
|---------------|-------------------|
|
|
135
|
+
| `keep` | 保持不变 |
|
|
136
|
+
| `create_folder` | 创建文件夹 |
|
|
137
|
+
| `create_node` | 创建知识库节点 |
|
|
138
|
+
| `move` | 移动到目标目录 |
|
|
139
|
+
|
|
140
|
+
`needs_review=true` is a review state, not an action. A review item MUST still use `action=move` when its target is the manual confirmation target.
|
|
141
|
+
|
|
142
|
+
### Manual Confirmation Target
|
|
143
|
+
|
|
144
|
+
Resources with insufficient classification evidence MUST be moved to the manual confirmation target after the user confirms execution.
|
|
145
|
+
|
|
146
|
+
Rules:
|
|
147
|
+
|
|
148
|
+
1. The target tree MUST include `待人工确认` or an equivalent user-specified manual confirmation path.
|
|
149
|
+
2. For Drive scopes, the manual confirmation target is a Drive folder.
|
|
150
|
+
3. For Wiki scopes, the manual confirmation target is a Wiki node.
|
|
151
|
+
4. Plan items for these resources MUST set `needs_review=true`, preserve `needs_review_reason`, set `target_path` to the manual confirmation target, and set `action=move`.
|
|
152
|
+
5. Do not leave these items in their original location by default.
|
|
153
|
+
|
|
154
|
+
Confidence display map:
|
|
155
|
+
|
|
156
|
+
| Internal Enum | User-Facing Label |
|
|
157
|
+
|---------------|-------------------|
|
|
158
|
+
| `high` | 高,证据明确 |
|
|
159
|
+
| `medium` | 中,有依据但建议确认 |
|
|
160
|
+
| `low` | 低,需要人工确认 |
|
|
161
|
+
|
|
162
|
+
### Plan Pagination
|
|
163
|
+
|
|
164
|
+
| Output Area | Rule |
|
|
165
|
+
|-------------|------|
|
|
166
|
+
| Plan details | Show at most 20 plan items per page |
|
|
167
|
+
| Plan item count > 20 | MUST paginate; do not output all details at once |
|
|
168
|
+
| Plan item count > 500 | First response MUST show overview and filters only; no detail rows until user asks |
|
|
169
|
+
| Pagination | Affects display only; complete `plan_items` MUST remain internal |
|
|
170
|
+
|
|
171
|
+
### Target Tree And Plan Overview
|
|
172
|
+
|
|
173
|
+
```text
|
|
174
|
+
建议目标目录结构
|
|
175
|
+
|
|
176
|
+
<target_tree>
|
|
177
|
+
|
|
178
|
+
移动 / 创建计划总览
|
|
179
|
+
|
|
180
|
+
本次计划共 <total_count> 项:
|
|
181
|
+
- 创建目录 / 节点:<create_count> 项
|
|
182
|
+
- 移动资源:<move_count> 项(其中来源目录本体:<source_container_move_count> 项)
|
|
183
|
+
- 保持不变:<keep_count> 项
|
|
184
|
+
- 待人工确认:<review_count> 项
|
|
185
|
+
- 高置信度:<high_count> 项
|
|
186
|
+
- 中置信度:<medium_count> 项
|
|
187
|
+
- 低置信度:<low_count> 项
|
|
188
|
+
|
|
189
|
+
你可以选择:
|
|
190
|
+
1. 查看第 1 页明细
|
|
191
|
+
2. 只看将创建的目录 / 节点
|
|
192
|
+
3. 只看待人工确认项
|
|
193
|
+
4. 只看高置信度移动项
|
|
194
|
+
5. 进入下一步:确认执行计划
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
If `total_count > 500`, say:
|
|
198
|
+
|
|
199
|
+
```text
|
|
200
|
+
计划较大,我先只展示总览。
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
### Plan Revision Protocol
|
|
204
|
+
|
|
205
|
+
When the user corrects or adjusts the plan in `PLAN_GENERATION` or `EXEC_CONFIRM`, the agent MUST treat it as a full-plan revision unless the user explicitly asks to execute only the corrected items.
|
|
206
|
+
|
|
207
|
+
Revision triggers include:
|
|
208
|
+
|
|
209
|
+
- Adjusting classification rules.
|
|
210
|
+
- Adjusting target folder / Wiki node structure.
|
|
211
|
+
- Changing one or more resources' target paths.
|
|
212
|
+
- Excluding resources from movement.
|
|
213
|
+
- Restricting execution to high-confidence items.
|
|
214
|
+
- Moving a whole category to another target.
|
|
215
|
+
- Changing manual confirmation handling.
|
|
216
|
+
- Changing source container cleanup or retention handling.
|
|
217
|
+
|
|
218
|
+
Internal rules:
|
|
219
|
+
|
|
220
|
+
1. Record the user correction in `last_user_correction`.
|
|
221
|
+
2. Mark the previous `plan_items` as stale.
|
|
222
|
+
3. Recompute `classification_rules`, `target_tree`, and complete `plan_items` when needed.
|
|
223
|
+
4. Increment `plan_version`.
|
|
224
|
+
5. Set `active_plan_items` to the complete revised plan.
|
|
225
|
+
6. Append a short internal summary to `plan_revision_history`.
|
|
226
|
+
7. Do not execute stale `plan_items`.
|
|
227
|
+
8. Do not execute only the delta unless the user explicitly asks for partial execution.
|
|
228
|
+
|
|
229
|
+
User-facing output:
|
|
230
|
+
|
|
231
|
+
```text
|
|
232
|
+
已按你的修改重新生成完整计划。
|
|
233
|
+
|
|
234
|
+
已应用的修改:
|
|
235
|
+
- <correction item 1>
|
|
236
|
+
- <correction item 2>
|
|
237
|
+
|
|
238
|
+
当前完整计划:
|
|
239
|
+
- 创建目录 / 节点:<create_count> 项
|
|
240
|
+
- 移动资源:<move_count> 项
|
|
241
|
+
- 保持不变:<keep_count> 项
|
|
242
|
+
- 待人工确认:<review_count> 项
|
|
243
|
+
|
|
244
|
+
说明:后续执行默认基于这份完整修正版计划,不是只执行刚才的修正项。
|
|
245
|
+
|
|
246
|
+
你可以选择:
|
|
247
|
+
1. 查看修正版计划总览
|
|
248
|
+
2. 查看本次修改涉及的资源
|
|
249
|
+
3. 进入下一步:确认执行计划
|
|
250
|
+
4. 继续调整
|
|
251
|
+
```
|
|
252
|
+
|
|
253
|
+
If the user explicitly asks to execute only the corrected items, ask for confirmation before execution:
|
|
254
|
+
|
|
255
|
+
```text
|
|
256
|
+
你明确要求只执行本次修改涉及的 <count> 项。其余计划项不会执行。
|
|
257
|
+
请确认是否只执行这些项?
|
|
258
|
+
```
|
|
259
|
+
|
|
260
|
+
### Plan Detail Page
|
|
261
|
+
|
|
262
|
+
```text
|
|
263
|
+
移动 / 创建计划,第 <page>/<total_pages> 页,每页 20 项
|
|
264
|
+
|
|
265
|
+
| 序号 | 当前位置 | 标题 | 类型 | 目标位置 | 动作 | 原因 | 置信度 | 待确认原因 |
|
|
266
|
+
|------|----------|------|------|----------|------|------|--------|------------|
|
|
267
|
+
|
|
268
|
+
还有 <remaining_pages> 页未展示。
|
|
269
|
+
|
|
270
|
+
你可以回复:
|
|
271
|
+
1. 继续看下一页
|
|
272
|
+
2. 只看待人工确认项
|
|
273
|
+
3. 只看低置信度项
|
|
274
|
+
4. 进入下一步:确认执行计划
|
|
275
|
+
```
|
|
276
|
+
|
|
277
|
+
## State: EXEC_CONFIRM
|
|
278
|
+
|
|
279
|
+
Entry: user asks to view execution confirmation or continue toward execution.
|
|
280
|
+
|
|
281
|
+
MUST:
|
|
282
|
+
|
|
283
|
+
1. Show write-operation summary:
|
|
284
|
+
- 将创建哪些目录 / 节点
|
|
285
|
+
- 将移动哪些资源
|
|
286
|
+
- 将移动哪些来源目录本体(如有)
|
|
287
|
+
- 哪些资源仍需人工确认
|
|
288
|
+
- 预计影响范围
|
|
289
|
+
2. Use `active_plan_items` from the latest complete plan.
|
|
290
|
+
3. Show `Permission Inheritance Notice`.
|
|
291
|
+
4. Ask for execution scope using `Execution Confirmation`.
|
|
292
|
+
5. Reference `Non-goals` for operations excluded from this workflow.
|
|
293
|
+
6. Wait for explicit confirmation.
|
|
294
|
+
|
|
295
|
+
### Permission Inheritance Notice
|
|
296
|
+
|
|
297
|
+
Before execution confirmation, MUST show this notice:
|
|
298
|
+
|
|
299
|
+
```text
|
|
300
|
+
权限提示:移动资源后,资源权限可能随目标位置变化,可见范围或协作权限可能变化。本 workflow 不会自动修改权限。
|
|
301
|
+
```
|
|
302
|
+
|
|
303
|
+
### Execution Confirmation
|
|
304
|
+
|
|
305
|
+
When the user wants execution, ask for execution scope:
|
|
306
|
+
|
|
307
|
+
Execution confirmation options MUST be numbered by currently available choices. Do not show disabled choices, and do not ask the user to reply with skipped numbers.
|
|
308
|
+
|
|
309
|
+
If a plan detail page is currently active:
|
|
310
|
+
|
|
311
|
+
```text
|
|
312
|
+
请确认执行范围:
|
|
313
|
+
|
|
314
|
+
1. 执行完整计划:<total_count> 项
|
|
315
|
+
2. 只执行当前页:<current_page_count> 项
|
|
316
|
+
3. 只执行高置信度项:<high_confidence_count> 项
|
|
317
|
+
4. 暂不执行,只保留方案
|
|
318
|
+
|
|
319
|
+
本 workflow 只执行已确认范围内的创建、移动和必要的单资源权限申请;不会重命名任何资源。
|
|
320
|
+
```
|
|
321
|
+
|
|
322
|
+
If no plan detail page is currently active:
|
|
323
|
+
|
|
324
|
+
```text
|
|
325
|
+
请确认执行范围:
|
|
326
|
+
|
|
327
|
+
1. 执行完整计划:<total_count> 项
|
|
328
|
+
2. 只执行高置信度项:<high_confidence_count> 项
|
|
329
|
+
3. 暂不执行,只保留方案
|
|
330
|
+
|
|
331
|
+
如需只执行某一页,请先查看计划明细页。
|
|
332
|
+
|
|
333
|
+
本 workflow 只执行已确认范围内的创建、移动和必要的单资源权限申请;不会重命名任何资源。
|
|
334
|
+
```
|
|
335
|
+
|
|
336
|
+
If there is no pagination, still state the total number of plan items covered by confirmation.
|
|
@@ -0,0 +1,308 @@
|
|
|
1
|
+
# 知识整理工作流:Rollback
|
|
2
|
+
|
|
3
|
+
Loaded by states: `ROLLBACK_CONFIRM`, `ROLLBACK`, `ROLLBACK_VERIFY`, `ROLLBACK_CLEANUP_CONFIRM`, `ROLLBACK_CLEANUP`, `ROLLBACK_CLEANUP_VERIFY`.
|
|
4
|
+
|
|
5
|
+
This file owns recovery plan generation, recovery confirmation, recovery execution, recovery verification, cleanup confirmation, cleanup execution, and cleanup verification. It also defines the internal `rollback_snapshot` and `execution_journal` contracts.
|
|
6
|
+
|
|
7
|
+
It MUST NOT generate organization plans, revise classification rules, execute unconfirmed deletes, rename resources, modify permissions, or use `wiki +move` docs-to-wiki mode.
|
|
8
|
+
|
|
9
|
+
User-facing language should use "恢复到整理前的位置" / "恢复". Internal state and field names may use `rollback`.
|
|
10
|
+
|
|
11
|
+
## Required Context
|
|
12
|
+
|
|
13
|
+
Before executing rules in this file:
|
|
14
|
+
|
|
15
|
+
1. `active_plan_items`, `execution_scope`, `target_scope`, and `path_token_map` MUST already exist.
|
|
16
|
+
2. `rollback_snapshot` MUST have been built before the first write operation in `EXECUTE`.
|
|
17
|
+
3. `execution_journal` MUST contain write-operation results from `EXECUTE`.
|
|
18
|
+
4. Follow command syntax and risk behavior from referenced shortcut docs.
|
|
19
|
+
5. Follow `Non-goals` from the main workflow entry.
|
|
20
|
+
|
|
21
|
+
## Normal Path Visibility
|
|
22
|
+
|
|
23
|
+
Do not mention rollback, recovery readiness, snapshot, or journal on the normal successful execution path.
|
|
24
|
+
|
|
25
|
+
Load this file only after:
|
|
26
|
+
|
|
27
|
+
1. Execution failed after one or more successful moves and the user chose to try restoring.
|
|
28
|
+
2. Verification found serious mismatches and the user chose to try restoring.
|
|
29
|
+
3. The user explicitly asks to rollback / recover the previous organization run.
|
|
30
|
+
|
|
31
|
+
## Internal State Contracts
|
|
32
|
+
|
|
33
|
+
### RollbackSnapshot
|
|
34
|
+
|
|
35
|
+
`rollback_snapshot` records original locations before any write command.
|
|
36
|
+
|
|
37
|
+
Fields:
|
|
38
|
+
|
|
39
|
+
| Field | Meaning |
|
|
40
|
+
|-------|---------|
|
|
41
|
+
| `plan_id` | Matching `PlanItem.plan_id` |
|
|
42
|
+
| `source_kind` | `drive` / `wiki` |
|
|
43
|
+
| `title` | Resource title |
|
|
44
|
+
| `type` | Resource type used by move commands |
|
|
45
|
+
| `original_token` | Original Drive token when applicable |
|
|
46
|
+
| `original_node_token` | Original Wiki node token when applicable |
|
|
47
|
+
| `original_parent_kind` | `drive_folder` / `drive_root` / `wiki_node` / `wiki_space_root` / `unknown` |
|
|
48
|
+
| `original_parent_token` | Original parent token; empty for root markers |
|
|
49
|
+
| `original_space_id` | Original Wiki space ID when restoring to Wiki space root |
|
|
50
|
+
| `original_path` | Original path before organization |
|
|
51
|
+
| `planned_target_parent_token` | Planned target parent token |
|
|
52
|
+
| `planned_target_path` | Planned target path |
|
|
53
|
+
| `rollback_supported` | Whether this item can be restored automatically |
|
|
54
|
+
| `rollback_blocker` | Reason when `rollback_supported=false` |
|
|
55
|
+
|
|
56
|
+
Rules:
|
|
57
|
+
|
|
58
|
+
1. Store compact fields only. Do not store full API responses.
|
|
59
|
+
2. `drive_root` and `wiki_space_root` are valid origins; do not treat empty parent token as missing when the root marker is known.
|
|
60
|
+
3. Items without reliable origin can still execute, but MUST be marked `rollback_supported=false`.
|
|
61
|
+
|
|
62
|
+
### ExecutionJournal
|
|
63
|
+
|
|
64
|
+
`execution_journal` records every write attempt.
|
|
65
|
+
|
|
66
|
+
Fields:
|
|
67
|
+
|
|
68
|
+
| Field | Meaning |
|
|
69
|
+
|-------|---------|
|
|
70
|
+
| `journal_id` | Stable journal row ID |
|
|
71
|
+
| `plan_id` | Matching `PlanItem.plan_id` when applicable |
|
|
72
|
+
| `operation` | `create_folder` / `create_node` / `move_drive` / `move_wiki_node` / `delete_created_folder` / `delete_created_node` |
|
|
73
|
+
| `status` | `success` / `failed` / `pending` |
|
|
74
|
+
| `input_token` | Token supplied to the command |
|
|
75
|
+
| `input_node_token` | Wiki node token supplied to the command |
|
|
76
|
+
| `input_parent_token` | Source parent token when known |
|
|
77
|
+
| `target_parent_token` | Target parent token supplied to the command |
|
|
78
|
+
| `returned_token` | Token returned by the command |
|
|
79
|
+
| `returned_node_token` | Wiki node token returned by the command |
|
|
80
|
+
| `returned_parent_token` | Parent token returned by the command |
|
|
81
|
+
| `task_id` | Async task ID when returned |
|
|
82
|
+
| `next_command` | Async continuation command when returned |
|
|
83
|
+
| `error` | Error summary when failed |
|
|
84
|
+
| `created_by_workflow` | Whether the resource was created by this workflow run |
|
|
85
|
+
| `rollback_eligible` | Whether this successful operation can be included in `rollback_plan` |
|
|
86
|
+
|
|
87
|
+
Rules:
|
|
88
|
+
|
|
89
|
+
1. Append a journal entry immediately after each write attempt.
|
|
90
|
+
2. `create_folder` and `create_node` entries MUST set `created_by_workflow=true`.
|
|
91
|
+
3. Successful `move_drive` and `move_wiki_node` entries may set `rollback_eligible=true` only when matching snapshot origin is supported.
|
|
92
|
+
4. Failed or pending moves MUST NOT enter automatic recovery execution.
|
|
93
|
+
5. Async operations are `pending` until `drive +task_result` proves completion.
|
|
94
|
+
|
|
95
|
+
## State: ROLLBACK_CONFIRM
|
|
96
|
+
|
|
97
|
+
Entry: user chose to try restoring after execution failure / verification mismatch, or explicitly asked to rollback.
|
|
98
|
+
|
|
99
|
+
MUST:
|
|
100
|
+
|
|
101
|
+
1. Generate `rollback_plan` from successful eligible move journal entries.
|
|
102
|
+
2. Use `execution_journal` current token / current node token as the recovery source.
|
|
103
|
+
3. Use `rollback_snapshot` original origin as the recovery target.
|
|
104
|
+
4. Generate recovery items in reverse successful move order.
|
|
105
|
+
5. Exclude failed, pending, and unsupported items from executable recovery.
|
|
106
|
+
6. Do not include delete actions in `rollback_plan`.
|
|
107
|
+
7. Ask for explicit restore execution confirmation.
|
|
108
|
+
|
|
109
|
+
Confirmation output:
|
|
110
|
+
|
|
111
|
+
```text
|
|
112
|
+
可恢复范围如下:
|
|
113
|
+
|
|
114
|
+
| 项目 | 数量 |
|
|
115
|
+
|------|------|
|
|
116
|
+
| 可尝试恢复到原位置 | <recoverable_move_count> |
|
|
117
|
+
| 无法安全自动恢复 | <unsupported_count> |
|
|
118
|
+
| 未完成 / 等待中的移动 | <pending_count> |
|
|
119
|
+
| 本次新建目录 / 节点 | <created_container_count> |
|
|
120
|
+
|
|
121
|
+
恢复操作只会尝试把已成功移动的资源移回原位置,不会删除、重命名或修改权限。是否执行恢复?
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
If no move can be restored automatically, report that no automatic restore is available and move to `DONE`.
|
|
125
|
+
|
|
126
|
+
## Recovery Command Rules
|
|
127
|
+
|
|
128
|
+
Use only these command forms:
|
|
129
|
+
|
|
130
|
+
```bash
|
|
131
|
+
# Drive resource back to original parent folder
|
|
132
|
+
lark-cli drive +move \
|
|
133
|
+
--file-token <current_token> \
|
|
134
|
+
--type <type> \
|
|
135
|
+
--folder-token <original_parent_token>
|
|
136
|
+
|
|
137
|
+
# Drive resource back to root
|
|
138
|
+
lark-cli drive +move \
|
|
139
|
+
--file-token <current_token> \
|
|
140
|
+
--type <type>
|
|
141
|
+
|
|
142
|
+
# Wiki node back to original parent node
|
|
143
|
+
lark-cli wiki +move \
|
|
144
|
+
--node-token <current_node_token> \
|
|
145
|
+
--target-parent-token <original_parent_token>
|
|
146
|
+
|
|
147
|
+
# Wiki node back to original space root
|
|
148
|
+
lark-cli wiki +move \
|
|
149
|
+
--node-token <current_node_token> \
|
|
150
|
+
--target-space-id <original_space_id>
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
MUST NOT:
|
|
154
|
+
|
|
155
|
+
- Use `wiki +move` docs-to-wiki mode.
|
|
156
|
+
- Move using path strings.
|
|
157
|
+
- Recover failed or pending moves as if they succeeded.
|
|
158
|
+
- Delete created folders / nodes in `ROLLBACK`.
|
|
159
|
+
|
|
160
|
+
## State: ROLLBACK
|
|
161
|
+
|
|
162
|
+
Entry: user explicitly confirmed restore execution.
|
|
163
|
+
|
|
164
|
+
MUST:
|
|
165
|
+
|
|
166
|
+
1. Execute only confirmed `rollback_plan` items.
|
|
167
|
+
2. Execute reverse moves in reverse successful move order.
|
|
168
|
+
3. Continue async move tasks with `drive +task_result` when needed.
|
|
169
|
+
4. Record recovery success / failure per rollback item.
|
|
170
|
+
5. Stop on blockers that make following recovery items unsafe.
|
|
171
|
+
|
|
172
|
+
Progress output should stay concise:
|
|
173
|
+
|
|
174
|
+
```text
|
|
175
|
+
恢复进度:已尝试 <done>/<total> 项,失败 <failed_count> 项。
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
## State: ROLLBACK_VERIFY
|
|
179
|
+
|
|
180
|
+
Entry: recovery execution finished.
|
|
181
|
+
|
|
182
|
+
MUST:
|
|
183
|
+
|
|
184
|
+
1. Rescan the relevant Drive folder / Wiki nodes.
|
|
185
|
+
2. Compare each rollback item with its original origin.
|
|
186
|
+
3. Mark status per item.
|
|
187
|
+
4. If cleanup candidates clearly remain from this workflow run, transition to `ROLLBACK_CLEANUP_CONFIRM`.
|
|
188
|
+
5. Do not ask for deletion confirmation in this state.
|
|
189
|
+
|
|
190
|
+
Verification table:
|
|
191
|
+
|
|
192
|
+
| plan_id | 标题 | 原位置 | 当前实际位置 | 状态 | 失败原因 |
|
|
193
|
+
|---------|------|--------|--------------|------|----------|
|
|
194
|
+
|
|
195
|
+
Status values:
|
|
196
|
+
|
|
197
|
+
| Status | Meaning |
|
|
198
|
+
|--------|---------|
|
|
199
|
+
| `rollback_success` | Resource is back under the original parent / root |
|
|
200
|
+
| `rollback_failed` | Resource is still outside the original origin |
|
|
201
|
+
| `missing` | Resource cannot be found |
|
|
202
|
+
| `needs_manual_review` | Actual state is ambiguous or affected by external changes |
|
|
203
|
+
|
|
204
|
+
Do not delete anything from this state.
|
|
205
|
+
|
|
206
|
+
## State: ROLLBACK_CLEANUP_CONFIRM
|
|
207
|
+
|
|
208
|
+
Entry: cleanup candidates exist after recovery, or user asks to view / perform cleanup after recovery.
|
|
209
|
+
|
|
210
|
+
Cleanup is optional and separate from recovery. It may delete resources, so it requires separate confirmation.
|
|
211
|
+
|
|
212
|
+
Candidate rules:
|
|
213
|
+
|
|
214
|
+
1. Candidate MUST have `created_by_workflow=true` in `execution_journal`.
|
|
215
|
+
2. Candidate MUST be a Drive folder or Wiki node created by this workflow run.
|
|
216
|
+
3. Candidate MUST currently be empty, or contain only workflow-created cleanup candidates that are themselves safe to delete.
|
|
217
|
+
4. Candidate MUST NOT contain original resources, unknown resources, rollback-failed resources, or user-created resources.
|
|
218
|
+
5. If child origin is uncertain, mark the candidate `cleanup_blocked`.
|
|
219
|
+
|
|
220
|
+
Generate `rollback_cleanup_plan` with:
|
|
221
|
+
|
|
222
|
+
| Field | Meaning |
|
|
223
|
+
|-------|---------|
|
|
224
|
+
| `cleanup_id` | Stable cleanup row ID |
|
|
225
|
+
| `type` | `drive_folder` / `wiki_node` |
|
|
226
|
+
| `path` | Current path |
|
|
227
|
+
| `token` | Folder token or node token |
|
|
228
|
+
| `depth` | Current path depth |
|
|
229
|
+
| `safe_to_delete` | Whether deletion is allowed after confirmation |
|
|
230
|
+
| `blocker` | Reason when deletion is blocked |
|
|
231
|
+
|
|
232
|
+
Confirmation output:
|
|
233
|
+
|
|
234
|
+
```text
|
|
235
|
+
恢复已完成。本次整理新建的部分空目录 / 节点如下,是否需要删除?
|
|
236
|
+
|
|
237
|
+
| 项目 | 数量 |
|
|
238
|
+
|------|------|
|
|
239
|
+
| 可删除的新建空目录 / 节点 | <safe_count> |
|
|
240
|
+
| 不可删除,需人工确认 | <blocked_count> |
|
|
241
|
+
|
|
242
|
+
注:删除只会作用于本次 workflow 新建且当前可安全清理的空目录 / 节点。
|
|
243
|
+
```
|
|
244
|
+
|
|
245
|
+
If the user wants details, paginate cleanup items at 20 rows per page.
|
|
246
|
+
|
|
247
|
+
## State: ROLLBACK_CLEANUP
|
|
248
|
+
|
|
249
|
+
Entry: user explicitly confirmed cleanup deletion.
|
|
250
|
+
|
|
251
|
+
MUST:
|
|
252
|
+
|
|
253
|
+
1. Delete only `safe_to_delete=true` cleanup items.
|
|
254
|
+
2. Delete deepest paths first.
|
|
255
|
+
3. Record delete results in `rollback_cleanup_results`.
|
|
256
|
+
4. Continue async delete tasks with `drive +task_result` when needed.
|
|
257
|
+
|
|
258
|
+
Command forms:
|
|
259
|
+
|
|
260
|
+
```bash
|
|
261
|
+
# Delete workflow-created Drive folder
|
|
262
|
+
lark-cli drive +delete \
|
|
263
|
+
--file-token <folder_token> \
|
|
264
|
+
--type folder \
|
|
265
|
+
--yes
|
|
266
|
+
|
|
267
|
+
# Delete workflow-created Wiki node
|
|
268
|
+
lark-cli wiki +node-delete \
|
|
269
|
+
--node-token <node_token> \
|
|
270
|
+
--obj-type wiki \
|
|
271
|
+
--include-children=true \
|
|
272
|
+
--yes
|
|
273
|
+
```
|
|
274
|
+
|
|
275
|
+
`--yes` is allowed only after the user explicitly confirmed cleanup deletion.
|
|
276
|
+
|
|
277
|
+
MUST NOT:
|
|
278
|
+
|
|
279
|
+
- Delete original resources.
|
|
280
|
+
- Delete unknown resources.
|
|
281
|
+
- Delete rollback-failed resources.
|
|
282
|
+
- Delete non-empty folders / nodes that contain anything outside cleanup candidates.
|
|
283
|
+
- Delete a knowledge space.
|
|
284
|
+
|
|
285
|
+
## State: ROLLBACK_CLEANUP_VERIFY
|
|
286
|
+
|
|
287
|
+
Entry: cleanup deletion finished.
|
|
288
|
+
|
|
289
|
+
MUST:
|
|
290
|
+
|
|
291
|
+
1. Verify each confirmed cleanup target is gone.
|
|
292
|
+
2. Report failed or pending deletes.
|
|
293
|
+
3. Stop after reporting cleanup results.
|
|
294
|
+
|
|
295
|
+
Verification table:
|
|
296
|
+
|
|
297
|
+
| 类型 | 路径 | token | 状态 | 失败原因 |
|
|
298
|
+
|------|------|-------|------|----------|
|
|
299
|
+
|
|
300
|
+
Status values:
|
|
301
|
+
|
|
302
|
+
| Status | Meaning |
|
|
303
|
+
|--------|---------|
|
|
304
|
+
| `deleted` | Cleanup target was deleted |
|
|
305
|
+
| `delete_pending` | Async deletion is still pending |
|
|
306
|
+
| `delete_failed` | Delete command failed |
|
|
307
|
+
| `still_exists` | Target still exists after deletion attempt |
|
|
308
|
+
| `skipped` | Target was not safe to delete or user did not confirm it |
|