{"owner":"larksuite","repo":"cli","hasSkills":true,"totalSkillsCount":527,"totalTokensCount":1148598,"categories":["root-instruction","anthropic-skill","subagent-persona","cursor-rule"],"hasMcp":false,"mcpConfig":null,"found":["AGENTS.md","internal/qualitygate/skillscan/testdata/skills/lark-demo/SKILL.md","isolated-skills/lark-suite/SKILL.md","scripts/skill-format-check/tests/bad-skill-no-frontmatter/SKILL.md","scripts/skill-format-check/tests/bad-skill-unclosed-frontmatter/SKILL.md","scripts/skill-format-check/tests/bad-skill/SKILL.md","scripts/skill-format-check/tests/good-skill-complex/SKILL.md","scripts/skill-format-check/tests/good-skill-minimal/SKILL.md","scripts/skill-format-check/tests/good-skill/SKILL.md","skills/lark-approval/SKILL.md","skills/lark-approval/references/lark-approval-approvals-get.md","skills/lark-approval/references/lark-approval-approvals-search.md","skills/lark-approval/references/lark-approval-initiate.md","skills/lark-approval/references/lark-approval-instance-form-control-parameters.md","skills/lark-approval/references/lark-approval-instance-value-sourcing.md","skills/lark-approval/references/lark-approval-instances-cancel.md","skills/lark-approval/references/lark-approval-instances-cc.md","skills/lark-approval/references/lark-approval-instances-get.md","skills/lark-approval/references/lark-approval-instances-initiated.md","skills/lark-approval/references/lark-approval-tasks-add-sign.md","skills/lark-approval/references/lark-approval-tasks-approve.md","skills/lark-approval/references/lark-approval-tasks-query.md","skills/lark-approval/references/lark-approval-tasks-reject.md","skills/lark-approval/references/lark-approval-tasks-remind.md","skills/lark-approval/references/lark-approval-tasks-rollback.md","skills/lark-approval/references/lark-approval-tasks-transfer.md","skills/lark-apps/SKILL.md","skills/lark-apps/creative-design/agents/fork-verifier-agent.md","skills/lark-apps/creative-design/agents/vision-probe-agent.md","skills/lark-apps/creative-design/creative-design.md","skills/lark-apps/creative-design/references/aily.md","skills/lark-apps/creative-design/references/animated-video.md","skills/lark-apps/creative-design/references/charts.md","skills/lark-apps/creative-design/references/claude.md","skills/lark-apps/creative-design/references/codex.md","skills/lark-apps/creative-design/references/data-report.md","skills/lark-apps/creative-design/references/frontend-design.md","skills/lark-apps/creative-design/references/hi-fi-design.md","skills/lark-apps/creative-design/references/interactive-prototype.md","skills/lark-apps/creative-design/references/make-a-deck.md","skills/lark-apps/creative-design/references/visual-exposure.md","skills/lark-apps/creative-design/references/wireframe.md","skills/lark-apps/references/lark-apps-access-scope-get.md","skills/lark-apps/references/lark-apps-access-scope-set.md","skills/lark-apps/references/lark-apps-automation.md","skills/lark-apps/references/lark-apps-cache.md","skills/lark-apps/references/lark-apps-cloud-dev.md","skills/lark-apps/references/lark-apps-create.md","skills/lark-apps/references/lark-apps-db-execute.md","skills/lark-apps/references/lark-apps-db.md","skills/lark-apps/references/lark-apps-env-pull.md","skills/lark-apps/references/lark-apps-env.md","skills/lark-apps/references/lark-apps-export.md","skills/lark-apps/references/lark-apps-file.md","skills/lark-apps/references/lark-apps-get.md","skills/lark-apps/references/lark-apps-git-credential.md","skills/lark-apps/references/lark-apps-html-publish.md","skills/lark-apps/references/lark-apps-init.md","skills/lark-apps/references/lark-apps-list.md","skills/lark-apps/references/lark-apps-local-dev.md","skills/lark-apps/references/lark-apps-observability.md","skills/lark-apps/references/lark-apps-openapi-key.md","skills/lark-apps/references/lark-apps-plugin-install.md","skills/lark-apps/references/lark-apps-plugin-list.md","skills/lark-apps/references/lark-apps-plugin-uninstall.md","skills/lark-apps/references/lark-apps-release-create.md","skills/lark-apps/references/lark-apps-release-get.md","skills/lark-apps/references/lark-apps-release-list.md","skills/lark-apps/references/lark-apps-role.md","skills/lark-apps/references/lark-apps-session-messages-list.md","skills/lark-apps/references/lark-apps-update.md","skills/lark-apps/references/lark-apps-user-id-convert.md","skills/lark-attendance/SKILL.md","skills/lark-base/SKILL.md","skills/lark-base/references/lark-base-advanced-permission-and-role.md","skills/lark-base/references/lark-base-app-block-data-config.md","skills/lark-base/references/lark-base-app.md","skills/lark-base/references/lark-base-dashboard-block-config.md","skills/lark-base/references/lark-base-dashboard-block-get-data.md","skills/lark-base/references/lark-base-dashboard.md","skills/lark-base/references/lark-base-data-query.md","skills/lark-base/references/lark-base-field-create.md","skills/lark-base/references/lark-base-field-extension.md","skills/lark-base/references/lark-base-field-formula.md","skills/lark-base/references/lark-base-field-lookup.md","skills/lark-base/references/lark-base-field-schema.md","skills/lark-base/references/lark-base-field-update.md","skills/lark-base/references/lark-base-filter-condition.md","skills/lark-base/references/lark-base-form-detail.md","skills/lark-base/references/lark-base-form-questions-create.md","skills/lark-base/references/lark-base-form-questions-update.md","skills/lark-base/references/lark-base-form-submit.md","skills/lark-base/references/lark-base-record-history-list.md","skills/lark-base/references/lark-base-record-query-and-analysis-sop.md","skills/lark-base/references/lark-base-role-config.md","skills/lark-base/references/lark-base-template-center.md","skills/lark-base/references/lark-base-view-set-filter.md","skills/lark-base/references/lark-base-view.md","skills/lark-base/references/lark-base-workflow-schema.md","skills/lark-base/references/lark-base-workflow.md","skills/lark-calendar/SKILL.md","skills/lark-calendar/references/lark-calendar-create.md","skills/lark-calendar/references/lark-calendar-join-event.md","skills/lark-calendar/references/lark-calendar-list-attendees.md","skills/lark-calendar/references/lark-calendar-meeting-relation.md","skills/lark-calendar/references/lark-calendar-meeting.md","skills/lark-calendar/references/lark-calendar-recurring.md","skills/lark-calendar/references/lark-calendar-room-find.md","skills/lark-calendar/references/lark-calendar-rsvp.md","skills/lark-calendar/references/lark-calendar-schedule-clear-time.md","skills/lark-calendar/references/lark-calendar-schedule-fuzzy-time.md","skills/lark-calendar/references/lark-calendar-schedule-meeting.md","skills/lark-calendar/references/lark-calendar-suggestion.md","skills/lark-calendar/references/lark-calendar-transfer.md","skills/lark-calendar/references/lark-calendar-update.md","skills/lark-contact/SKILL.md","skills/lark-contact/references/lark-contact-get-user.md","skills/lark-contact/references/lark-contact-search-bot.md","skills/lark-contact/references/lark-contact-search-user.md","skills/lark-doc/SKILL.md","skills/lark-doc/references/genres/business-analysis.md","skills/lark-doc/references/genres/data-report.md","skills/lark-doc/references/genres/email.md","skills/lark-doc/references/genres/execution-plan.md","skills/lark-doc/references/genres/formal-doc.md","skills/lark-doc/references/genres/meeting-minutes.md","skills/lark-doc/references/genres/memo-brief.md","skills/lark-doc/references/genres/official-redhead.md","skills/lark-doc/references/genres/prd.md","skills/lark-doc/references/genres/proposal.md","skills/lark-doc/references/genres/research-report.md","skills/lark-doc/references/genres/retrospective.md","skills/lark-doc/references/genres/route-consumer.md","skills/lark-doc/references/genres/route-creative.md","skills/lark-doc/references/genres/route-knowledge.md","skills/lark-doc/references/genres/route-marketing.md","skills/lark-doc/references/genres/route-media.md","skills/lark-doc/references/genres/route-opinion.md","skills/lark-doc/references/genres/route-personal-brand.md","skills/lark-doc/references/genres/route-platform.md","skills/lark-doc/references/genres/route-report.md","skills/lark-doc/references/genres/route-workplace.md","skills/lark-doc/references/genres/sop-tutorial.md","skills/lark-doc/references/genres/technical-doc.md","skills/lark-doc/references/genres/wechat.md","skills/lark-doc/references/genres/weekly-report.md","skills/lark-doc/references/genres/white-paper.md","skills/lark-doc/references/genres/xiaohongshu.md","skills/lark-doc/references/lark-doc-create-workflow.md","skills/lark-doc/references/lark-doc-create.md","skills/lark-doc/references/lark-doc-fetch.md","skills/lark-doc/references/lark-doc-history.md","skills/lark-doc/references/lark-doc-md.md","skills/lark-doc/references/lark-doc-media-download.md","skills/lark-doc/references/lark-doc-media-insert.md","skills/lark-doc/references/lark-doc-media-preview.md","skills/lark-doc/references/lark-doc-mindnote.md","skills/lark-doc/references/lark-doc-resource-cover.md","skills/lark-doc/references/lark-doc-script.md","skills/lark-doc/references/lark-doc-update.md","skills/lark-doc/references/lark-doc-whiteboard.md","skills/lark-doc/references/lark-doc-xml-extended-blocks.md","skills/lark-doc/references/lark-doc-xml.md","skills/lark-drive/SKILL.md","skills/lark-drive/references/lark-drive-add-comment.md","skills/lark-drive/references/lark-drive-add-reply.md","skills/lark-drive/references/lark-drive-apply-permission.md","skills/lark-drive/references/lark-drive-batch-query-comments.md","skills/lark-drive/references/lark-drive-comment-content.md","skills/lark-drive/references/lark-drive-comment-location.md","skills/lark-drive/references/lark-drive-copy.md","skills/lark-drive/references/lark-drive-cover.md","skills/lark-drive/references/lark-drive-create-folder.md","skills/lark-drive/references/lark-drive-create-shortcut.md","skills/lark-drive/references/lark-drive-delete-reply.md","skills/lark-drive/references/lark-drive-delete.md","skills/lark-drive/references/lark-drive-download.md","skills/lark-drive/references/lark-drive-export-download.md","skills/lark-drive/references/lark-drive-export.md","skills/lark-drive/references/lark-drive-files-list.md","skills/lark-drive/references/lark-drive-import.md","skills/lark-drive/references/lark-drive-inspect.md","skills/lark-drive/references/lark-drive-list-comments.md","skills/lark-drive/references/lark-drive-list-replies.md","skills/lark-drive/references/lark-drive-member-add.md","skills/lark-drive/references/lark-drive-member-list.md","skills/lark-drive/references/lark-drive-member-remove.md","skills/lark-drive/references/lark-drive-move.md","skills/lark-drive/references/lark-drive-permission-get-setting.md","skills/lark-drive/references/lark-drive-permission-guide.md","skills/lark-drive/references/lark-drive-preview.md","skills/lark-drive/references/lark-drive-pull.md","skills/lark-drive/references/lark-drive-push.md","skills/lark-drive/references/lark-drive-react-reply.md","skills/lark-drive/references/lark-drive-reactions.md","skills/lark-drive/references/lark-drive-resolve-comment.md","skills/lark-drive/references/lark-drive-restore-comment.md","skills/lark-drive/references/lark-drive-search.md","skills/lark-drive/references/lark-drive-secure-label.md","skills/lark-drive/references/lark-drive-status.md","skills/lark-drive/references/lark-drive-task-result.md","skills/lark-drive/references/lark-drive-update-reply.md","skills/lark-drive/references/lark-drive-update-title.md","skills/lark-drive/references/lark-drive-upload.md","skills/lark-drive/references/lark-drive-version-delete.md","skills/lark-drive/references/lark-drive-version-get.md","skills/lark-drive/references/lark-drive-version-history.md","skills/lark-drive/references/lark-drive-version-revert.md","skills/lark-drive/references/lark-drive-workflow-knowledge-organize-analysis.md","skills/lark-drive/references/lark-drive-workflow-knowledge-organize-discovery.md","skills/lark-drive/references/lark-drive-workflow-knowledge-organize-execution.md","skills/lark-drive/references/lark-drive-workflow-knowledge-organize-planning.md","skills/lark-drive/references/lark-drive-workflow-knowledge-organize-rollback.md","skills/lark-drive/references/lark-drive-workflow-knowledge-organize.md","skills/lark-drive/references/lark-drive-workflow-permission-governance-commands.md","skills/lark-drive/references/lark-drive-workflow-permission-governance-outputs.md","skills/lark-drive/references/lark-drive-workflow-permission-governance.md","skills/lark-drive/references/lark-drive-workflow-topic-move-collector-execute.md","skills/lark-drive/references/lark-drive-workflow-topic-move-collector-recall.md","skills/lark-drive/references/lark-drive-workflow-topic-move-collector-resolve-verify.md","skills/lark-drive/references/lark-drive-workflow-topic-move-collector-review-plan.md","skills/lark-drive/references/lark-drive-workflow-topic-move-collector-setup.md","skills/lark-drive/references/lark-drive-workflow-topic-move-collector.md","skills/lark-drive/references/lark-drive-workflow.md","skills/lark-event/SKILL.md","skills/lark-event/references/lark-event-application.md","skills/lark-event/references/lark-event-approval.md","skills/lark-event/references/lark-event-im.md","skills/lark-event/references/lark-event-minutes.md","skills/lark-event/references/lark-event-task.md","skills/lark-event/references/lark-event-vc.md","skills/lark-event/references/lark-event-whiteboard.md","skills/lark-im/SKILL.md","skills/lark-im/references/card/card-2.0-schema.md","skills/lark-im/references/card/components/button.md","skills/lark-im/references/card/components/chart.md","skills/lark-im/references/card/components/checker.md","skills/lark-im/references/card/components/collapsible_panel.md","skills/lark-im/references/card/components/column_set.md","skills/lark-im/references/card/components/date_picker.md","skills/lark-im/references/card/components/div.md","skills/lark-im/references/card/components/form.md","skills/lark-im/references/card/components/header.md","skills/lark-im/references/card/components/hr.md","skills/lark-im/references/card/components/img.md","skills/lark-im/references/card/components/img_combination.md","skills/lark-im/references/card/components/input.md","skills/lark-im/references/card/components/interactive_container.md","skills/lark-im/references/card/components/markdown.md","skills/lark-im/references/card/components/multi_select_person.md","skills/lark-im/references/card/components/multi_select_static.md","skills/lark-im/references/card/components/overflow.md","skills/lark-im/references/card/components/person.md","skills/lark-im/references/card/components/person_list.md","skills/lark-im/references/card/components/picker_datetime.md","skills/lark-im/references/card/components/picker_time.md","skills/lark-im/references/card/components/recycling_container.md","skills/lark-im/references/card/components/select_img.md","skills/lark-im/references/card/components/select_person.md","skills/lark-im/references/card/components/select_static.md","skills/lark-im/references/card/components/table.md","skills/lark-im/references/card/lark-im-card-create.md","skills/lark-im/references/card/lark-im-card-style.md","skills/lark-im/references/card/resource/colors.md","skills/lark-im/references/card/resource/icons.md","skills/lark-im/references/lark-im-card-action-reply.md","skills/lark-im/references/lark-im-chat-create.md","skills/lark-im/references/lark-im-chat-identity.md","skills/lark-im/references/lark-im-chat-list.md","skills/lark-im/references/lark-im-chat-members-list.md","skills/lark-im/references/lark-im-chat-messages-list.md","skills/lark-im/references/lark-im-chat-search.md","skills/lark-im/references/lark-im-chat-update.md","skills/lark-im/references/lark-im-feed-group-list-item.md","skills/lark-im/references/lark-im-feed-group-list.md","skills/lark-im/references/lark-im-feed-group-query-item.md","skills/lark-im/references/lark-im-feed-groups.md","skills/lark-im/references/lark-im-feed-shortcut-create.md","skills/lark-im/references/lark-im-feed-shortcut-list.md","skills/lark-im/references/lark-im-feed-shortcut-remove.md","skills/lark-im/references/lark-im-flag-cancel.md","skills/lark-im/references/lark-im-flag-create.md","skills/lark-im/references/lark-im-flag-list.md","skills/lark-im/references/lark-im-message-enrichment.md","skills/lark-im/references/lark-im-message-read-status.md","skills/lark-im/references/lark-im-messages-edit.md","skills/lark-im/references/lark-im-messages-mget.md","skills/lark-im/references/lark-im-messages-reply.md","skills/lark-im/references/lark-im-messages-resources-download.md","skills/lark-im/references/lark-im-messages-search.md","skills/lark-im/references/lark-im-messages-send.md","skills/lark-im/references/lark-im-reactions.md","skills/lark-im/references/lark-im-threads-messages-list.md","skills/lark-mail/SKILL.md","skills/lark-mail/references/lark-mail-calendar-invite.md","skills/lark-mail/references/lark-mail-decline-receipt.md","skills/lark-mail/references/lark-mail-draft-create.md","skills/lark-mail/references/lark-mail-draft-edit.md","skills/lark-mail/references/lark-mail-forward.md","skills/lark-mail/references/lark-mail-html.md","skills/lark-mail/references/lark-mail-lint-html.md","skills/lark-mail/references/lark-mail-message-modify.md","skills/lark-mail/references/lark-mail-message-trash.md","skills/lark-mail/references/lark-mail-message.md","skills/lark-mail/references/lark-mail-messages.md","skills/lark-mail/references/lark-mail-recall.md","skills/lark-mail/references/lark-mail-recipient-search.md","skills/lark-mail/references/lark-mail-reply-all.md","skills/lark-mail/references/lark-mail-reply.md","skills/lark-mail/references/lark-mail-rules.md","skills/lark-mail/references/lark-mail-send-as.md","skills/lark-mail/references/lark-mail-send-receipt.md","skills/lark-mail/references/lark-mail-send-status.md","skills/lark-mail/references/lark-mail-send.md","skills/lark-mail/references/lark-mail-share-to-chat.md","skills/lark-mail/references/lark-mail-signature.md","skills/lark-mail/references/lark-mail-template-create.md","skills/lark-mail/references/lark-mail-template-update.md","skills/lark-mail/references/lark-mail-template.md","skills/lark-mail/references/lark-mail-thread-modify.md","skills/lark-mail/references/lark-mail-thread-trash.md","skills/lark-mail/references/lark-mail-thread.md","skills/lark-mail/references/lark-mail-triage.md","skills/lark-mail/references/lark-mail-watch.md","skills/lark-markdown/SKILL.md","skills/lark-markdown/references/lark-markdown-create.md","skills/lark-markdown/references/lark-markdown-diff.md","skills/lark-markdown/references/lark-markdown-fetch.md","skills/lark-markdown/references/lark-markdown-overwrite.md","skills/lark-markdown/references/lark-markdown-patch.md","skills/lark-meeting/SKILL.md","skills/lark-meeting/references/lark-minutes-apply-permission.md","skills/lark-meeting/references/lark-minutes-detail.md","skills/lark-meeting/references/lark-minutes-download.md","skills/lark-meeting/references/lark-minutes-search.md","skills/lark-meeting/references/lark-minutes-speaker-replace.md","skills/lark-meeting/references/lark-minutes-summary.md","skills/lark-meeting/references/lark-minutes-todo.md","skills/lark-meeting/references/lark-minutes-update.md","skills/lark-meeting/references/lark-minutes-upload.md","skills/lark-meeting/references/lark-note-detail.md","skills/lark-meeting/references/lark-note-transcript.md","skills/lark-meeting/references/lark-vc-agent-meeting-end.md","skills/lark-meeting/references/lark-vc-agent-meeting-invite.md","skills/lark-meeting/references/lark-vc-agent-meeting-join.md","skills/lark-meeting/references/lark-vc-agent-meeting-leave.md","skills/lark-meeting/references/lark-vc-detail.md","skills/lark-meeting/references/lark-vc-meeting-countdown.md","skills/lark-meeting/references/lark-vc-meeting-events.md","skills/lark-meeting/references/lark-vc-meeting-list-active.md","skills/lark-meeting/references/lark-vc-meeting-message-send.md","skills/lark-meeting/references/lark-vc-meeting-screenshot.md","skills/lark-meeting/references/lark-vc-recording.md","skills/lark-meeting/references/lark-vc-search.md","skills/lark-meeting/scenes/create-and-edit-minutes.md","skills/lark-meeting/scenes/live-meeting-attend.md","skills/lark-meeting/scenes/live-meeting-interact.md","skills/lark-meeting/scenes/query-meeting-and-artifacts.md","skills/lark-meeting/scenes/query-minutes-and-artifacts.md","skills/lark-meeting/scenes/query-note-and-artifacts.md","skills/lark-minutes/SKILL.md","skills/lark-note/SKILL.md","skills/lark-okr/SKILL.md","skills/lark-okr/references/lark-okr-alignments.md","skills/lark-okr/references/lark-okr-batch-create.md","skills/lark-okr/references/lark-okr-comment-create.md","skills/lark-okr/references/lark-okr-comment-delete.md","skills/lark-okr/references/lark-okr-comment-detail.md","skills/lark-okr/references/lark-okr-comment-get.md","skills/lark-okr/references/lark-okr-comment-list.md","skills/lark-okr/references/lark-okr-comment-patch.md","skills/lark-okr/references/lark-okr-comment-solve-reopen.md","skills/lark-okr/references/lark-okr-contentblock.md","skills/lark-okr/references/lark-okr-create.md","skills/lark-okr/references/lark-okr-cycle-detail.md","skills/lark-okr/references/lark-okr-cycle-list.md","skills/lark-okr/references/lark-okr-entities.md","skills/lark-okr/references/lark-okr-image-upload.md","skills/lark-okr/references/lark-okr-indicator-update.md","skills/lark-okr/references/lark-okr-indicators.md","skills/lark-okr/references/lark-okr-patch.md","skills/lark-okr/references/lark-okr-progress-create.md","skills/lark-okr/references/lark-okr-progress-delete.md","skills/lark-okr/references/lark-okr-progress-get.md","skills/lark-okr/references/lark-okr-progress-list.md","skills/lark-okr/references/lark-okr-progress-update.md","skills/lark-okr/references/lark-okr-reorder.md","skills/lark-okr/references/lark-okr-weight.md","skills/lark-openapi-explorer/SKILL.md","skills/lark-shared/SKILL.md","skills/lark-shared/references/lark-shared-config-init.md","skills/lark-shared/references/lark-shared-high-risk-approval.md","skills/lark-shared/references/lark-shared-identity-and-permissions.md","skills/lark-shared/references/lark-shared-output-contract.md","skills/lark-shared/references/lark-shared-update-notice.md","skills/lark-shared/references/lark-wiki-token-routing.md","skills/lark-sheets/SKILL.md","skills/lark-sheets/references/lark-sheets-batch-update.md","skills/lark-sheets/references/lark-sheets-changeset.md","skills/lark-sheets/references/lark-sheets-chart.md","skills/lark-sheets/references/lark-sheets-conditional-format.md","skills/lark-sheets/references/lark-sheets-filter-view.md","skills/lark-sheets/references/lark-sheets-filter.md","skills/lark-sheets/references/lark-sheets-float-image.md","skills/lark-sheets/references/lark-sheets-formula-translation.md","skills/lark-sheets/references/lark-sheets-formula-verify.md","skills/lark-sheets/references/lark-sheets-history.md","skills/lark-sheets/references/lark-sheets-pivot-table.md","skills/lark-sheets/references/lark-sheets-range-operations.md","skills/lark-sheets/references/lark-sheets-read-data.md","skills/lark-sheets/references/lark-sheets-search-replace.md","skills/lark-sheets/references/lark-sheets-sheet-structure.md","skills/lark-sheets/references/lark-sheets-sparkline.md","skills/lark-sheets/references/lark-sheets-styles-put.md","skills/lark-sheets/references/lark-sheets-visual-standards.md","skills/lark-sheets/references/lark-sheets-workbook.md","skills/lark-sheets/references/lark-sheets-write-cells.md","skills/lark-skill-maker/SKILL.md","skills/lark-slides/SKILL.md","skills/lark-slides/references/asset-planning.md","skills/lark-slides/references/cli/lark-slides-add-slide.md","skills/lark-slides/references/cli/lark-slides-create.md","skills/lark-slides/references/cli/lark-slides-delete-slide.md","skills/lark-slides/references/cli/lark-slides-history.md","skills/lark-slides/references/cli/lark-slides-media-upload.md","skills/lark-slides/references/cli/lark-slides-replace-slide.md","skills/lark-slides/references/cli/lark-slides-screenshot.md","skills/lark-slides/references/cli/lark-slides-update-slide.md","skills/lark-slides/references/cli/lark-slides-xml-presentation-slide-get.md","skills/lark-slides/references/cli/lark-slides-xml-presentation-slide-replace.md","skills/lark-slides/references/cli/lark-slides-xml-presentations-get.md","skills/lark-slides/references/iconpark-index.json","skills/lark-slides/references/iconpark.md","skills/lark-slides/references/lark-slides-add-slide.md","skills/lark-slides/references/lark-slides-create.md","skills/lark-slides/references/lark-slides-delete-slide.md","skills/lark-slides/references/lark-slides-edit-workflows.md","skills/lark-slides/references/lark-slides-history.md","skills/lark-slides/references/lark-slides-media-upload.md","skills/lark-slides/references/lark-slides-pptx-template-workflows.md","skills/lark-slides/references/lark-slides-replace-slide.md","skills/lark-slides/references/lark-slides-screenshot.md","skills/lark-slides/references/lark-slides-xml-presentation-slide-get.md","skills/lark-slides/references/lark-slides-xml-presentation-slide-replace.md","skills/lark-slides/references/lark-slides-xml-presentations-get.md","skills/lark-slides/references/planning-layer.md","skills/lark-slides/references/troubleshooting.md","skills/lark-slides/references/validation-checklist.md","skills/lark-slides/references/visual-planning.md","skills/lark-slides/references/workflow/error-handling.md","skills/lark-slides/references/workflow/slides-editing.md","skills/lark-slides/references/workflow/template-editing.md","skills/lark-slides/references/workflow/validation-xml.md","skills/lark-slides/references/xml-schema-quick-ref.md","skills/lark-slides/references/xml/iconpark-index.json","skills/lark-slides/references/xml/iconpark.md","skills/lark-slides/references/xml/xml-schema-quick-ref.md","skills/lark-task/SKILL.md","skills/lark-task/references/lark-task-assign.md","skills/lark-task/references/lark-task-comment.md","skills/lark-task/references/lark-task-complete.md","skills/lark-task/references/lark-task-create.md","skills/lark-task/references/lark-task-followers.md","skills/lark-task/references/lark-task-get-my-tasks.md","skills/lark-task/references/lark-task-get-related-tasks.md","skills/lark-task/references/lark-task-reminder.md","skills/lark-task/references/lark-task-reopen.md","skills/lark-task/references/lark-task-search.md","skills/lark-task/references/lark-task-sections.md","skills/lark-task/references/lark-task-set-ancestor.md","skills/lark-task/references/lark-task-tasklist-create.md","skills/lark-task/references/lark-task-tasklist-members.md","skills/lark-task/references/lark-task-tasklist-search.md","skills/lark-task/references/lark-task-tasklist-task-add.md","skills/lark-task/references/lark-task-update.md","skills/lark-task/references/lark-task-upload-attachment.md","skills/lark-vc-agent/SKILL.md","skills/lark-vc/SKILL.md","skills/lark-whiteboard/SKILL.md","skills/lark-whiteboard/elements/connectors.md","skills/lark-whiteboard/elements/content.md","skills/lark-whiteboard/elements/image.md","skills/lark-whiteboard/elements/layout.md","skills/lark-whiteboard/elements/schema.md","skills/lark-whiteboard/elements/style.md","skills/lark-whiteboard/elements/typography.md","skills/lark-whiteboard/references/lark-whiteboard-export.md","skills/lark-whiteboard/references/lark-whiteboard-update.md","skills/lark-whiteboard/references/lark-whiteboard-workflow.md","skills/lark-whiteboard/routes/dsl.md","skills/lark-whiteboard/routes/mermaid.md","skills/lark-whiteboard/routes/svg-edit.md","skills/lark-whiteboard/routes/svg.md","skills/lark-whiteboard/scenes/architecture.md","skills/lark-whiteboard/scenes/bar-chart.md","skills/lark-whiteboard/scenes/comparison.md","skills/lark-whiteboard/scenes/fishbone.md","skills/lark-whiteboard/scenes/flowchart.md","skills/lark-whiteboard/scenes/flywheel.md","skills/lark-whiteboard/scenes/funnel.md","skills/lark-whiteboard/scenes/line-chart.md","skills/lark-whiteboard/scenes/mention.md","skills/lark-whiteboard/scenes/mermaid.md","skills/lark-whiteboard/scenes/milestone.md","skills/lark-whiteboard/scenes/organization.md","skills/lark-whiteboard/scenes/photo-showcase.md","skills/lark-whiteboard/scenes/pyramid.md","skills/lark-whiteboard/scenes/swimlane.md","skills/lark-whiteboard/scenes/treemap.md","skills/lark-wiki/SKILL.md","skills/lark-wiki/references/lark-wiki-delete-space.md","skills/lark-wiki/references/lark-wiki-member-add.md","skills/lark-wiki/references/lark-wiki-member-list.md","skills/lark-wiki/references/lark-wiki-member-remove.md","skills/lark-wiki/references/lark-wiki-move-to-drive.md","skills/lark-wiki/references/lark-wiki-move.md","skills/lark-wiki/references/lark-wiki-node-copy.md","skills/lark-wiki/references/lark-wiki-node-create.md","skills/lark-wiki/references/lark-wiki-node-delete.md","skills/lark-wiki/references/lark-wiki-node-get.md","skills/lark-wiki/references/lark-wiki-node-list.md","skills/lark-wiki/references/lark-wiki-space-create.md","skills/lark-wiki/references/lark-wiki-space-list.md","skills/lark-workflow-meeting-summary/SKILL.md","skills/lark-workflow-standup-report/SKILL.md","tests/cli_e2e/cli-e2e-testcase-writer/SKILL.md",".cursorrules (ankra-cli.mdc)"],"skills":{"AGENTS.md":"# AGENTS.md\n\n## Purpose\n\n`lark-cli` is the official Lark/Feishu CLI for humans and AI agents. Optimize\nfor predictable machine-readable behavior without making the human CLI worse.\n\nKeep each PR focused on one goal: CLI UX, reliability, simpler explicit code,\nor a useful gate. Done means the correct implementation surface, preserved\ncontracts unless a break was requested, and reported checks.\n\nPublic behavior, tests, lint, and CI define current contracts. Existing code is\nevidence, but a legacy exception is not precedent; `Proposal` documents are\ndirection only. Do not mix unrelated cleanup, hand-edit generated files, weaken\ngates, or broaden allowlists to make CI pass.\n\n## Implementation Discipline\n\nUse this sequence for product behavior or enforcement changes:\n\n1. Establish the current contract and owner before choosing a solution. Trace the\n flow from the command or shortcut through runtime and internal owners to wire\n output; inspect affected callers and tests, then choose the surface below.\n2. Apply YAGNI to scope. Implement the behavior required now; do not add\n speculative modes, configuration, compatibility paths, extension points, or\n scaffolding.\n3. Reuse the project's existing machinery before creating a parallel path.\n Prefer the owning generic, runtime, or internal surface, then the Go standard\n library or an existing dependency, while preserving the contracts below.\n4. Fix the root cause at the narrowest cohesive boundary shared by affected\n callers. Keep command and domain policy at the caller unless there is a real\n cross-command invariant for an internal owner to enforce.\n5. Ship the smallest complete change: implementation, a revert-failing regression\n test for behavior or enforcement, and required contract or guidance updates.\n\nOptimize for minimum owned complexity, not minimum diff or line count. A correct\nroot-cause fix may touch the owner, callers, tests, and docs; a one-line workaround\nat the wrong layer is not simpler. Prefer deletion and boring explicit code, and\navoid one-use abstractions or new dependencies for straightforward behavior.\n\nYAGNI never overrides explicit requirements or output, error, path, security,\ncompatibility, and data-safety contracts. If a deliberately limited solution has\na real ceiling, document the ceiling and the concrete condition for expanding it\nat the decision point.\n\n## Build\n\nRun `make build` for the canonical local build; it writes `./lark-cli` with\nversion metadata and the committed Catalog Snapshot embedded from\n`internal/registry/catalog/manifest.json` plus\n`internal/registry/catalog/services/*.json`. Build and test targets consume this\ntracked snapshot without a metadata fetch or Python prerequisite.\n`make live-skills-test` additionally requires working `npx` and network access.\n\n## Choose the Correct Surface\n\n| Need | Implement in | Rule |\n|------|--------------|------|\n| Agent/human-friendly workflow, composition, or smart defaults | `shortcuts//` via `common.Shortcut` | Must add UX or workflow value beyond exposing one endpoint. |\n| One-to-one supported OpenAPI method | Committed Catalog Snapshot under `internal/registry/catalog/manifest.json` plus `services/*.json`, and generic `cmd/service/` machinery | Verify it with `schema`. Update the manifest and matching service snapshot together; do not add a shortcut merely to expose a missing catalog method. |\n| Arbitrary OpenAPI endpoint | Generic `cmd/api/` machinery | Keep it endpoint-agnostic. |\n| Auth, config, profile, update, or CLI lifecycle | `cmd//` plus the owning shared/internal package | Keep new Cobra code as wiring when a lower owner exists. |\n| EventKey, payload shape, or domain projection | `events//` | Shared event mechanics stay in `internal/event/`; CLI assembly stays in `cmd/event/`. |\n| Command-independent mechanism or cross-command invariant | Owning `internal//` package | Keep UX/domain policy at the caller; use a cohesive owner, not a generic utils package. Test the owner and affected caller contracts. |\n| Public plugin or host integration | `extension/` | Exported symbols are compatibility commitments; orchestration stays internal. |\n| Per-command decision guidance: when, avoid, prerequisites, tips, or examples | `affordance/.md` | Enrich `--help` and `schema` without restating command descriptions, flags, or field schemas. |\n| Domain routing, concepts, safety, or cross-command agent workflow | `skills//SKILL.md` and `references/` | Keep always-needed decisions in `SKILL.md`, conditional HOW in references, and link commands from affordance. |\n\nDo not duplicate one command surface inside another. Register new shortcuts in\nthe domain's `Shortcuts()`; declare risk, identities/scopes, flags, and dry-run.\n\n## Source Layout\n\n| Path | What it does |\n|------|-------------|\n| `cmd/root.go` | Entry point, command registration, strict mode pruning |\n| `cmd/profile/` | Multi-profile management (add/list/use/rename/remove) |\n| `cmd/config/` | Config init, show, strict-mode |\n| `cmd/service/` | Auto-registers API commands from `internal/registry/catalog/manifest.json` and `internal/registry/catalog/services/*.json` |\n| `shortcuts/common/runner.go` | Shortcut execution pipeline, Flag.Input (@file/stdin) resolution |\n| `shortcuts/` | Domain-specific shortcut implementations |\n| `internal/cmdutil/factory.go` | Factory pattern — identity resolution, credential, config |\n| `internal/cmdutil/factory_default.go` | Production factory wiring |\n| `internal/credential/` | Credential provider chain (extension → default) |\n| `extension/credential/` | Plugin-facing credential interfaces and env provider |\n| `internal/client/client.go` | APIClient: DoSDKRequest, DoStream |\n| `internal/core/config.go` | Multi-profile config loading/saving |\n| `internal/vfs/` | Filesystem abstraction (use `vfs.*` instead of `os.*`) |\n| `internal/validate/path.go` | Path safety validation |\n\n## Hard Contracts\n\nRead the [JSON output contract](README.md#json-output-contract) before changing\nwire output. Read the [source guard guide](lint/README.md) and `.golangci.yml`\nbefore changing or waiving enforcement.\n\n- Command/flag semantics, help/schema metadata, output placement and shapes,\n errors, exit codes, risk/identity, and exported APIs are compatibility contracts.\n When forwarding or echoing accepted input, preserve it verbatim unless its\n contract defines normalization; never silently substitute another behavior.\n- Success data goes to stdout; typed failure envelopes, progress, warnings, and\n hints go to stderr. Predicate/self-contained results and partial failures are\n documented exceptions whose complete result remains on stdout.\n- Keep new or touched Cobra code as wiring. Lark/Feishu API calls in shortcuts go\n through `*common.RuntimeContext`; direct HTTP is only for non-gateway protocols\n such as presigned storage and requires a precise `//nolint:forbidigo` reason.\n- Keep user/workspace FileIO invocation-scoped: use `runtime.FileIO()`,\n `runtime.ValidatePath()`, and `runtime.ResolveSavePath()` so portable commands do\n not assume a local host or process working directory.\n- Shortcuts do not use `internal/vfs` for user/workspace files. A narrow\n `//nolint:depguard` waiver is allowed only for CLI-owned state or explicitly\n CLI-managed host configuration; explain that ownership boundary. Other internal\n filesystem code uses `internal/vfs` and validates paths.\n- If FileIO lacks a host-local tree operation, prefer an owning `internal/` package\n or optional capability. Direct `os` calls require a stated local-only boundary,\n validated and bounded paths, and a precise `//nolint:forbidigo` reason.\n- Do not hardcode resolver-owned hosts. At new API boundaries, or when changed\n behavior consumes fields from a loose map, project that shape into a typed\n struct before downstream use. Extend published interfaces through optional\n interfaces rather than breaking external implementations.\n- Source guards enforce raw HTTP/os/vfs, resolver-host, and migrated-error\n constructs; other semantics rely on tests and review. Every exemption must be\n narrow, local, and explain why the safe path does not apply.\n\n## Structured Errors\n\nBefore changing a command failure, taxonomy, or error wire field, read the\n[error contract](errs/ERROR_CONTRACT.md); it owns constructor selection, wrapping,\nextension fields, stability, and CI guards.\n\n- Command-facing failures use typed `errs.*` unless the error contract defines\n an output-control exception. Never return a final plain `fmt.Errorf` /\n `errors.New` or ad hoc envelope; pass typed errors through and preserve causes.\n- Lark API failures use a domain typed wrapper, `runtime.CallAPITyped`, or\n `runtime.DoAPIJSONTyped`; raw callers use `runtime.ClassifyAPIResponse` or\n `errclass.BuildAPIError`.\n- `param` names only failing user input; recovery belongs in `hint`. Populate\n `missing_scopes`, `log_id`, and similar fields only from known runtime evidence.\n- Error tests assert typed metadata and cause preservation, not message text alone.\n\n## Affordance and Skills\n\nBefore editing command guidance, read the [affordance guide](affordance/README.md).\nFor plugin distributions, read [Ship skills and command guidance](extension/platform/README.md#ship-skills-and-command-guidance).\n\n- Go metadata/schema owns WHAT; affordance owns command-level WHEN; `SKILL.md`\n owns domain routing, concepts, safety, and cross-command workflows; `references/`\n owns detailed or conditional HOW.\n- Do not duplicate canonical descriptions, schemas, or generic error taxonomy.\n Keep workflow-specific recovery in a skill when it changes agent behavior;\n affordance examples remain runnable, current, and safe.\n- Skill frontmatter `description` is a concise WHAT/WHEN/NOT routing trigger. Keep\n always-needed decisions in `SKILL.md`; move conditional detail to `references/`.\n- Skill names and reference paths are public pointers. Every path reachable from\n shipped docs must ship. Before referencing a new content directory, update\n `content_embed.go` and add an embedded-FS reachability test; `assets/` and\n `scripts/` stay source-only unless the distribution contract changes.\n\n## Tests\n\n- Every behavior change needs a nearby test that fails if the implementation is\n reverted; assert fields, requests, typed errors, or side effects directly.\n- Command/shortcut tests needing a Factory use `cmdutil.TestFactory(t, config)`;\n isolate config with\n `t.Setenv(\"LARKSUITE_CLI_CONFIG_DIR\", t.TempDir())`.\n- Tests must not depend on developer profiles, keychains, home directories,\n execution order, or real credentials unless explicitly live.\n- Live E2E flows are self-contained: create, use, and clean up even after failure.\n\n| Shortcut change | Dry-run E2E | Live E2E |\n|-----------------|:-----------:|:--------:|\n| New shortcut | Required | Required |\n| Flags or request params | Required | Required if behavior changes |\n| Bug fix | Required | Required when risk reaches the API boundary |\n| Internal refactor, no behavior change | Not needed | Not needed |\n\nDry-run tests use placeholder credentials and assert method, URL, params, and\nbody without a real API call. Confirm contracts with `--help` and `schema` first.\nIf no deterministic, cleanable live flow exists, do not leak tenant state or add\na flaky test; document the blocker, fixture conditions, and substitute evidence.\n\n## Validation\n\nRun the narrowest useful check while iterating, then broaden with risk:\n\n| Change | Checks |\n|--------|--------|\n| Go package | `go test ./path/to/package/...`, then the pre-PR Go checks below |\n| Broad/cross-cutting | `make test` |\n| Committed command/help/schema surface | `make quality-gate` |\n| Skills | `node scripts/skill-format-check/index.js`, then `make quality-gate` after committing the change |\n| Affordance | Add/update `internal/affordance/*_source_test.go`; run `go test ./internal/affordance ./cmd/service ./internal/schema` |\n| Make-covered scripts/workflows | `make script-test` |\n| Public plugin SDK | `make examples-build` plus relevant `tests/plugin_e2e` |\n| Auth sidecar | `make sidecar-test` |\n| Skills sync behavior | `make live-skills-test` |\n| Dependencies | `go mod tidy` plus the CI `go-licenses` check |\n\n`make quality-gate` and diff-scoped linters compare the base with `HEAD`; they\nignore staged, unstaged, and untracked changes, so run them after committing.\nSome skill-quality signals are warnings; frontmatter has the separate hard check\nabove. The gate does not validate affordance examples or references in this file:\nrun the focused source test and verify changed paths/symbols directly.\n\n`make test` currently leaves root binaries `audit-observer` and `readonly-policy`; do not stage them.\n\nBefore a Go PR, run `make unit-test`, `make vet`, and `make fmt-check`;\n`go mod tidy` must leave module files unchanged. Set\n`QUALITY_GATE_CHANGED_FROM` to the PR base before diff-scoped checks. Pinned\n`go run module@version` commands need module access unless cached.\n\n```bash\ngo mod tidy\ngit diff --exit-code -- go.mod go.sum\ngo run github.com/golangci/golangci-lint/v2/cmd/golangci-lint@v2.1.6 run --new-from-rev=\"$QUALITY_GATE_CHANGED_FROM\"\ngo run -C lint . --changed-from \"$QUALITY_GATE_CHANGED_FROM\" ..\ngo test -C lint ./... -count=1\ngo run github.com/google/go-licenses/v2@v2.0.1 check ./... --disallowed_types=forbidden,restricted,reciprocal,unknown\n```\n\nCI is authoritative; state exactly which relevant checks were not run.\n\n## Maintaining This File\n\nAdd a root rule only when it is repository-specific, non-obvious, actionable,\nand prevents a recurring failure or high-impact contract breach. Prefer code,\ntests, or CI for mechanizable constraints; keep only rationale and safe exceptions\nhere. Update named references in the same PR, and delete or move stale, obvious,\nredundant, task-local, or fully enforced rules. Each edit should reduce ambiguity,\nnot only add text.\n\n## Commit and PR\n\nUse English Conventional Commits/PR titles, complete the PR template, and never\ncommit secrets, tokens, internal endpoints, or sensitive test data.\n","internal/qualitygate/skillscan/testdata/skills/lark-demo/SKILL.md":"---\nname: lark-demo\ndescription: Demo skill\n---\n\n```bash\n# comment\nlark-cli docs +fetch --api-version v2 --doc A3Ijdemo\nlark-cli im messages list \\\n --container-id oc_xxx \\\n --page-size 20\nnpx other-tool\n```\n","isolated-skills/lark-suite/SKILL.md":"---\nname: lark-suite\nversion: 0.1.0\ndescription: 飞书/Lark 聚合能力入口：管理飞书/Lark 产品能力（等）。当 doubao.com 及其子域名承载飞书资源时也使用本入口，不要回退到 WebFetch。当用户需求涉及上述飞书业务域时使用。\nmetadata:\n requires:\n bins:\n - lark-cli\n---\n\n# Lark Suite\n\n你是飞书/Lark 能力的聚合路由层。你的职责是先判断用户要使用哪个 `lark-*` 子能力，再读取并遵循对应子能力的说明。\n\n`lark-suite` 不直接承载具体 API 操作步骤。除非对应子能力已被读取，否则不要仅根据本文件拼命令、猜参数或执行复杂操作。\n\n所有子能力统一收纳在当前 skill 的 `references/` 目录。选择 `lark-foo` 后，直接读取 `references/lark-foo/GUIDE.md`；不要再次调用 `Skill(lark-foo)`，也不要使用 Find/Glob 遍历或探测整个 references 目录。\n\n## 使用流程\n\n1. 根据用户意图从下方路由表选择一个或多个子能力；即使用户尚未提供链接、ID 或具体工作表，也先选择能力，再由子能力询问缺失信息。\n2. 直接读取 `references//GUIDE.md` 加载所选子能力，不要把收纳后的子能力当作独立 skill 再次调用。\n3. 仅使用本文件列出的路由与对应子能力入口，不要遍历或探测其他技能目录。\n4. 如果目标能力未列出，返回无法路由的明确提示。\n5. 仅读取当前已选子能力明确要求的前置文件。\n6. 按目标子能力的说明执行；认证、租户、身份、权限和通用排障优先遵循 `lark-shared`。\n\n多步任务可以组合多个子能力，但每一步都应由具体子能力驱动。例如“查联系人并发消息”先用 `lark-contact` 解析身份，再用 `lark-im` 发消息。\n\n## 能力路由\n\n根据用户意图从以下条目选择对应子能力；如果一个任务涉及多个能力，按实际操作顺序逐步读取并使用对应子能力。\n\n\n","scripts/skill-format-check/tests/bad-skill-no-frontmatter/SKILL.md":"# No Frontmatter Skill\n\nThis skill completely lacks a YAML frontmatter.\n","scripts/skill-format-check/tests/bad-skill-unclosed-frontmatter/SKILL.md":"---\nname: bad-skill-unclosed\nversion: 1.0.0\ndescription: \"This skill has an unclosed frontmatter block.\"\nmetadata: {}\n\n# Unclosed Frontmatter Skill\n\nThis frontmatter does not have a closing `---` block.","scripts/skill-format-check/tests/bad-skill/SKILL.md":"---\nversion: 1.0.0\nmetadata: {}\n---\n\n# Bad Skill\n\nThis skill is missing required fields like name and description.\n","scripts/skill-format-check/tests/good-skill-complex/SKILL.md":"---\nname: good-skill-complex\nversion: 2.5.1-beta\ndescription: >\n A very complex description\n that spans multiple lines\n and contains weird chars: !@#$%^&*()\nmetadata:\n requires:\n bins: [\"lark-cli\", \"node\"]\n cliHelp: \"lark-cli something --help\"\n customField: \"customValue\"\n---\n\n# Complex Skill\n\nThis skill has a complex frontmatter block.\n","scripts/skill-format-check/tests/good-skill-minimal/SKILL.md":"---\nname: good-skill-minimal\nversion: 0.1.0\ndescription: Minimal valid description\nmetadata: {}\n---\n\n# Minimal Skill\n\nThis has the bare minimum required fields.\n","scripts/skill-format-check/tests/good-skill/SKILL.md":"---\nname: good-skill\nversion: 1.0.0\ndescription: \"This is a properly formatted skill.\"\nmetadata:\n requires:\n bins: [\"lark-cli\"]\n---\n\n# Good Skill\n\nThis skill follows all the formatting rules.\n","skills/lark-approval/SKILL.md":"---\nname: lark-approval\nversion: 1.2.0\ndescription: \"飞书审批：查询和处理审批待办/已办/实例，搜索可发起审批定义、查看定义详情并发起原生审批实例。当用户要处理审批任务、查看审批实例、搜索或发起审批时使用。审批待办不是飞书任务；非审批类待办走 lark-task。不负责创建审批定义；三方审批定义不走原生提单。\"\nmetadata:\n requires:\n bins: [\"lark-cli\"]\n cliHelp: \"lark-cli approval --help\"\n---\n\n\n**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理**\n\n所有命令默认 `--as user`（审批是人的动作）。调用前先按需读取 references 下对应的文件，查参数结构，不要猜字段；**references 是第一信息源**，只有在 reference 未覆盖的原生 / 高级场景下，才额外用 `lark-cli ... --help`、`lark-cli schema` 等方式补充确认字段。\n\n## 路由优先级（先判断是不是审批，再选命令）\n\n审批待办不是飞书任务。**只要用户的核心对象是审批单据 / 审批待办 / 审批实例，就优先使用 `lark-approval`，不要让渡给 `lark-task`。**\n\n### 明确归 `lark-approval` 的高优先级语义\n\n出现以下任一语义时，优先走 `lark-approval`：\n\n- 审批待办 / 审批单据 / 审批实例 / 审批意见 / 审批定义\n- 同意 / 拒绝 / 转交 / 退回 / 撤回 / 催办 / 加签 / 抄送\n- 待办列表 / 待办单据 / 已发起审批 / 已办审批 / 审批详情 / 同意可编辑\n\n**判定规则：** 只要最终动作是对审批单据做同意、拒绝、转交、退回、撤回、催办、加签、抄送、查详情、查已发起/已办/待办，就归 `lark-approval`。只有当用户处理的是**非审批类任务/待办**时，才走 [`lark-task`](../lark-task/SKILL.md)。\n\n## 选哪个命令\n\n| 想做什么 | 命令 | 按需读取 reference |\n|---|---|---------------------------------------------------------------------------------|\n| 搜可发起定义 | `approvals search` | [`lark-approval-approvals-search.md`](references/lark-approval-approvals-search.md) |\n| 看审批定义详情/提单前确认表单与流程 | `approvals get` | [`lark-approval-approvals-get.md`](references/lark-approval-approvals-get.md) |\n| 发起原生审批实例/提交请假审批/提交报销审批/创建审批实例 | `instances create` | [`lark-approval-initiate.md`](references/lark-approval-initiate.md) |\n| 查/搜待办、已办 | `tasks query`（`topic`：1待办 2已办 17未读 18已读） | [`lark-approval-tasks-query.md`](references/lark-approval-tasks-query.md) |\n| 看表单/进度/当前节点 | `instances get` | [`lark-approval-instances-get.md`](references/lark-approval-instances-get.md) |\n| 同意审批 | `tasks approve` | [`lark-approval-tasks-approve.md`](references/lark-approval-tasks-approve.md) |\n| 拒绝审批 | `tasks reject` | [`lark-approval-tasks-reject.md`](references/lark-approval-tasks-reject.md) |\n| 转交审批 | `tasks transfer` | [`lark-approval-tasks-transfer.md`](references/lark-approval-tasks-transfer.md) |\n| 加签审批 | `tasks add_sign` | [`lark-approval-tasks-add-sign.md`](references/lark-approval-tasks-add-sign.md) |\n| 退回审批 | `tasks rollback` | [`lark-approval-tasks-rollback.md`](references/lark-approval-tasks-rollback.md) |\n| 催办审批 | `tasks remind` | [`lark-approval-tasks-remind.md`](references/lark-approval-tasks-remind.md) |\n| 撤回已发起审批 | `instances cancel` | [`lark-approval-instances-cancel.md`](references/lark-approval-instances-cancel.md) |\n| 给审批实例追加抄送 | `instances cc` | [`lark-approval-instances-cc.md`](references/lark-approval-instances-cc.md) |\n| 按定义/关键词查已发起审批 | `instances initiated` | [`lark-approval-instances-initiated.md`](references/lark-approval-instances-initiated.md) |\n\n处理链：\n\n- 发起审批：`approvals search` -> `approvals get` -> `instances create`\n- 处理审批：`tasks query` 拿 `instance_code` + `task_id`（操作必须成对带上）→ 只有用户明确需要查看详情、当前节点、表单内容、或流程进度时，再 `instances get` → 执行操作\n\n## 执行原则（减少误路由、误重试和无效消耗）\n\n### 1) 先拿最小必要信息，再执行\n\n- 目标只是处理待办时，优先 `tasks query` 获取 `instance_code` + `task_id`\n- **只有**用户明确要看详情、当前节点、表单内容、流程进度时，才调用 `instances get`\n- 用户已经明确给出 `instance_code` / `task_id` 时，不要先查列表再过滤\n\n### 2) 已知对象时直达动作\n\n- 已拿到 `instance_code` + `task_id` 后，优先直接执行 `tasks approve/reject/transfer/add_sign/rollback/remind`\n- 同一轮里如果已有足够的新鲜查询结果，不要重复 `tasks query`\n- 不要默认走 `list -> filter -> detail -> write` 全链路；对象已明确时应压缩步骤\n\n### 3) 错误码驱动，而不是盲目重试\n\n- 写操作失败后，先看错误码和报错语义，再决定是否补查或结束\n- **除非错误明确提示可恢复或需要补充参数，否则不要重复刷同一个写操作**\n- 同一个失败原因不要连续多次重试，避免 token 和耗时失控，最多重试1次\n\n## 写操作失败处理：1395001 决策树\n\n当拒绝 / 转交 / 退回 / 撤回 / 同意等写操作返回 `1395001`（任务状态异常 / 写前置校验失败）时，按下面规则处理：\n\n1. **先停止盲目重试**，不要连续重复提交相同写操作，最多重试1次\n2. 优先从以下角度解释：\n - 任务可能已被他人处理\n - 单据状态已变化，当前动作已不再允许\n - 当前用户已不具备该任务的操作资格\n - 当前节点或单据状态不支持该操作\n3. 如需确认，只补 **一次** 状态查询（`tasks query` 或 `instances get`），不要陷入 query/write 循环\n4. 最终给用户明确结论和下一步建议，而不是继续无意义重试\n\n**特别注意：** 对拒绝 / 转交 / 撤回场景更要严格执行上述规则；这些场景最容易因状态切换而失败。\n\n```bash\nlark-cli approval approvals search --data '{\"keyword\":\"请假\"}' --as user\nlark-cli approval approvals get --params '{\"approval_code\":\"\"}' --as user\nlark-cli approval instances create --data '{\"approval_code\":\"\",\"form\":\"[...]\"}' --yes --as user\nlark-cli approval tasks query --params '{\"topic\":\"1\"}' --as user\nlark-cli approval tasks approve --data '{\"instance_code\":\"\",\"task_id\":\"\",\"comment\":\"同意\"}' --as user\n```\n\n## 不在本 skill 范围\n\n创建审批定义（走飞书客户端或审批管理后台）；三方定义发起（返回 `create_link`，引导用户通过链接发起）；非审批类待办 → [`lark-task`](../lark-task/SKILL.md)\n","skills/lark-approval/references/lark-approval-approvals-get.md":"\n# approval approvals get\n\n获取单个审批定义详情（用户级只读操作）。适合在发起审批实例前，先确认审批名称、表单控件结构、选项值范围以及流程节点信息。\n\n需要的 scopes: [\"approval:approval:read\"]\n\n## 命令\n\n```bash\n# 按 approval_code 查询审批定义详情\nlark-cli approval approvals get --params '{\"approval_code\":\"\"}' --as user\n\n# 表格格式输出，便于快速浏览顶层字段\nlark-cli approval approvals get --params '{\"approval_code\":\"\"}' --format table --as user\n\n# 预览 API 调用，不执行\nlark-cli approval approvals get --params '{\"approval_code\":\"\"}' --as user --dry-run\n```\n\n## 参数\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `--params '{...}'` | 是 | 查询参数，使用 JSON 传入 |\n| `approval_code` | 是 | 审批定义 Code；通常来自 `approval approvals search` 的结果 |\n| `locale` | 否 | 返回语言，例如 `zh-CN`、`en-US`、`ja-JP` |\n| `--as user` | 否 | 建议显式指定用户身份；审批定义详情通常按当前用户可见范围读取 |\n| `--format` | 否 | 输出格式：`json`（默认）、`ndjson`、`table`、`csv` |\n| `--dry-run` | 否 | 预览 API 调用，不执行 |\n\n## 常见输入来源\n\n如果你已经有 `approval_code`，可直接查询：\n\n```bash\nlark-cli approval approvals get --params '{\"approval_code\":\"\"}' --as user\n```\n\n如果你还没有 `approval_code`，先搜索可发起审批定义：\n\n```bash\nlark-cli approval approvals search --data '{\"keyword\":\"请假\"}' --as user\n```\n\n## 输出重点字段\n\n返回结果中，优先关注以下字段：\n\n| 字段 | 说明 |\n|------|------|\n| `approval_code` | 审批定义 Code |\n| `approval_name` | 审批定义名称；确认是不是用户想发起的那张单 |\n| `form` | 表单定义快照；用于识别控件 `id`、`type`、选项值范围、明细子控件结构 |\n| `node_list` | 流程节点列表；用于识别节点 key、是否需要补充审批人、是否允许多人 |\n\n## form 的使用重点\n\n`form` 最重要的作用是帮助 agent **识别怎么组装 `instances.create.data.form`**，而不是直接把它原样提交出去。\n\n重点看：\n\n| 字段 / 结构 | 说明 |\n|------|------|\n| `form[].id` | 控件 ID；后续创建实例时必须使用 |\n| `form[].type` | 控件类型，例如 `input`、`date`、`radio`、`checkbox`、`fieldList` |\n| `form[].value` / 选项定义 | 用来识别可选值范围、默认值或选项值 |\n| 明细 / 子控件结构 | 用于识别 `fieldList`、控件组等复杂控件的子字段结构 |\n\n**注意：`approvals.get.form` 不是 `instances.create` 可直接复用的 payload 模板。** 它是“定义快照”，主要用于识别字段结构与选项值范围。\n\n## node_list 的使用重点\n\n`node_list` 主要用于后续决定是否要补 `node_approver_list` / `node_cc_list`。\n\n重点看：\n\n| 字段 | 说明 |\n|------|------|\n| `node_list[].custom_node_id` | 自定义节点标识；后续补节点参数时优先作为 key |\n| `node_list[].node_id` | 节点 ID；若没有 `custom_node_id`，通常退回用它做 key |\n| `node_list[].need_approver` | 是否要求发起人补充审批人 |\n| `node_list[].approver_chosen_multi` | 是否允许为该节点选择多个审批人 |\n\n## 使用建议\n\n- **这是发起原生审批实例前的必要只读步骤。** 推荐固定走：`approvals search` -> `approvals get` -> `instances create`。\n- **如果用户已经明确给了 `approval_code`，直接用这个命令。** 不必再走 `approvals search`。\n- **先确认 `approval_name`。** 避免把相似名称的审批定义搞混。\n- **先用 `form` 识别控件结构，再组装创建 payload。** 不要在未看详情时猜控件 `id`、`type` 或选项值。\n- **先用 `node_list` 看是否需要补审批人。** 若某节点 `need_approver=true`，创建实例时通常要补 `node_approver_list`。\n- **`node_list` 的 key 优先取 `custom_node_id`。** 若不存在，再使用 `node_id`。\n- **`approver_chosen_multi=false` 时，一个节点通常只能补一个审批人。**\n\n## 输出与后续操作\n\n读取定义详情后，常见下一步：\n\n```bash\n# 发起原生审批实例\nlark-cli approval instances create --data '{\"approval_code\":\"\",\"form\":\"[...]\"}' --as user --yes\n```\n\n如果需要进一步理解控件取值与节点参数，优先参考：\n\n- `lark-approval-instance-form-control-parameters.md`\n- `lark-approval-instance-value-sourcing.md`\n- `lark-approval-initiate.md`\n\n## 结果整理方式\n\n**将结果整理为“审批定义概览 + 表单结构摘要 + 节点要求摘要”。**\n\n建议输出成下面这种结构：\n\n```text\n审批定义：请假申请\napproval_code: 7C468A54-8745-2245-9675-08B7C63E7A85\n\n表单控件摘要：\n- leave_type: radio，可选值 [annual_leave, sick_leave]\n- reason: textarea\n- start_end: dateInterval\n\n节点要求摘要：\n- manager_node：need_approver=true，approver_chosen_multi=false\n- hr_node：need_approver=false\n```\n","skills/lark-approval/references/lark-approval-approvals-search.md":"\n# approval approvals search\n\n搜索**当前用户可发起**的审批定义（launchable approvals）。只读操作，不会创建审批实例。\n\n需要的 scopes: [\"approval:approval:read\"]\n\n## 命令\n\n```bash\n# 按关键词搜索可发起审批定义\nlark-cli approval approvals search --data '{\"keyword\":\"请假\"}' --as user\n\n# 使用 page_token 翻页\nlark-cli approval approvals search --data '{\"keyword\":\"请假\", \"page_token\":\"example_page_token\"}' --as user\n\n# 表格格式输出，便于快速浏览候选定义\nlark-cli approval approvals search --data '{\"keyword\":\"出差\"}' --format table --as user\n\n# 预览 API 调用，不执行\nlark-cli approval approvals search --data '{\"keyword\":\"请假\"}' --as user --dry-run\n```\n\n## 参数\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `--data '{...}'` | 是 | 查询参数，使用 JSON 传入 |\n| `keyword` | 是 | 搜索关键词，例如 `请假`、`报销`、`出差`、`采购` |\n| `locale` | 否 | 返回语言，例如 `zh-CN`、`en-US`、`ja-JP` |\n| `page_size` | 否 | 分页大小 |\n| `page_token` | 否 | 翻页标记；首次请求不填，后续使用上一次返回的 `page_token` |\n| `--as user` | 否 | 建议显式指定用户身份；“可发起审批定义”是面向当前用户的查询 |\n| `--format` | 否 | 输出格式：`json`（默认）、`ndjson`、`table`、`csv` |\n| `--dry-run` | 否 | 预览 API 调用，不执行 |\n\n## 这个命令解决什么问题\n\n当用户只有自然语言意图，还没有 `approval_code` 时，先用它把“可发起的审批定义候选项”找出来。\n\n典型场景：\n\n- “帮我找一下请假审批”\n- “有哪些可以发起的报销单？”\n- “先搜一下出差审批，再帮我提单”\n\n## 输出重点字段\n\n返回结果里，优先关注以下字段：\n\n| 字段 | 说明 |\n|------|------|\n| `approval_code` | 审批定义 Code；后续 `approvals get` 和 `instances create` 都要用它 |\n| `approval_name` | 审批定义名称；给用户做候选选择时最关键 |\n| `is_external` | 是否为三方审批定义；`true` 表示不能走原生 `instances.create` |\n| `create_link` | 三方审批定义的发起链接；`is_external=true` 时优先返回给用户 |\n\n## 使用规则\n\n- **这是发起审批工作流的第一步。** 标准顺序是：`approvals search` -> `approvals get` -> `instances create`。\n- **搜索结果为空时，不要猜。** 直接告诉用户当前关键词下没有可发起定义，并建议用户换关键词。\n- **命中多个结果时，不要替用户拍板。** 先把候选定义列出来，让用户选择目标审批定义。\n- **`is_external=true` 时不要调用 `approval instances create`。** 这类定义属于三方审批，优先返回 `create_link` 并说明需要通过链接发起。\n- **只有 `is_external=false` 的原生定义，才继续 `approvals get`。**\n- **如果用户已经明确给出 `approval_code`，不要再 search。** 直接执行 `approval approvals get`。\n\n## 结果整理方式\n\n**将结果整理为候选清单，优先展示“名称 + approval_code + 是否三方定义 + 下一步建议”。**\n\n建议输出成下面这种结构：\n\n```text\n找到 3 个可发起审批定义：\n\n1. 请假申请\n - approval_code: 7C468A54-8745-2245-9675-08B7C63E7A85\n - is_external: false\n - next: 可继续读取 definitions 详情（approvals get）\n\n2. 差旅报销\n - approval_code: 99887766-xxxx\n - is_external: true\n - next: 返回 create_link，引导用户通过链接发起\n```\n\n## 常见后续操作\n\n### 1）用户选中了某个定义，继续查看详情\n\n```bash\nlark-cli approval approvals get --params '{\"approval_code\":\"\"}' --as user\n```\n\n### 2）确认是原生定义后，再准备发起审批实例\n\n```bash\nlark-cli approval instances create --data '{\"approval_code\":\"\",\"form\":\"[...]\"}' --as user --yes\n```\n\n### 3）确认是三方定义时，直接返回链接\n\n当 `is_external=true` 时，优先向用户返回 `create_link`，说明该审批需在三方系统或跳转页面中发起，而不是通过原生 `instances.create`。\n","skills/lark-approval/references/lark-approval-initiate.md":"# 审批提单工作流\n\n## 执行摘要\n\n- **原生审批提单如果用户未明确给出 `approval_code`，必须固定走 `approvals search` -> `approvals get` -> `instances create`** 不要跳过 `get` 直接拼请求。\n- **原生审批提单如果用户明确给出 `approval_code`，固定走 `approvals get` -> `instances create`** 不要跳过 `get` 直接拼请求。\n- **`is_external=true` 的定义是三方定义。** 这类定义不要调用 `instances create`，应优先使用 `create_link`。\n- **所有人员类参数默认使用 `open_id`。** 若用户给的是姓名、邮箱或其他身份，先用 [`../../lark-contact/SKILL.md`](../../lark-contact/SKILL.md) 解析。\n- **先读控件参数 reference 和值来源 reference，再读本文里的创建参数规则。** 提单前必须先阅读 [`lark-approval-instance-form-control-parameters.md`](./lark-approval-instance-form-control-parameters.md) 和 [`lark-approval-instance-value-sourcing.md`](./lark-approval-instance-value-sourcing.md)。\n- **`approvals.get.form` 不是创建 payload 的原样模板。** 它主要用于识别控件 `id`、`type`、选项值范围和明细子控件结构；真正的 `instances create --data.form` 中，控件 `value` 结构以 [`lark-approval-instance-form-control-parameters.md`](./lark-approval-instance-form-control-parameters.md) 为准。\n- **节点参数只从 `node_list` 和本文里的节点参数规则里取。** 节点 key 必须来自定义详情返回的节点标识；审批人/抄送人列表传用户 ID 时，不要混用姓名或其他身份标识。\n- **看到 `need_approver=true` 就说明该节点需要发起人补充审批人。** 如果 `approver_chosen_multi=false`，该节点只允许一个 `open_id`。\n- **创建实例前先确认。** `approval instances create` 是写操作，执行前，让用户确认最终定义、表单值和节点参数；真正执行时显式传 `--yes`。\n\n## 适用场景\n\n- “帮我提交一个请假审批”\n- “帮我发起报销审批”\n- “我想提一个出差审批”\n- “先搜可发起的审批，再帮我提单”\n\n## 严禁行为\n\n- **严禁在未先阅读本文中的创建参数规则、[`lark-approval-instance-form-control-parameters.md`](./lark-approval-instance-form-control-parameters.md) 和 [`lark-approval-instance-value-sourcing.md`](./lark-approval-instance-value-sourcing.md) 的情况下直接提单。**\n- **严禁跳过 `approvals.get`。** 未拿到 `form` 和 `node_list` 前，不得调用 `instances create`。\n- **严禁把姓名直接写进 `node_approver_list`、`node_cc_list` 或表单人员控件。** 必须先转成 `open_id`。\n- **严禁对三方定义调用 `instances create`。**\n- **严禁对 API 不支持的控件硬提单。** 如果目标定义包含创建实例 API 不支持的控件，应明确告诉用户该定义不能仅通过 API 完整发起。\n- **严禁把 `approvals.get.form` 当成可直接提交的原样模板。**\n- **严禁在未得到用户确认前直接执行真实提单。**\n\n## 工作流\n\n### 1. 搜索可发起审批定义\n\n先搜索定义：\n\n```bash\nlark-cli approval approvals search --data '{\"keyword\":\"请假\"}'\n```\n\n处理规则：\n\n- 若结果为空，告诉用户当前关键词下没有可发起定义。\n- 若命中多个定义，必须把候选项列给用户选择，不要自行猜测。\n- 若目标定义 `is_external=true`，优先返回 `create_link`，说明这是三方定义，不能走原生 `instances create`。\n- 只有 `is_external=false` 的原生定义才继续下一步。\n\n### 2. 获取审批定义详情\n\n拿到 `approval_code` 后，读取定义详情：\n\n```bash\nlark-cli approval approvals get \\\n --params '{\"approval_code\":\"7C468A54-8745-2245-9675-08B7C63E7A85\"}'\n```\n\n重点关注返回：\n\n- `approval_name`: 当前发起的是哪个审批定义。\n- `form`: 表单定义快照，用于识别控件 `id`、`type`、选项值范围以及明细子控件结构；不是创建实例时可直接原样提交的 payload 模板。\n- `node_list`: 流程节点信息，是后续 `node_approver_list` / `node_cc_list` 的唯一可靠来源。\n\n### 3. 创建请求参数速查\n\n输入参数如下：\n\n| 参数 | 必填 | 说明 |\n|---|---|---|\n| `--data '{...}'` | 是 | 请求体，使用 JSON 传入 |\n| `approval_code` | 是 | 审批定义 Code；必须先通过 `approvals search` / `approvals get` 确认 |\n| `form` | 否 | 表单值，**JSON 数组字符串**，不是普通对象；API 层非必填，但审批定义存在必填控件或用户需要提交表单值时必须传 |\n| `node_approver_list` | 否 | 节点审批人列表；仅在定义要求补充审批人时传 |\n| `node_cc_list` | 否 | 节点抄送人列表；仅在用户明确需要补充节点抄送人时传 |\n| `uuid` | 否 | 幂等标识；重复重试同一请求时建议显式传入 |\n| `--as user` | 否 | 建议显式指定用户身份；审批发起通常应使用用户身份 |\n| `--yes` | 是 | 写操作确认；真实执行时必须显式传入 |\n| `--dry-run` | 否 | 预览 API 调用，不执行 |\n\n### 4. 组装 `form`\n\n`instances create --data.form` 是可选字段；传入时必须是一个 JSON 数组字符串。无表单或无需填写表单值的审批可省略 `form`，但只要审批定义包含需要提交的控件，就必须按控件结构组装后传入。组装原则：\n\n- 先用 `approvals.get.form` 识别有哪些控件、每个控件的 `id` / `type` / 可选值范围，再按本文中的创建参数规则与 [`lark-approval-instance-form-control-parameters.md`](./lark-approval-instance-form-control-parameters.md) 重新组装创建 payload。\n- 提交时必须至少保证每个控件的 `id`、`type` 与 `value` 符合当前接口要求；不要假设定义快照里出现的其他字段都能直接照搬。\n- 如果用户提供的是人员信息，优先转换成 `open_id` 后再写入对应控件。\n- 单选/多选控件提交的是选项 `value`，该值可从 `approvals.get.form` 的选项定义中取得。\n- `contact`、`department`、`fieldList`、`dateInterval`、`amount`、`telephone`、`document` 等控件的 `value` 结构各不相同，必须按 [`lark-approval-instance-form-control-parameters.md`](./lark-approval-instance-form-control-parameters.md) 单独组装，不要套用文本控件的写法。\n- 值本身从哪里拿，优先按 [`lark-approval-instance-value-sourcing.md`](./lark-approval-instance-value-sourcing.md) 处理；不要把“知道结构”误当成“已经拿到可提交值”。\n- 若 [`lark-approval-instance-form-control-parameters.md`](./lark-approval-instance-form-control-parameters.md) 标明某控件不支持通过创建实例 API 提交，则不要硬猜绕过；应明确告诉用户该定义当前无法仅通过 API 提单。\n- 若遇到当前 skill 未明确覆盖的复杂控件，不要硬猜；先依据 [`lark-approval-instance-form-control-parameters.md`](./lark-approval-instance-form-control-parameters.md) 判断支持性与传值结构，再向用户确认。\n\n## API 不支持的控件\n\n根据 [`lark-approval-instance-form-control-parameters.md`](./lark-approval-instance-form-control-parameters.md)，创建审批实例 API 不支持的控件至少包括：\n\n- `text`\n- `mutableGroup`\n- `account`\n- `serialNumber`\n- `tripGroup`\n- `apaascorehrOnboardingGroup`\n- `apaascorehrRegularateGroup`\n- `remedyGroupV2`\n- `apaascorehrJobAdjustGroup`\n- `apaascorehrOffboardingGroup`\n\n如果目标审批定义包含上述控件，不要继续硬拼 `form`；应直接告诉用户该定义不能仅通过当前 API 完整提单。\n\n## 高频控件速查\n\n优先按 [`lark-approval-instance-form-control-parameters.md`](./lark-approval-instance-form-control-parameters.md) 组装，下面只保留最常用、最容易出错的格式：\n\n- `input` / `textarea`: `value` 是字符串\n- `date`: `value` 是 RFC3339 时间字符串\n- `dateInterval`: `value` 是对象，包含 `start` / `end` / `interval`\n- `radio` / `radioV2`: `value` 是单个选项值，取定义详情里的 `option.value`；关联外部选项时传 `options.id`\n- `checkbox` / `checkboxV2`: `value` 是选项值数组\n- `number`: `value` 是数字\n- `amount`: `value` 是数字，还要带 `currency`\n- `formula`: `value` 必须与定义中的公式结果匹配，否则会报错\n- `contact`: 只推荐写 `open_ids`，由人员信息先转换成 `open_id`\n- `connect`: `value` 是关联审批实例 `instance_code` 数组，当前默认要求用户直接提供 `instance_code`\n- `document`: `value` 是对象，至少含 `token` 和 `type=docx`\n- `attachmentV2` / `image` / `imageV2`: `value` 是 file code 数组，当前默认要求用户直接提供\n- `fieldList`: `value` 是二维数组，子项继续按各自控件类型组装\n- `department`: `value` 是对象数组，元素字段名为 `open_id`，其值填写部门的 `open_department_id`\n- `telephone`: `value` 是对象，包含 `countryCode` 和 `nationalNumber`\n- `address`: `value` 是对象数组，至少包含地理库 `id`，可选 `detailAddress`；当前默认要求用户直接提供该 `id`\n\n## 特殊控件组\n\n[`lark-approval-instance-form-control-parameters.md`](./lark-approval-instance-form-control-parameters.md) 还明确给出了若干特殊控件组的提单格式，至少包括：\n\n- `leaveGroupV2`\n- `workGroup`\n- `outGroup`\n- `shiftGroup`\n\n这类控件组不是简单文本控件，通常内部还嵌套 `radioV2`、`date`、`fieldList`、`image`、`contact` 等子控件。遇到这些控件组时：\n\n- 先从 `approvals.get.form` 找到控件组及其子控件 ID\n- 再严格按 [`lark-approval-instance-form-control-parameters.md`](./lark-approval-instance-form-control-parameters.md) 的示例组装 `value`\n- 不要把控件组整体当成普通字符串或扁平对象提交\n\n### 5. 组装节点参数\n\n从 `node_list` 推导节点参数：\n\n- 若某节点 `need_approver=true`，则必须在 `node_approver_list` 中补该节点的审批人。\n- `key` 优先取 `custom_node_id`；若不存在，再用 `node_id`。\n- `value` 是审批人 `open_id` 列表。\n- 若 `approver_chosen_multi=false`，该节点只允许一个审批人 `open_id`。\n- `node_cc_list` 仅在用户明确需要补充节点抄送人时才填写；其 `key/value` 规则与 `node_approver_list` 相同。\n\n### 6. 创建审批实例\n\n创建命令使用 `approval instances create`，需要的 scopes: [\"approval:instance:write\"]\n\n确认最终表单值和节点参数后再执行：\n\n```bash\nlark-cli approval instances create \\\n --data '{\n \"approval_code\":\"7C468A54-8745-2245-9675-08B7C63E7A85\",\n \"form\":\"[{\\\"id\\\":\\\"widget1\\\",\\\"type\\\":\\\"input\\\",\\\"value\\\":\\\"请假半天\\\"}]\",\n \"node_approver_list\":[\n {\n \"key\":\"manager_node_id\",\n \"value\":[\"ou_xxx\"]\n }\n ]\n }' \\\n --as user \\\n --yes\n```\n\n执行规则：\n\n- 执行前先向用户确认：目标审批定义、核心表单值、节点审批人/抄送人。\n- 若需要幂等，可补 `uuid`。\n- 成功后回报 `instance_code` 与 `instance_link`。\n\n## 组装时优先依据的资料\n\n优先级固定如下：\n\n1. 本文中的创建请求参数、节点参数和返回结果说明：决定 `instances create` 要传哪些字段、怎么执行、成功后回什么。\n2. [`lark-approval-instance-form-control-parameters.md`](./lark-approval-instance-form-control-parameters.md)：决定每种控件的 `value` 结构与支持范围。\n3. [`lark-approval-instance-value-sourcing.md`](./lark-approval-instance-value-sourcing.md)：决定每类值应该从哪里拿，以及当前哪些值必须由用户直接提供。\n4. `approvals.get.form`：提供当前审批定义里实际有哪些控件、控件 `id`、控件 `type`、选项值范围、明细子控件结构。\n5. `approvals.get.node_list`：提供节点 key 与是否需要补充审批人/抄送人的线索。\n\n不要反过来把 `approvals.get.form` 当成第一优先级，更不要把它当成可直接提交的 JSON 模板。\n\n## 最小判断表\n\n| 你手上有什么 | 下一步 |\n|---|---|\n| 只有口语需求，比如“帮我提个请假审批” | 先 `approvals.search` |\n| 已经拿到 `approval_code` | 直接 `approvals.get` |\n| 已拿到 `form` / `node_list`，且用户已给出表单值和审批人 | 组装 `instances create` |\n| `is_external=true` | 返回 `create_link`，不要调 `instances create` |\n\n## 返回结果\n\n完成创建后，至少向用户返回：\n\n- `approval_name`\n- `instance_code`\n- `instance_link`\n\n建议整理为下面这种结构：\n\n```text\n审批已创建成功：\n\n- approval_name: 请假申请\n- instance_code: 19EAC829-F1CB-527F-BE2A-1330422E60C0\n- instance_link: https://...\n```\n","skills/lark-approval/references/lark-approval-instance-form-control-parameters.md":"# 审批实例表单控件参数\n\n> 说明：本文尽量保留上游参数文档的原始结构与示例，用于回答“控件 `value` 长什么样”。\n> 当前 `lark-cli` 的推荐取值口径以 [`lark-approval-instance-value-sourcing.md`](./lark-approval-instance-value-sourcing.md) 为准；如果两份文档在“值从哪里拿”上存在差异，以后者为准。\n\n在调用创建审批实例接口时需要使用表单控件参数，你可以通过本文了解审批实例内各表单控件的参数说明。\n\n## 准备工作\n\n审批实例的表单控件参数依据审批定义表单来配置，例如，审批定义的表单设计包括了 **单行文本** 和 **日期区间** 控件，则审批实例的表单控件参数就需要为 **单行文本** 和 **日期区间** 控件进行赋值。因此，在操作审批实例表单的控件参数前，应先通过审批定义详情确认表单控件结构。\n\n## 审批实例 API 不支持的控件\n\n创建审批实例 API 未完全支持所有的审批表单控件，不支持的控件如下表所示。如果你必须使用 API 不支持的控件，则不能仅通过当前 API 完成提单。\n\n**控件/控件组** | **Type** |\n| ---------- | --------------------------- |\n| 说明 | text |\n| 引用多维表格 | mutableGroup |\n| 收款账户 | account |\n| 流水号 | serialNumber |\n| 出差控件组 | tripGroup |\n| 录用控件组 | apaascorehrOnboardingGroup |\n| 转正控件组 | apaascorehrRegularateGroup |\n| 补卡控件组 | remedyGroupV2 |\n| 调岗控件组 | apaascorehrJobAdjustGroup |\n| 离职控件组 | apaascorehrOffboardingGroup\n\n## 通用参数\n\n审批实例的表单控件均包含的参数如下表所示。\n\n参数 | 类型 | 是否必填 | 描述\n---|---|---|---\nid | string | 是 | 控件的 ID，需要与审批定义中的控件 ID 保持一致。\ntype | string | 是 | 控件类型。各控件类型取值参见下文 **不同控件的参数** 章节。\nvalue | 不同控件的类型不同 | 是 | 控件的取值。不同控件 value 数据类型也不同，例如单行文本控件的 value 为字符串、联系人的 value 为数组。详情参见下文 **不同控件的参数** 章节。\n\n## 不同控件的参数\n\n本章节提供不同控件的 type 参数值、JSON 示例以及非通用参数说明。\n\n### 单行文本\n\n控件 type 为 input，JSON 数据示例：\n\n```json\n{\n \"id\": \"widget1\",\n \"type\": \"input\",\n \"value\": \"data\" // string 类型\n}\n```\n\n### 多行文本\n\n控件 type 为 textarea，JSON 数据示例：\n\n```json\n{\n \"id\": \"widget1\",\n \"type\": \"textarea\",\n \"value\": \"data\" // string 类型\n}\n```\n\n### 日期\n\n控件 type 为 date，JSON 数据示例：\n\n```json\n{\n \"id\": \"widget1\",\n \"type\": \"date\",\n \"value\": \"2019-10-01T08:12:01+08:00\" // 需满足 RFC3339 格式的 string 类型\n}\n```\n\n### 日期区间\n\n控件 type 为 dateInterval，JSON 数据示例：\n\n```json\n{\n \"id\": \"widget1\",\n \"type\": \"dateInterval\",\n \"value\": {\n \"start\":\"2019-10-01T08:12:01+08:00\",\n \"end\":\"2019-10-02T08:12:01+08:00\",\n \"interval\": 1.0\n }\n}\n```\n\nvalue 参数为 object 类型，包含参数说明：\n\n参数 | 类型 | 是否必填 | 描述\n---|---|---|---\nstart | string | 是 | 开始时间，需满足 RFC3339 格式。\nend | string | 是 | 结束时间，需满足 RFC3339 格式。\ninterval | float | 是 | 时长（天）。\n\n### 单选\n\n控件 type 为 radio/radioV2，JSON 数据示例：\n\n```json\n{ \n \"id\": \"widget1\",\n \"type\": \"radioV2\",\n \"value\": \"k2b8mkx0-h71x5gl1234-1\" // string 类型\n}\n```\n\n其中， value 表示选项值，取值范围需要参考相应审批定义中 **单选** 控件 option 的 value 参数。你可以通过审批定义详情返回的 `form` 参数，获取单选控件 option 的 value 取值。如果控件关联了外部选项，则 value 需要传入外部选项的 `options.id`。\n\n### 多选\n\n控件 type 为 checkbox/checkboxV2，JSON数据示例：\n\n```json\n{\n \"id\":\"widget1\",\n \"type\":\"checkboxV2\",\n \"value\": [\"k2b8mkx0-h71x5gl4321-1\"] // string 类型的数组\n}\n```\n其中， value 表示选项值，取值范围需要参考相应审批定义中 **多选** 控件 option 的 value 参数。你可以通过审批定义详情返回的 `form` 参数，获取多选控件 option 的 value 取值。如果控件关联了外部选项，则 value 需要传入外部选项的 `options.id`。\n\n### 数字\n\n控件 type 为 number，JSON 数据示例：\n\n```json\n{\n \"id\": \"widget1\",\n \"type\": \"number\",\n \"value\": 1234.5678 // float 类型\n}\n```\n\n### 金额\n\n控件 type 为 amount，JSON 数据示例：\n\n```json\n{\n \"id\": \"widget1\",\n \"type\": \"amount\",\n \"value\": 1234.5678, // float 类型\n \"currency\":\"USD\"\n}\n```\n\n其中，currency 表示货币种类，取值范围需要参考相应审批定义中 **金额** 控件的 value 参数。你可以通过审批定义详情返回的 `form` 参数，获取金额控件可设置的货币种类。\n\n### 计算公式\n\n控件 type 为 formula，JSON 数据示例：\n\n```json\n{\n \"id\": \"widget1\",\n \"type\": \"formula\",\n \"value\": 1234.5678 // 该值由审批定义内配置的公式计算出取值，若不匹配则返回报错。\n}\n```\n\n### 联系人\n\n控件 type 为 contact，JSON 数据示例：\n\n```json\n{\n \"id\":\"widget1\",\n \"type\":\"contact\",\n \"value\": [\"f8ca557e\"], // string 类型的数组\n \"open_ids\": [\"ou_12345\"] // string 类型的数组\n}\n```\n其中，value 包含的是用户 `user_id`；open_ids 包含的是用户 `open_id`。\n\n### 关联审批\n\n控件 type 为 connect，JSON 数据示例：\n\n```json\n{\n \"id\":\"widget1\",\n \"type\":\"connect\",\n \"value\": [\"19EAC829-F1CB-527F-BE2A-1330422E60C0\"] // string 类型的数组\n}\n```\n其中，value 包含的是被关联的审批实例 Code，你可以通过审批实例详情能力根据实例 Code 获取实例详情。\n\n### 文档控件\n\n控件 type 为 document，JSON 数据示例：\n\n```json\n{\n \"id\": \"widget1\",\n \"type\": \"document\",\n \"value\": {\n \"token\":\"TLLKdcpDro9ijQxA33ycNMabcef\",\n \"type\":\"docx\",\n }\n}\n```\n\nvalue 参数为 object 类型，包含参数说明：\n\n参数 | 类型 | 是否必填 | 描述\n---|---|---|---\ntoken | string | 是 | 文档的 document_id。\ntype | string | 是 | 文档类型，支持 `docx`。\n\n### 附件\n\n控件 type 为 attachmentV2，JSON 数据示例：\n\n```json\n{\n \"id\":\"widget1\",\n \"type\":\"attachmentV2\",\n \"value\": [\"D93653C3-2609-4EE0-8041-61DC1D84F0B5\"] // string 类型的数组\n}\n```\n其中，value 包含的是上传文件后返回的文件 code。\n\n### 图片\n\n控件 type 为 image/imageV2，JSON 数据示例：\n\n```json\n{\n \"id\":\"widget1\",\n \"type\":\"image\",\n \"value\": [\"D93653C3-2609-4EE0-8041-61DC1D84F0B5\"] // string 类型的数组\n}\n```\n\n其中，value 包含的是上传文件后返回的文件 code。\n\n### 明细/表格\n\n控件 type 为 fieldList，JSON 格式示例：\n\n```json\n{\n \"id\": \"widget1\",\n \"type\": \"fieldList\",\n \"value\": [\n [ \n {\n \"id\": \"widget1\",\n \"type\": \"checkbox\",\n \"value\": [\"jxpsebqp-0\"]\n }\n ]\n ]\n}\n```\n\n其中 value 是二维数组，根据审批定义内 **明细/表格** 控件所包含的控件，依次设置控件 JSON 值。\n\n### 部门\n\n控件 type 为 department，JSON 数据示例：\n\n```json\n{\n \"id\":\"widget1\",\n \"type\":\"department\",\n \"value\":[ \n {\n \"open_id\": \"od-xxx\"\n }\n ]\n}\n```\n\n其中 value 为对象数组，通过 open_id 设置部门的 open_department_id。\n\n### 电话\n\n控件 type 为 telephone，JSON 数据示例：\n\n```json\n{\n \"id\":\"widget1\",\n \"type\":\"telephone\",\n \"value\": {\n \"countryCode\":\"+86\",\n \"nationalNumber\":\"13122222222\"\n }\n}\n```\n\nvalue 参数为 object 类型，包含参数说明：\n\n参数 | 类型 | 是否必填 | 描述\n---|---|---|---\ncountryCode | string | 是 | 区号。\nnationalNumber | string | 是 | 电话号。\n\n### 地址\n控件 type 为 address，JSON 数据示例：\n\n```json\n{\n\t\"id\": \"widget1\",\n\t\"type\": \"address\",\n\t\"value\": [{\n\t\t\"id\": \"290557\",\n\t\t\"detailAddress\": \"详细的地址\"\n\t}]\n}\n```\n\nvalue 参数为 []object 类型，参数说明如下：\n\n参数 | 类型 | 是否必填 | 描述\n---|---|---|---\nvalue | []object | 是 | 非出差控件组场景地址控件仅支持单个地址，传入多个时默认只取第一个\n└ id | string | 是 | 区域ID, 可通过审批的地理库接口获取\n└ detailAddress | string | 否 | 详细的地址，若表单配置中未开启填写详细地址，则会忽略该参数，即使传入也不会生效\n\n### 换班控件组\n\n控件 type 为 shiftGroup，JSON 数据示例：\n\n```json\n{\n \"id\": \"widget1\",\n \"type\": \"shiftGroup\",\n \"value\": {\n \"shiftTime\": \"2019-10-01T08:12:01+08:00\",\n \"returnTime\": \"2019-10-02T08:12:01+08:00\",\n \"reason\": \"ask for leave\"\n }\n}\n```\n\nvalue 参数为 object 类型，包含参数说明：\n\n参数 | 类型 | 是否必填 | 描述\n---|---|---|---\nshiftTime | string | 是 | 换班时间，需满足 RFC3339 格式。\nreturnTime | string | 是 | 对调日期，需满足 RFC3339 格式。\nreason | string | 是 | 换班原因。\n\n### 请假控件组\n\n**请假控件组请求示例**\n```json\n{\n \"id\": \"widgetLeaveGroupV2\",\n \"type\": \"leaveGroupV2\",\n \"value\": [\n {\n \"id\": \"widgetLeaveGroupType\",\n \"type\": \"radioV2\",\n \"value\": \"7488925543484620819\"\n },\n {\n \"id\": \"widgetLeaveGroupStartTime\",\n \"type\": \"date\",\n \"value\": \"2025-08-25T11:30:00+08:00\"\n },\n {\n \"id\": \"widgetLeaveGroupEndTime\",\n \"type\": \"date\",\n \"value\": \"2025-08-26T11:35:00+08:00\"\n },\n {\n \"id\": \"widgetLeaveGroupReason\",\n \"type\": \"textarea\",\n \"value\": \"123123\"\n },\n {\n \"id\": \"widgetLeaveCertification\",\n \"type\": \"image\",\n \"value\": [\n \"B69F8E26-0EAA-4A92-9B80-DA613CD36136\"\n ]\n },\n {\n \"id\":\"widgetLeaveCertification\",\n \"type\":\"image\",\n \"value\": [\"D93653C3-2609-4EE0-8041-61DC1D84F0B5\"]\n },\n { \n \"id\": \"widgetLeaveGroupFeedingArrivingLate\",\n \"type\": \"radioV2\",\n \"value\": \"30\"\n },\n { \n \"id\": \"widgetLeaveGroupFeedingOffLeaveEarly\",\n \"type\": \"radioV2\",\n \"value\": \"30\"\n } \n ]\n}\n```\n\n**请假控件组包含参数说明：**\n\nid | 类型 | JSON示例 | 描述\n---|---|---|---\nid | string | 是 | 控件组ID，固定为widgetLeaveGroupV2\ntype | string | 是 | 控件组类型，固定为leaveGroupV2\nvalue | object[] | 是 | 控件组的值，值为多个子控件值的列表\n\nvalue中包含的子控件值说明:\n\nid | 类型 | JSON示例 | 描述\n---|---|---|---\nwidgetLeaveGroupType | radioV2 | ```
{
\"id\": \"widgetLeaveGroupType\",
\"type\": \"radioV2\",
\"value\": \"7488925543484620819\"
}
``` | 假期类型，具体格式可参考单选控件，选项由假勤接口获取，提单时必须包含该控件\nwidgetLeaveGroupStartTime | date | ```
{
\"id\": \"widgetLeaveGroupStartTime\",
\"type\": \"date\",
\"value\": \"2019-10-01T08:12:01+08:00\", // 需满足 RFC3339 格式的 string 类型
}
``` | 请假开始时间，具体格式可参考日期控件，会根据假期类型自动取整,其中半天假小于12点则认为是上午，小时假则以半小时为粒度向前取整, 提单时必须包含该控件\nwidgetLeaveGroupEndTime | date | ```
{
\"id\": \"widgetLeaveGroupEndTime\",
\"type\": \"date\",
\"value\": \"2019-10-01T08:12:01+08:00\", // 需满足 RFC3339 格式的 string 类型
}
``` | 请假结束时间，具体格式可参考日期控件，会根据假期类型自动取整，其中半天假小于12点则认为是上午，小时假则以半小时为粒度向后取整\nwidgetLeaveGroupReason | textarea | ```
{
\"id\": \"widgetLeaveGroupReason\",
\"type\": \"textarea\",
\"value\": \"123123\"
}
``` | 请假事由，具体格式可参考多行文本控件，哺乳假无需填写，其他情况则根据控件组配置中该控件是否可见以及必填判断\nwidgetLeaveCertification | image | ```
{
\"id\":\"widgetLeaveCertification\",
\"type\":\"image\",
\"value\": [\"D93653C3-2609-4EE0-8041-61DC1D84F0B5\"]
}
``` | 请假证明，具体格式可参考图片控件，如果所选假期类型配置要求补充证明则必须传递该值，缺失会报错\nwidgetLeaveGroupFeedingArrivingLate | radioV2 | ```
{
\"id\": \"widgetLeaveGroupFeedingArrivingLate\",
\"type\": \"radioV2\",
\"value\": \"30\"
}
``` | 上班晚到的分钟数，具体格式可参考单选控件，仅哺乳假需要填写，取值范围是0-120分钟，粒度是15分钟，选项从审批定义中该控件的option中获取\nwidgetLeaveGroupFeedingOffLeaveEarly | radioV2 | ```
{
\"id\": \"widgetLeaveGroupFeedingOffLeaveEarly\",
\"type\": \"radioV2\",
\"value\": \"30\"
}
``` | 下班早走的分钟数，具体格式可参考单选控件，仅哺乳假需要填写，取值范围是0-120分钟，粒度是15分钟，选项即是分钟对应的字符串\n\n**特殊的参数校验报错信息**\nmessage | 说明 |\n| -------------------------------------------------- | ---------------------------- |\n| leave type id parse error | 请假类型不是int64 |\n| group value is invalid | 当前控件组的值无效，请校验是否为空或者校验类型是否为数组 |\n| start time format is not RFC3339 | 开始时间日期格式非*RFC3339格式* |\n| end time format is not RFC3339 | 结束时间日期格式非*RFC3339格式* |\n| start time is after end time | 开始时间晚于结束时间 |\n| user not in gray | 申请用户不在假勤灰度内 |\n| leave type not found | 请假类型不存在 |\n| reason is required | 请假原因未填写 |\n| leave quote should be bigger than 0 | 请假时长需要大于0 |\n| leave is conflict | 所选时间内已有请假记录，请选择其他时间 |\n| balance is not enough | 当前假期类型下假期余额不足 |\n| certification is required | 需要上传请假证明 |\n| arriving late is required | 哺乳假需要填写上班晚到时长 |\n| arriving late value is not in the optional items | 晚到时间不在可选范围内 |\n| leaving early is required | 哺乳假需要填写下班提前时长 |\n| leaving early value is not in the optional items | 下班提前时间不在可选范围内 |\n| feeding rest daily is 0 | 哺乳假每日休息时长为0，请重新选择 |\n| the operation is prohibited by the workforce rules | 当前账户已在假勤侧封账，无法提交\n\n### 加班控件组\n\n**加班控件组请求示例**\n```json\n{\n \"id\": \"widgetWorkGroup\",\n \"type\": \"workGroup\",\n \"value\":[\n {\n \"id\":\"widgetWorkGroupOvertimeWorkers\",\n \"type\":\"contact\",\n \"value\": [\"f8ca557e\"],\n \"open_ids\": [\"ou_12345\"]\n },\n {\n \"id\": \"widgetWorkGroupType\",\n \"type\": \"radioV2\",\n \"value\": \"7259635026038505475\"\n },\n {\n \"id\":\"widgetWorkGroupTimeRangeFieldList\",\n \"type\":\"fieldList\",\n \"value\":[\n [\n {\n \"id\":\"widgetWorkGroupStartTime\",\n \"type\":\"date\",\n \"value\":\"2019-10-01T08:12:01+08:00\"\n },\n {\n \"id\":\"widgetWorkGroupEndTime\",\n \"type\":\"date\",\n \"value\":\"2019-10-01T08:12:01+08:00\"\n }\n ]\n ]\n },\n {\n \"id\": \"widgetWorkGroupReason\",\n \"type\": \"textarea\",\n \"value\": \"111\"\n }\n ]\n}\n\n```\n\n**加班控件组参数说明：**\n\n参数 | 类型 | 是否必填 | 描述\n---|---|---|---\nid | string | 是 | 控件组ID，固定为widgetWorkGroup\ntype | string | 是 | 控件组类型，固定为workGroup\nvalue | object[] | 是 | 控件组的值，值为多个子控件值的列表\n\nvalue中包含的子控件值说明:\n\nid | 类型 | JSON示例 | 描述\n---|---|---|---\nwidgetWorkGroupOvertimeWorkers | contact | ```
{
\"id\":\"widgetWorkGroupOvertimeWorkers\",
\"type\":\"contact\",
\"value\": [\"f8ca557e\"],
\"open_ids\": [\"ou_12345\"]
}
``` | 加班人员列表，具体格式可参考联系人控件，如果定义中配置「允许代多人提交」则该字段必填，如果是提交人给自己提交需填写提交人的ID\nwidgetWorkGroupType | radioV2 | ```
{
\"id\": \"widgetWorkGroupType\",
\"type\": \"radioV2\",
\"value\": \"7259635026038505475\" // 对应的类型选项ID
}
``` | 加班类型，具体格式可参考单选控件，如果定义中关闭「关联加班规则」则需要填写该字段\nwidgetWorkGroupTimeRangeFieldList | fieldList | ```
{
\"id\":\"widgetWorkGroupTimeRangeFieldList\",
\"type\":\"fieldList\",
\"value\":[
[
{
\"id\":\"widgetWorkGroupStartTime\",
\"type\":\"date\",
\"value\":\"2019-10-01T08:12:01+08:00\"
},
{
\"id\":\"widgetWorkGroupEndTime\",
\"type\":\"date\",
\"value\":\"2019-10-01T08:12:01+08:00\"
}
]
]
}
``` | 加班时段，具体格式可参考明细控件，如果定义中打开「允许提交多个加班时段」则可以传多个，最多支持30个，否则只会取第一个，单次加班时长不可超过两天\nwidgetWorkGroupReason | textarea | ```
{
\"id\": \"widgetWorkGroupReason\",
\"type\": \"textarea\",
\"value\": \"111\"
}
``` | 加班事由，如果定义中配置了「加班事由」必填，则必须填写该字段\n\n**特殊的参数校验报错信息**\nmessage | 说明 |\n| ---------------------------------------------------------------------------------- | ---------------------------- |\n| the time range list has more than 30 items | 加班时段数量超过30 |\n| group value is invalid | 当前控件组的值无效，请校验是否为空或者校验类型是否为数组 |\n| overtime type is required | 未关联加班规则时，加班类型必填 |\n| work time range is required | 至少需要一个加班时段 |\n| start time is after end time | 开始时间晚于结束时间 |\n| start time or end time of range is required | 加班时间段的开始时间和结束时间必填 |\n| overtime duration is over 2 days | 单次加班时长不可超过两天 |\n| overtime date time zone not support | 加班时段的日期时区信息无法识别 |\n| {date} can not apply overtime | 所选时间不可申请加班 |\n| {date} already apply overtime | 所选时间已经有加班记录 |\n| {date} no need approval | 所选日期加班无需申请 |\n| apply reason is required | 定义中设置了加班事由为必填，不可为空 |\n| {users} user follow different overtime rules, cannot be submitted in the same form | 所选加班人不在同一个考勤组内，无法同时提交加班 |\n| invalid overtime work application | 没有有效的加班申请，请重新选择加班日期 |\n| the overtime duration cannot be 0 | 加班时长不能是0 |\n| the number of apply workers cannot exceed 50 | 单次申请加班人数量不可大于50 |\n| apply worker is required | 必须有加班人，配置置可代多人提交时必须指定加班人 |\n| resigned worker can not apply | 离职人员不可申请加班 |\n| overtime duration is over limit | 加班时长超过限制\n\n### 外出控件组\n\n**外出控件组请求体示例**\n```json\n{\n \"id\": \"widgetOutGroup\",\n \"type\": \"outGroup\",\n \"value\":[\n {\n \"id\": \"widgetOutGroupType\",\n \"type\": \"radioV2\",\n \"value\": \"me15yqrf-gmjgbml2vhp-0\" \n },\n {\n \"id\": \"widgetOutGroupStartTime\",\n \"type\": \"date\",\n \"value\":\"2019-10-01T08:12:01+08:00\"\n },\n {\n \"id\": \"widgetOutGroupEndTime\",\n \"type\": \"date\",\n \"value\":\"2019-10-01T08:12:01+08:00\"\n },\n {\n \"id\": \"widgetOutGroupReason\",\n \"type\": \"textarea\",\n \"value\":\"123213\"\n },\n {\n \"id\":\"widgetOutGroupImage\",\n \"type\":\"image\",\n \"value\": [\"D93653C3-2609-4EE0-8041-61DC1D84F0B5\"]\n } \n ] \n}\n\n```\n\n**外出控件参数说明**\n\n参数 | 类型 | 是否必填 | 描述\n---|---|---|---\nid | string | 是 | 控件组ID，固定为widgetOutGroup\ntype | string | 是 | 控件组Type，固定为outGroup\nvalue | object[] | 是 | 控件组的值，值为多个子控件值的列表\n\nvalue中包含的子控件值说明:\n\nid | 类型 | JSON示例 | 描述\n---|---|---|---\nwidgetOutGroupType | radioV2 | ```
{
\"id\": \"widgetOutGroupType\",
\"type\": \"radioV2\",
\"value\": \"me15yqrf-gmjgbml2vhp-0\"
}
``` | 外出类型，具体格式可参考单选控件，如果配置了「外出类型」则必填，外出时长单位会选取所选外出类型关联的单位，如果没有配置「外出类型」，则该字段无需填写，计算外出时长时会选取「外出时长」配置的单位\nwidgetOutGroupStartTime | date | ```
{
\"id\": \"widgetOutGroupStartTime\",
\"type\": \"date\",
\"value\":\"2019-10-01T08:12:01+08:00\"
}
``` | 外出开始时间，具体格式可参考日期控件，如果外出时长单位是半天假，则小于12点则认为是上午，否则认为是下午；如果单位是小时，则会按半小时的粒度向前取整\nwidgetOutGroupEndTime | date | ```
{
\"id\": \"widgetOutGroupEndTime\",
\"type\": \"date\",
\"value\":\"2019-10-01T08:12:01+08:00\"
}
``` | 外出结束时间，具体格式可参考日期控件，如果外出时长单位是半天假，则小于12点则认为是上午，否则认为是下午；如果单位是小时，则会按半小时的粒度向后取整\nwidgetOutGroupReason | textarea | ```
{
\"id\": \"widgetOutGroupReason\",
\"type\": \"textarea\",
\"value\":\"123213\"
}
``` | 外出事由，具体格式可参考多行文本控件，如果定义中「外出事由」必填，则必须填写该控件，如果定义配置无需填写，则无需填写该控件\nwidgetOutGroupImage | image | ```
{
\"id\":\"widgetOutGroupImage\",
\"type\":\"image\",
\"value\": [\"D93653C3-2609-4EE0-8041-61DC1D84F0B5\"]
}
``` | 外出证明，具体格式可参考图片控件，如果定义中「外出拍照」必填，则必须填写该控件，如果定义配置无需填写，则无需填写该控件\n\n**特殊的参数校验报错信息**\n\nmessage | 说明 |\n| ----------------------------------------------------- | ---------------------------- |\n| group value is invalid | 当前控件组的值无效，请校验是否为空或者校验类型是否为数组 |\n| start time format is not RFC3339 | 开始时间日期格式非*RFC3339格式* |\n| end time format is not RFC3339 | 结束时间日期格式非*RFC3339格式* |\n| start time and end time must be in the same time zone | 开始时间与结束时间必须是同一时区 |\n| out type is required | 如果定义中设定了「外出类型」，则外出类型必填 |\n| out start time is required | 外出开始时间必填 |\n| out end time is required | 外出结束时间必填 |\n| out duration must be greater than 0 | 外出间隔不能为0，请检查起止时间并重新选择 |\n| out reason is empty | 如果定义中勾选「外出事由」同时设定必填，则该字段必填 |\n| photo is required | 如果定义中勾选「外出拍照」同时设定必填，则该字段必填 |\n| out time is conflict | 外出时间有冲突，请确认是否已在该时段申请外出\n","skills/lark-approval/references/lark-approval-instance-value-sourcing.md":"# 审批提单值来源\n\n## 目的\n\n本文用于回答一个固定问题：在调用 `approval instances create` 发起原生审批实例时，**每个要填写的值从哪里拿**。\n\n阅读顺序固定如下：\n\n1. [`lark-approval-initiate.md`](./lark-approval-initiate.md) 中的创建请求参数、节点参数和返回结果说明\n2. `approval approvals get` 返回的 `form` / `node_list`\n3. [`lark-approval-instance-form-control-parameters.md`](./lark-approval-instance-form-control-parameters.md)\n4. 本文\n\n## 总原则\n\n- `lark-approval-initiate.md` 决定创建请求字段名、字段层级、节点参数结构。\n- `approvals.get.form` 决定控件 `id`、`type`、选项值范围、子控件结构。\n- `approvals.get.node_list` 决定节点 key、是否必须补审批人、是否允许多人。\n- [`lark-approval-instance-form-control-parameters.md`](./lark-approval-instance-form-control-parameters.md) 决定各控件 `value` 的最终结构。\n- 除非本文明确允许，否则不要猜值来源，不要把展示文案直接当成可提交值。\n\n## 默认来源\n\n- 审批定义、`approval_code`、`is_external`、`create_link` 等基础信息，默认从 `approval approvals search` 获取。\n- 控件 `id`、`type`、选项值、子控件结构，默认从 `approval approvals get.form` 获取。\n- 节点 key、`need_approver`、`approver_chosen_multi` 等节点信息，默认从 `approval approvals get.node_list` 获取。\n- 本文只补充 **这些默认来源之外** 的取值规则，以及当前必须由用户直接提供的值。\n\n## 控件值来源规则\n\n### 联系人 `contact`\n\n- 只推荐写 `open_ids`。\n- 不再推荐双写 `value(user_id)` + `open_ids`，避免复杂度继续上升。\n- 如果用户给的是姓名、邮箱或账号，先用 `lark-contact` 解析成 `open_id`。\n\n### 部门 `department`\n\n- 最优先：用户直接提供 `open_department_id`。\n- 若用户说“我的部门”或“张三的部门”，先用 `lark-contact` 查询对应人员信息，再取其所属部门里的 `open_department_id`。\n- 如果查到该人员只有一个部门，可直接使用。\n- 如果查到多个部门，不自动猜，必须让用户明确选一个，或直接输入 `open_department_id`。\n- 如果仍无法确定，则明确告知当前不支持自动决定部门值。\n\n### 附件 `attachmentV2`\n\n- 当前 `lark-approval` 不负责上传文件。\n- 用户必须直接提供 file code。\n- 如果用户无法提供 file code，应明确告知当前无法仅通过 `lark-approval` 完成该控件提单。\n\n### 图片 `image` / `imageV2`\n\n- 当前 `lark-approval` 不负责上传图片。\n- 用户必须直接提供 file code。\n- 如果用户无法提供 file code，应明确告知当前无法仅通过 `lark-approval` 完成该控件提单。\n\n### 文档 `document`\n\n- 用户可直接提供 `token` / `document_id`。\n- 如果用户给的是飞书文档链接，应先尝试从链接中提取 token。\n- 若链接提取失败，再要求用户手动输入 token。\n\n### 关联审批 `connect`\n\n- 用户直接提供目标审批实例的 `instance_code`。\n- 当前不默认做“搜索关联实例再反查 code”的自动流程。\n\n### 地址 `address`\n\n- 用户直接提供地理库 `id`。\n- 若用户无法提供该 `id`，当前不支持自动取值。\n\n## 特殊控件组\n\n以下控件组的结构仍按 [`lark-approval-instance-form-control-parameters.md`](./lark-approval-instance-form-control-parameters.md) 组装：\n\n- `leaveGroupV2`\n- `workGroup`\n- `outGroup`\n- `shiftGroup`\n\n补充规则：\n\n- 控件组自身和子控件的 `id` / `type` 从 `approval approvals get.form` 中识别。\n- 组内单选/多选或业务枚举值，优先从 `approval approvals get.form` 返回的选项结构中取。\n- 不要把控件组整体当成普通字符串或扁平对象提交。\n\n## 不支持自动准备的值\n\n以下值当前不建议由 `lark-approval` 自动准备：\n\n- 文件上传后的 file code\n- 图片上传后的 file code\n- 地址控件的地理库 `id`\n- 无法唯一确定的部门 `open_department_id`\n\n遇到这类值时，应明确告诉用户需要提供什么，而不是继续猜测。\n\n## 最小决策表\n\n| 场景 | 处理 |\n|---|---|\n| 用户说“找张三当审批人” | 用 `lark-contact` 解析张三，取 `open_id` |\n| 用户说“我的部门” | 先查当前用户部门；若多个部门，让用户选 |\n| 用户给了文档链接 | 先尝试提取 token |\n| 用户要填图片/附件 | 要求直接提供 file code |\n| 用户要填关联审批 | 要求直接提供 `instance_code` |\n| 用户要填地址 | 要求直接提供地理库 `id` |\n","skills/lark-approval/references/lark-approval-instances-cancel.md":"\n# approval instances cancel\n\n撤回一个已发起的审批实例（用户级写操作）。通常先通过 `instances initiated`、`tasks query` 或 `instances get` 确认目标审批实例，拿到 `instance_code` 后再执行撤回。\n\n> [!CAUTION]\n> 这是 **high-risk-write** 写操作。建议先用 `--dry-run` 预览；真正执行时，如果用户已明确要撤回该审批实例且目标实例无误，再带 `--yes` 运行。不要在未获用户明确同意时静默追加 `--yes`。\n\n需要的 scopes: [\"approval:instance:write\"]\n\n## 命令\n\n```bash\n# 先预览请求，不实际执行\nlark-cli approval instances cancel \\\n --data '{\"instance_code\":\"\"}' \\\n --as user \\\n --dry-run\n\n# 撤回一个审批实例\nlark-cli approval instances cancel \\\n --data '{\"instance_code\":\"\"}' \\\n --as user \\\n --yes\n\n# 通过文件传入请求体\nlark-cli approval instances cancel \\\n --data @./cancel-body.json \\\n --as user \\\n --yes\n```\n\n## 参数\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `--data '{...}'` | 是 | 请求体 JSON，使用 JSON 传入 |\n| `instance_code` | 是 | 审批实例 Code；通常先通过 `instances initiated`、`tasks query` 或 `instances get` 获取 |\n| `--as user` | 否 | 建议显式指定用户身份；审批实例撤回通常必须以用户身份执行 |\n| `--yes` | 否 | 确认执行高风险写操作；未带时可能返回 `confirmation_required` / exit 10 |\n| `--format` | 否 | 输出格式：`json`（默认）、`ndjson`、`table`、`csv` |\n| `--dry-run` | 否 | 预览 API 调用，不执行 |\n\n## 典型前置步骤\n\n如果你要找“我发起的审批实例”，可先查询已发起列表：\n\n```bash\nlark-cli approval instances initiated --params '{\"page_size\":20}' --as user\n```\n\n如果你已经在任务列表中定位到某个审批，也可以从任务里拿到实例 Code：\n\n```bash\nlark-cli approval tasks query --params '{\"topic\":\"1\"}' --as user\n```\n\n常用到的字段：\n\n| 字段 | 说明 |\n|------|------|\n| `instances[].instance_code` | 审批实例 Code；撤回时必须提供 |\n| `tasks[].instance_code` | 审批任务关联的审批实例 Code；也可作为撤回输入 |\n| `tasks[].instance_status` | 审批实例状态；可用于判断是否仍处于可撤回阶段 |\n\n如需先确认审批表单、当前节点、流转状态，可继续查看实例详情：\n\n```bash\nlark-cli approval instances get --params '{\"instance_code\":\"\"}' --as user\n```\n\n## 使用建议\n\n- **撤回的是审批实例，不是单个任务**：`instances cancel` 只需要 `instance_code`，不需要 `task_id`。\n- **优先确认实例是否仍可撤回**：已经通过、已拒绝、已撤销或已终止的实例通常不适合继续撤回。\n- **优先从 `instances initiated` 获取目标实例**：因为撤回通常针对“我发起的审批”，这个入口最直接。\n- **也可从 `tasks query` 反查 `instance_code`**：当你是从某个待办/已办上下文进入时，这样更方便。\n- **先 `--dry-run` 再执行**：尤其在实例来源不明确、用户只给了标题关键字，或一次要核对多个实例时，先预览更安全。\n","skills/lark-approval/references/lark-approval-instances-cc.md":"\n# approval instances cc\n\n给一个审批实例追加抄送人（用户级写操作）。通常先通过 `instances initiated`、`tasks query` 或 `instances get` 确认目标审批实例，拿到 `instance_code` 后，再提供抄送人的用户 ID 执行抄送。\n\n> [!CAUTION]\n> 这是 **high-risk-write** 写操作。建议先用 `--dry-run` 预览；真正执行时，如果用户已明确要抄送该审批实例且目标实例、抄送对象都无误，再带 `--yes` 运行。不要在未获用户明确同意时静默追加 `--yes`。\n\n需要的 scopes: [\"approval:instance:write\"]\n\n## 命令\n\n```bash\n# 先预览请求，不实际执行\nlark-cli approval instances cc \\\n --data '{\"instance_code\":\"\",\"cc_user_ids\":[\"ou_xxx\"],\"comment\":\"抄送给项目 owner 了解进展\"}' \\\n --params '{\"user_id_type\":\"open_id\"}' \\\n --as user \\\n --dry-run\n\n# 按 open_id 抄送一个人\nlark-cli approval instances cc \\\n --data '{\"instance_code\":\"\",\"cc_user_ids\":[\"ou_xxx\"],\"comment\":\"抄送给你知悉\"}' \\\n --params '{\"user_id_type\":\"open_id\"}' \\\n --as user \\\n --yes\n\n# 一次抄送多个人\nlark-cli approval instances cc \\\n --data '{\"instance_code\":\"\",\"cc_user_ids\":[\"ou_xxx\",\"ou_yyy\"],\"comment\":\"请相关同学同步关注\"}' \\\n --params '{\"user_id_type\":\"open_id\"}' \\\n --as user \\\n --yes\n\n# 按 user_id 抄送\nlark-cli approval instances cc \\\n --data '{\"instance_code\":\"\",\"cc_user_ids\":[\"123456789\"],\"comment\":\"抄送给财务负责人\"}' \\\n --params '{\"user_id_type\":\"user_id\"}' \\\n --as user \\\n --yes\n\n# 通过文件传入请求体\nlark-cli approval instances cc \\\n --data @./cc-body.json \\\n --params '{\"user_id_type\":\"open_id\"}' \\\n --as user \\\n --yes\n```\n\n## 参数\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `--data '{...}'` | 是 | 请求体 JSON，使用 JSON 传入 |\n| `instance_code` | 是 | 审批实例 Code；通常先通过 `instances initiated`、`tasks query` 或 `instances get` 获取 |\n| `cc_user_ids` | 是 | 抄送人的用户 ID 数组；需要和 `user_id_type` 保持一致 |\n| `comment` | 否 | 抄送留言，例如 `抄送给你知悉`、`请同步关注该审批进展` |\n| `--params '{\"user_id_type\":\"...\"}'` | 否 | 查询参数 JSON；用于声明 `cc_user_ids` 内用户 ID 的类型 |\n| `user_id_type` | 否 | 用户 ID 类型：`user_id`、`union_id`、`open_id`；未显式指定时要特别确认抄送人的 ID 类型 |\n| `--as user` | 否 | 建议显式指定用户身份；审批实例抄送通常必须以用户身份执行 |\n| `--yes` | 否 | 确认执行高风险写操作；未带时可能返回 `confirmation_required` / exit 10 |\n| `--format` | 否 | 输出格式：`json`（默认）、`ndjson`、`table`、`csv` |\n| `--dry-run` | 否 | 预览 API 调用，不执行 |\n\n## 典型前置步骤\n\n如果你要找“我发起的审批实例”，可先查询已发起列表：\n\n```bash\nlark-cli approval instances initiated --params '{\"page_size\":20}' --as user\n```\n\n如果你已经在任务列表中定位到某个审批，也可以从任务里拿到实例 Code：\n\n```bash\nlark-cli approval tasks query --params '{\"topic\":\"1\"}' --as user\n```\n\n常用到的字段：\n\n| 字段 | 说明 |\n|------|------|\n| `instances[].instance_code` | 审批实例 Code；抄送时必须提供 |\n| `tasks[].instance_code` | 审批任务关联的审批实例 Code；也可作为抄送输入 |\n| `tasks[].title` | 任务标题，可用于确认是否是要操作的那个审批 |\n| `tasks[].instance_status` | 审批实例状态；可用于判断当前审批是否仍处于进行中 |\n\n如果你手里只有姓名或邮箱，建议先通过联系人能力解析出正确的用户 ID，再执行抄送。\n\n如需先确认审批表单、当前节点、流转状态，可继续查看实例详情：\n\n```bash\nlark-cli approval instances get --params '{\"instance_code\":\"\"}' --as user\n```\n\n## 使用建议\n\n- **抄送的是审批实例，不是单个任务**：`instances cc` 只需要 `instance_code`，不需要 `task_id`。\n- **`cc_user_ids` 与 `user_id_type` 必须匹配**：例如传 open_id 就把 `user_id_type` 设为 `open_id`；不要混用。\n- **`cc_user_ids` 是数组**：即使只抄送一个人，也要按数组形式传入。\n- **优先显式传 `user_id_type`**：这样 agent 更容易判断参数含义，也能减少 ID 类型不匹配带来的失败。\n- **优先从 `instances initiated` 获取目标实例**：因为抄送常见于“我发起的审批”场景，这个入口最直接。\n- **也可从 `tasks query` 反查 `instance_code`**：当你是从某个审批上下文进入时，这样更方便。\n- **`comment` 建议简洁明确**：例如 `抄送给你知悉`、`请同步关注审批进展`。避免过长或模糊描述。\n- **先 `--dry-run` 再执行**：尤其在抄送对象较多、抄送人来源不明确，或需要让用户先核对实例标题时，先预览更安全。\n","skills/lark-approval/references/lark-approval-instances-get.md":"\n# approval instances get\n\n获取单个审批实例详情（用户级只读操作）。适合在执行 approve / reject / transfer / rollback / cancel / cc / remind 之前，先查看审批表单、当前节点、任务列表、审批动态和整体状态。\n\n需要的 scopes: [\"approval:instance:read\"]\n\n## 命令\n\n```bash\n# 按实例 Code 查询详情\nlark-cli approval instances get --params '{\"instance_code\":\"\"}' --as user\n\n# 表格格式输出，便于快速浏览顶层字段\nlark-cli approval instances get --params '{\"instance_code\":\"\"}' --format table --as user\n\n# 预览 API 调用，不执行\nlark-cli approval instances get --params '{\"instance_code\":\"\"}' --as user --dry-run\n```\n\n## 参数\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `--params '{...}'` | 是 | 查询参数，使用 JSON 传入 |\n| `instance_code` | 是 | 审批实例 Code |\n| `locale` | 否 | 返回语言，例如 `zh-CN`、`en-US`、`ja-JP` |\n| `user_id_type` | 否 | 用户 ID 类型：`user_id`、`union_id`、`open_id` |\n| `--as user` | 否 | 建议显式指定用户身份；审批实例详情查询通常应使用用户身份 |\n| `--format` | 否 | 输出格式：`json`（默认）、`ndjson`、`table`、`csv` |\n| `--dry-run` | 否 | 预览 API 调用，不执行 |\n\n## 常见输入来源\n\n如果你已经有实例 Code，可直接查询：\n\n```bash\nlark-cli approval instances get --params '{\"instance_code\":\"\"}' --as user\n```\n\n如果你还没有实例 Code，可先从以下命令获取：\n\n```bash\n# 查询我发起的审批实例\nlark-cli approval instances initiated --params '{\"page_size\":20}' --as user\n\n# 或从任务列表里拿到关联实例 Code\nlark-cli approval tasks query --params '{\"topic\":\"1\"}' --as user\n```\n\n## 输出重点字段\n\n返回结果中常见字段：\n\n| 字段 | 说明 |\n|------|------|\n| `instance_code` | 审批实例 Code |\n| `serial_number` | 审批单编号 |\n| `definition_code` | 审批定义 Code |\n| `definition_name` | 审批名称 |\n| `user_id` | 发起审批的用户 ID |\n| `department_id` | 发起人所在部门 ID |\n| `status` | 审批实例状态，见下方“status 枚举” |\n| `reverted` | 单据是否已被撤销 |\n| `start_time` | 审批创建时间 |\n| `end_time` | 审批完成时间，未完成时通常为 `0` |\n| `form` | 表单数据，JSON 字符串 |\n| `current_nodes` | 当前审批节点列表 |\n| `tasks` | 审批任务列表 |\n| `operation_records` | 审批动态，例如通过、拒绝、转交、加签、回退、撤回、抄送 |\n| `comments` | 评论列表 |\n\n## status 枚举\n\n| 值 | 含义 |\n|----|------|\n| `PENDING` | 审批中 |\n| `APPROVED` | 已通过 |\n| `REJECTED` | 已拒绝 |\n| `CANCELED` | 已撤回 |\n| `DELETED` | 已删除 |\n\n## current_nodes 重点字段\n\n`current_nodes` 常用于判断审批流当前卡在哪一层：\n\n| 字段 | 说明 |\n|------|------------------------------------------|\n| `current_nodes[].node_id` | 当前审批节点 ID |\n| `current_nodes[].node_name` | 当前审批节点名称 |\n| `current_nodes[].type` | 审批方式：`AND` 会签、`OR` 或签、`SEQUENTIAL` 依次审批等 |\n| `current_nodes[].approvers[].task_id` | 当前审批人关联任务 ID |\n| `current_nodes[].approvers[].user_id` | 当前审批人用户 ID |\n\n## tasks 重点字段\n\n`tasks` 常用于把实例和具体审批任务关联起来：\n\n| 字段 | 说明 |\n|------|------|\n| `tasks[].id` | 审批任务 ID |\n| `tasks[].node_id` | 任务所属节点 ID |\n| `tasks[].node_name` | 任务所属节点名称 |\n| `tasks[].user_id` | 审批人用户 ID |\n| `tasks[].status` | 任务状态：`PENDING`、`APPROVED`、`REJECTED`、`TRANSFERRED`、`DONE` |\n| `tasks[].start_time` | 任务开始时间 |\n| `tasks[].end_time` | 任务完成时间 |\n\n## operation_records 重点字段\n\n`operation_records` 常用于审计审批过程：\n\n| 字段 | 说明 |\n|------|------|\n| `operation_records[].type` | 事件类型，如 `PASS`、`REJECT`、`TRANSFER`、`ROLLBACK`、`CANCEL`、`CC` |\n| `operation_records[].create_time` | 事件发生时间 |\n| `operation_records[].user_id` | 触发该事件的用户 ID |\n| `operation_records[].task_id` | 关联任务 ID |\n| `operation_records[].node_id` | 关联节点 ID |\n| `operation_records[].comment` | 理由 / 备注 |\n| `operation_records[].cc_user_ids` | 被抄送人列表（抄送事件时） |\n\n## 使用建议\n\n- **这是最适合做“详情确认”的只读命令**：当你已经拿到 `instance_code`，需要确认表单、当前节点、任务状态、审批动态时，优先使用它。\n- **在执行写操作前先看详情**：例如做 `tasks rollback` 前确认可退回节点，做 `instances cancel` 前确认实例状态，做 `tasks remind` 前确认当前任务是否仍待处理。\n- **`form` 是 JSON 字符串**：调用方通常还需要再解析一层，才能拿到表单字段值。\n- **`current_nodes` 和 `tasks` 可以联动看**：前者看“当前卡在哪个节点”，后者看“每个任务目前由谁处理、状态如何”。\n- **`operation_records` 适合做时间线回溯**：例如排查谁转交过、谁加签过、什么时候撤回或抄送过。\n- **优先显式传 `locale` 和 `user_id_type`**：这样 agent 更容易理解返回文本和 ID 语义，减少歧义。\n\n## 输出与后续操作\n\n读取详情后，常见下一步：\n\n```bash\n# 同意审批任务\nlark-cli approval tasks approve --data '{\"instance_code\":\"\",\"task_id\":\"\"}' --as user --yes\n\n# 撤回审批实例\nlark-cli approval instances cancel --data '{\"instance_code\":\"\"}' --as user --yes\n\n# 催办审批任务\nlark-cli approval tasks remind --data '{\"instance_code\":\"\",\"task_ids\":[\"\"]}' --as user --yes\n```\n","skills/lark-approval/references/lark-approval-instances-initiated.md":"\n# approval instances initiated\n\n查询当前用户已发起的审批实例列表（用户级只读操作）。适合在需要查看“我发起了哪些审批”、筛选某类审批定义、获取 `instance_code` 供后续 `instances get` / `instances cancel` / `instances cc` 等命令使用时调用。\n\n需要的 scopes: [\"approval:instance:read\"]\n\n## 命令\n\n```bash\n# 查询我发起的审批列表\nlark-cli approval instances initiated --params '{\"page_size\":20}' --as user\n\n# 只看某个审批定义下我发起的实例\nlark-cli approval instances initiated --params '{\"definition_code\":\"\",\"page_size\":20}' --as user\n\n# 按关键词搜索我发起的实例\nlark-cli approval instances initiated --params '{\"keyword\":\"测试\",\"page_size\":10}' --as user\n\n# 按发起时间范围筛选（秒级时间戳）\nlark-cli approval instances initiated --params '{\"start_timestamp\":\"\",\"end_timestamp\":\"\",\"page_size\":20}' --as user\n\n# 使用 page_token 翻页\nlark-cli approval instances initiated --params '{\"page_size\":20,\"page_token\":\"example_page_token\"}' --as user\n\n# 表格格式输出，便于快速浏览\nlark-cli approval instances initiated --params '{\"page_size\":20}' --format table --as user\n\n# 预览 API 调用，不执行\nlark-cli approval instances initiated --params '{\"page_size\":20}' --as user --dry-run\n```\n\n## 参数\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `--params '{...}'` | 否 | 查询参数，使用 JSON 传入；不传时使用默认分页与筛选 |\n| `definition_code` | 否 | 审批定义 Code，用于只查看某个审批定义下我发起的实例 |\n| `keyword` | 否 | 搜索关键词；非空时走搜索链路，空或仅空格时保持普通列表链路 |\n| `start_timestamp` | 否 | 按发起时间筛选，时间范围开始值，秒级时间戳 |\n| `end_timestamp` | 否 | 按发起时间筛选，时间范围结束值，秒级时间戳 |\n| `locale` | 否 | 返回语言：`zh-CN`、`en-US`、`ja-JP` |\n| `page_size` | 否 | 分页大小 |\n| `page_token` | 否 | 翻页标记；首次请求不填，后续使用上一次返回的 `page_token` |\n| `user_id_type` | 否 | 用户 ID 类型：`user_id`、`union_id`、`open_id` |\n| `--as user` | 否 | 建议显式指定用户身份；已发起审批列表查询通常应使用用户身份 |\n| `--format` | 否 | 输出格式：`json`（默认）、`ndjson`、`table`、`csv` |\n| `--dry-run` | 否 | 预览 API 调用，不执行 |\n\n## 输出重点字段\n\n返回结果中常见字段：\n\n| 字段 | 说明 |\n|------|------|\n| `count` | 列表计数，只在第一页返回；大于等于 100 个实例时返回 `99` |\n| `has_more` | 是否还有更多数据 |\n| `page_token` | 下一页翻页 Token |\n| `instances[].instance_code` | 审批实例 Code；后续查询详情或执行撤回 / 抄送时通常需要 |\n| `instances[].definition_code` | 审批定义 Code |\n| `instances[].definition_name` | 审批定义名称 |\n| `instances[].definition_group_id` | 审批定义分组 ID |\n| `instances[].definition_group_name` | 审批定义分组名称 |\n| `instances[].initiator` | 发起人 ID |\n| `instances[].initiator_name` | 发起人姓名 |\n| `instances[].instance_status` | 审批实例状态，见下方“instance_status 枚举” |\n| `instances[].instance_external_id` | 第三方审批实例 ID（仅第三方审批实例存在） |\n| `instances[].link` | 三方审批跳转链接 |\n| `instances[].summaries` | 摘要字段列表 |\n\n## instance_status 枚举\n\n| 值 | 含义 |\n|----|------|\n| `0` | 无流程状态，不展示对应标签 |\n| `1` | 流程实例流转中 |\n| `2` | 已通过 |\n| `3` | 已拒绝 |\n| `4` | 已撤销 |\n| `5` | 已终止 |\n\n## 常见使用场景\n\n### 1) 找到我要操作的审批实例\n\n```bash\nlark-cli approval instances initiated --params '{\"page_size\":20}' --format table --as user\n```\n\n拿到 `instances[].instance_code` 后，可继续：\n\n```bash\n# 查看审批实例详情\nlark-cli approval instances get --params '{\"instance_code\":\"\"}' --as user\n\n# 撤回审批实例\nlark-cli approval instances cancel --data '{\"instance_code\":\"\"}' --as user --yes\n```\n\n### 2) 只看某类审批\n\n```bash\nlark-cli approval instances initiated \\\n --params '{\"definition_code\":\"\",\"page_size\":20}' \\\n --as user\n```\n\n\n## 使用建议\n\n- **这是定位“我发起的审批实例”的首选命令**：如果你的目标是撤回、抄送、查看某个已发起审批，优先从这里拿 `instance_code`。\n- **优先用 `definition_code` 缩小范围**：当你已知审批定义时，先筛掉无关实例，可显著提升可读性。\n- **需要搜索时传入 `keyword`**：搜索排序和普通列表排序不同，按搜索服务结果为准。\n- **按时间排查时使用 `start_timestamp` / `end_timestamp`**：这两个值都是秒级时间戳，用于按发起时间缩小结果范围。\n- **结果很多时优先 `--format table`**：适合人工快速浏览。\n- **`count` 只在第一页返回**：做分页处理时不要假设后续页还会带总数。\n- **`instance_status` 可直接判断下一步**：例如状态为 `1` 时通常可继续查看详情或考虑撤回，状态为 `4` 表示已经撤销，无需重复撤回。\n- **摘要字段 `summaries` 很适合做列表预览**：当审批标题不够明确时，可结合摘要值帮助识别目标实例。\n\n## 输出与后续操作\n\n拿到列表后，常见下一步：\n\n```bash\n# 查看单个审批实例详情\nlark-cli approval instances get --params '{\"instance_code\":\"\"}' --as user\n\n# 撤回审批实例\nlark-cli approval instances cancel --data '{\"instance_code\":\"\"}' --as user --yes\n\n# 给审批实例追加抄送人\nlark-cli approval instances cc --data '{\"instance_code\":\"\",\"cc_user_ids\":[\"\"]}' --params '{\"user_id_type\":\"open_id\"}' --as user --yes\n```\n","skills/lark-approval/references/lark-approval-tasks-add-sign.md":"\n# approval tasks add_sign\n\n给一个审批任务加签（用户级写操作）。通常先通过 `tasks query` 拿到 `task_id` 和 `instance_code`，确认目标任务后，再提供被加签人的用户 ID、加签方式等参数执行加签。\n\n> [!CAUTION]\n> 这是 **high-risk-write** 写操作。建议先用 `--dry-run` 预览；真正执行时，如果用户已明确要对该审批任务加签且目标任务、加签对象、加签方式都无误，再带 `--yes` 运行。用户已明确要求立即执行且列清本轮的加签、转交对象时，该确认覆盖这两个已明确的动作，不要逐条重复询问；不要在未获用户明确同意时静默追加 `--yes`。\n\n需要的 scopes: [\"approval:task:write\"]\n\n## 先选择加签类型\n\n`add_sign_type` 会影响当前用户的审批任务是否继续可操作，不能只按示例顺序或任意选择：\n\n| 用户意图 | `add_sign_type` | 处理方式 |\n|----------|-----------------|----------|\n| 明确说前加签 / “先让某人审核，我再审” | `1` | 前加签，并按用户要求选择 `approval_method` |\n| 明确说后加签 / “我处理完，再让某人审核” | `2` | 后加签，并按用户要求选择 `approval_method` |\n| “拉进来一起审” / “共同审核” / “一并确认” | `3` | 并加签；不传 `approval_method` |\n| 同一请求要求先加签、再转交当前用户这一环 | `3` | **必须并加签**；加签成功后再转交当前任务 |\n\n前加签或后加签可能推动当前用户的 task 流转，使原 `task_id` 不再支持后续转交。因此，“先加签，再把我这一环转交给其他人”不能使用前加签或后加签；先以 `add_sign_type: 3` 并加签，确认 `tasks add_sign` 成功后，再使用同一组 `instance_code` + `task_id` 执行 `tasks transfer`。\n\n只有在上下文完全无法判断是哪种加签方式、且不同选择会改变审批流程时，才向用户二次询问。用户已经说“一起审”或已经要求“加签后转交当前环节”时，信息足够，不要再询问加签类型。\n\n## 再选择 approval_method\n\n只有前加签、后加签需要 `approval_method`；并加签不传。先遵循用户明确指定的审批方式；用户未指定时，按人数和语义选择：\n\n| 加签人数与语义 | `approval_method` | 处理方式 |\n|----------------|-------------------|----------|\n| 只有 1 名加签人 | `1` | 使用或签；单人时或签、会签的实际效果相同，不再询问 |\n| 多人，明确“任一人审批即可” / “一人通过即可” | `1` | 或签；任一加签人完成审批即可 |\n| 多人，明确“所有人都要审批” / “全部确认” | `2` | 会签；所有加签人都必须完成审批 |\n| 多人，明确“依次审批” / “先 A 后 B” | `3` | 依次审批；每个人按 `add_sign_user_ids` 的数组顺序逐一审批 |\n| 多人，无法从上下文推断 | 不预设 | 询问用户选择或签、会签或依次审批，并说明三者效果 |\n\n依次审批必须保留用户给出的人员顺序。如果已经确定要依次审批，但上下文无法判断先后顺序，先询问人员顺序，再构造 `add_sign_user_ids`；不要自行排序。\n\n## 命令\n\n```bash\n# 先预览并加签请求，不实际执行\nlark-cli approval tasks add_sign \\\n --data '{\"instance_code\":\"\",\"task_id\":\"\",\"add_sign_type\":3,\"add_sign_user_ids\":[\"ou_xxx\"],\"comment\":\"请项目 owner 一起审核\"}' \\\n --params '{\"user_id_type\":\"open_id\"}' \\\n --as user \\\n --dry-run\n\n# 单人前加签：未指定方式时使用或签\nlark-cli approval tasks add_sign \\\n --data '{\"instance_code\":\"\",\"task_id\":\"\",\"add_sign_type\":1,\"add_sign_user_ids\":[\"ou_xxx\"],\"approval_method\":1,\"comment\":\"请先补充审核\"}' \\\n --params '{\"user_id_type\":\"open_id\"}' \\\n --as user \\\n --yes\n\n# 多人后加签：所有人都需要审批，使用会签\nlark-cli approval tasks add_sign \\\n --data '{\"instance_code\":\"\",\"task_id\":\"\",\"add_sign_type\":2,\"add_sign_user_ids\":[\"ou_xxx\",\"ou_yyy\"],\"approval_method\":2,\"comment\":\"当前审批完成后请两位都完成审核\"}' \\\n --params '{\"user_id_type\":\"open_id\"}' \\\n --as user \\\n --yes\n\n# 多人前加签：按数组中的人员顺序依次审批\nlark-cli approval tasks add_sign \\\n --data '{\"instance_code\":\"\",\"task_id\":\"\",\"add_sign_type\":1,\"add_sign_user_ids\":[\"ou_first\",\"ou_second\"],\"approval_method\":3,\"comment\":\"请先由第一位审核，再由第二位审核\"}' \\\n --params '{\"user_id_type\":\"open_id\"}' \\\n --as user \\\n --yes\n\n# 同一请求要求先加签、再转交：必须并加签；两条命令按顺序执行\nlark-cli approval tasks add_sign \\\n --data '{\"instance_code\":\"\",\"task_id\":\"\",\"add_sign_type\":3,\"add_sign_user_ids\":[\"ou_reviewer\"],\"comment\":\"请一起审核\"}' \\\n --params '{\"user_id_type\":\"open_id\"}' \\\n --as user \\\n --yes\n\n# 仅在上面的 add_sign 成功后，转交同一当前任务\nlark-cli approval tasks transfer \\\n --data '{\"instance_code\":\"\",\"task_id\":\"\",\"transfer_user_id\":\"ou_transferee\",\"comment\":\"出差期间请代为处理\"}' \\\n --params '{\"user_id_type\":\"open_id\"}' \\\n --as user \\\n --yes\n\n# 通过文件传入请求体，适合较长 comment 或较多加签人\nlark-cli approval tasks add_sign \\\n --data @./add-sign-body.json \\\n --params '{\"user_id_type\":\"open_id\"}' \\\n --as user \\\n --yes\n```\n\n## 参数\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `--data '{...}'` | 是 | 请求体 JSON，使用 JSON 传入 |\n| `instance_code` | 是 | 审批实例 Code；通常先通过 `tasks query` 或 `instances initiated` / `instances get` 获取 |\n| `task_id` | 是 | 审批任务 ID；通常先通过 `tasks query` 获取 |\n| `add_sign_type` | 是 | 加签类型：`1` 前加签、`2` 后加签、`3` 并加签 |\n| `add_sign_user_ids` | 是 | 被加签人 ID 数组；需要和 `user_id_type` 保持一致 |\n| `approval_method` | 否 | 审批方式：`1` 或签、`2` 会签、`3` 依次审批；**仅在前加签、后加签时需要填写**。单人未指定时使用 `1`；多人无法从语义推断时先询问用户 |\n| `comment` | 否 | 审批意见或加签说明，例如 `前加签给财务复核`、`请项目 owner 一并确认` |\n| `--params '{\"user_id_type\":\"...\"}'` | 否 | 查询参数 JSON；用于声明 `add_sign_user_ids` 内用户 ID 的类型 |\n| `user_id_type` | 否 | 用户 ID 类型：`user_id`、`union_id`、`open_id`；未显式指定时要特别确认被加签人的 ID 类型 |\n| `--as user` | 否 | 建议显式指定用户身份；审批加签通常必须以用户身份执行 |\n| `--yes` | 否 | 确认执行高风险写操作；未带时可能返回 `confirmation_required` / exit 10 |\n| `--format` | 否 | 输出格式：`json`（默认）、`ndjson`、`table`、`csv` |\n| `--dry-run` | 否 | 预览 API 调用，不执行 |\n\n## 枚举说明\n\n### add_sign_type\n\n| 值 | 含义 | 对当前任务的影响 |\n|----|------|------------------|\n| `1` | 前加签 | 在当前审批前插入审批人，可能推动当前用户的 task 流转 |\n| `2` | 后加签 | 在当前审批后追加审批人，可能推动当前用户的 task 流转 |\n| `3` | 并加签 | 增加并行审批人；需要随后转交当前环节时使用 |\n\n### approval_method\n\n仅适用于前加签、后加签；并加签不传。\n\n| 值 | 含义 | 完成条件 |\n|----|------|----------|\n| `1` | 或签 | 任一加签人完成审批即可 |\n| `2` | 会签 | 所有加签人都必须完成审批 |\n| `3` | 依次审批 | 所有加签人按 `add_sign_user_ids` 数组顺序逐一审批 |\n\n## 典型前置步骤\n\n先查到待办任务：\n\n```bash\nlark-cli approval tasks query --params '{\"topic\":\"1\"}' --as user\n```\n\n常用到的字段：\n\n| 字段 | 说明 |\n|------|------|\n| `tasks[].instance_code` | 审批实例 Code；执行 approve / reject / transfer / rollback / add_sign 等操作时通常都需要 |\n| `tasks[].task_id` | 审批任务 ID；与 `instance_code` 配对使用 |\n| `tasks[].support_api_operate` | 是否支持通过 API 处理该任务；加签前建议先检查 |\n\n如果你手里只有姓名或邮箱，建议先通过联系人能力解析出正确的用户 ID，再执行加签。\n\n如需先确认表单、节点、审批流进度，可继续查看实例详情：\n\n```bash\nlark-cli approval instances get --params '{\"instance_code\":\"\"}' --as user\n```\n\n## 使用建议\n\n- **`instance_code` 和 `task_id` 要成对使用**：仅有实例 ID 或仅有任务 ID 都不足以准确执行加签操作。\n- **`add_sign_user_ids` 与 `user_id_type` 必须匹配**：例如传 open_id 就把 `user_id_type` 设为 `open_id`；不要混用。\n- **优先显式传 `user_id_type`**：这样 agent 更容易判断参数含义，也能减少 ID 类型不匹配带来的失败。\n- **`add_sign_type` 要和业务意图一致**：前加签是在当前审批前插入审批人，后加签是在当前审批后追加审批人，并加签则是增加并行审批人。\n- **加签后还要转交当前环节时必须并加签**：使用 `add_sign_type: 3`，等待加签成功后再用同一组任务参数转交；不要用前加签或后加签导致当前 task 提前流转。\n- **无法推断类型时才询问**：如果用户没有说明先后或并行关系，且后续动作也不能帮助判断，再请用户选择；不要对“一起审”或“加签后转交”重复提问。\n- **前加签 / 后加签要补 `approval_method`**：单人未指定时使用或签；多人优先按语义选择，无法推断时询问用户，不要静默默认。\n- **依次审批保留人员顺序**：按用户指定的先后顺序构造 `add_sign_user_ids`；顺序不明确时先询问，不要自行排序。\n- **优先从 `tasks query` 的待办列表拿任务参数**：尤其是 `topic=1` 的待办审批，最适合作为 add_sign 的输入来源。\n- **先检查是否支持 API 操作**：如果 `tasks[].support_api_operate` 为 `false`，说明该任务可能不支持通过 API 执行处理动作，加签前应谨慎验证。\n- **`comment` 建议写明加签原因**：例如 `增加财务复核`、`增加项目 owner 并行确认`，方便相关人员理解上下文。\n- **先 `--dry-run` 再执行**：尤其在多人加签、跨部门加签或加签对象来源不明确时，先预览更安全。\n","skills/lark-approval/references/lark-approval-tasks-approve.md":"\n# approval tasks approve\n\n同意一个审批任务（用户级写操作）。通常先通过 `tasks query` 拿到 `task_id` 和 `instance_code`，必要时再用 `instances get` 查看详情，然后再执行同意。\n\n> [!CAUTION]\n> 这是 **high-risk-write** 写操作。建议先用 `--dry-run` 预览；真正执行时，如果用户已明确同意审批且目标任务无误，再带 `--yes` 运行。不要在未获用户明确同意时静默追加 `--yes`。\n\n需要的 scopes: [\"approval:task:write\"]\n\n## 命令\n\n```bash\n# 先预览请求，不实际执行\nlark-cli approval tasks approve \\\n --data '{\"instance_code\":\"\",\"task_id\":\"\",\"comment\":\"同意\"}' \\\n --as user \\\n --dry-run\n\n# 同意审批任务，并附带审批意见\nlark-cli approval tasks approve \\\n --data '{\"instance_code\":\"\",\"task_id\":\"\",\"comment\":\"同意\"}' \\\n --as user \\\n --yes\n\n# 需要回填表单时，传入 form（按当前命令定义，form 为字符串化 JSON）\nlark-cli approval tasks approve \\\n --data '{\"instance_code\":\"\",\"task_id\":\"\",\"comment\":\"同意并补充信息\",\"form\":\"[{\\\"id\\\":\\\"user_name\\\",\\\"type\\\":\\\"input\\\",\\\"value\\\":\\\"Alice\\\"}]\"}' \\\n --as user \\\n --yes\n\n# 通过文件传入请求体，适合较长 comment / form\nlark-cli approval tasks approve \\\n --data @./approve-body.json \\\n --as user \\\n --yes\n```\n\n## 参数\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `--data '{...}'` | 是 | 请求体 JSON，使用 JSON 传入 |\n| `instance_code` | 是 | 审批实例 Code；通常先通过 `tasks query` 或 `instances initiated` / `instances get` 获取 |\n| `task_id` | 是 | 审批任务 ID；通常先通过 `tasks query` 获取 |\n| `comment` | 否 | 审批意见，例如 `同意`、`已确认` |\n| `form` | 否 | 表单数据；按当前命令定义，字段类型为 `string`，通常传字符串化 JSON；仅在审批动作需要同时回填表单时使用 |\n| `--as user` | 否 | 建议显式指定用户身份；审批同意通常必须以用户身份执行 |\n| `--yes` | 否 | 确认执行高风险写操作；未带时可能返回 `confirmation_required` / exit 10 |\n| `--format` | 否 | 输出格式：`json`（默认）、`ndjson`、`table`、`csv` |\n| `--dry-run` | 否 | 预览 API 调用，不执行 |\n\n## 典型前置步骤\n\n先查到待办任务：\n\n```bash\nlark-cli approval tasks query --params '{\"topic\":\"1\"}' --as user\n```\n\n常用到的两个字段：\n\n| 字段 | 说明 |\n|------|------|\n| `tasks[].instance_code` | 审批实例 Code；执行 approve / reject / rollback 等操作时通常都需要 |\n| `tasks[].task_id` | 审批任务 ID；与 `instance_code` 配对使用 |\n\n如需先确认表单、节点、审批流进度，可继续查看实例详情：\n\n```bash\nlark-cli approval instances get --params '{\"instance_code\":\"\"}' --as user\n```\n\n## 使用建议\n\n- **`instance_code` 和 `task_id` 要成对使用**：仅有实例 ID 或仅有任务 ID 都不足以准确执行同意操作。\n- **优先从 `tasks query` 的待办列表拿参数**：尤其是 `topic=1` 的待办审批，最适合作为 approve 的输入来源。\n- **先检查是否支持 API 操作**：如果上一步 `tasks query` 返回的 `tasks[].support_api_operate` 为 `false`，说明该任务可能不支持通过 API 同意/拒绝。\n- **`comment` 建议简洁明确**：例如 `同意`、`同意，信息已核对`。没有审批意见要求时可省略。\n- **`form` 只在确有需要时传**：大多数简单同意场景只传 `instance_code`、`task_id`、可选 `comment` 即可。\n- **先 `--dry-run` 再执行**：尤其在批量处理、表单回填或任务来源不明确时，先预览更安全。\n","skills/lark-approval/references/lark-approval-tasks-query.md":"\n# approval tasks query\n\n查询当前用户的审批任务列表，可用于查看待办、已办、知会等分组。只读操作，不会修改审批状态。\n\n需要的 scopes: [\"approval:task:read\"]\n\n## 命令\n\n```bash\n# 查询待办审批\nlark-cli approval tasks query --params '{\"topic\":\"1\"}' --as user\n\n# 查询已办审批\nlark-cli approval tasks query --params '{\"topic\":\"2\"}' --as user\n\n# 按关键词搜索任务列表\nlark-cli approval tasks query --params '{\"topic\":\"1\",\"keyword\":\"测试\",\"page_size\":10}' --as user\n\n# 按任务时间范围筛选（秒级时间戳）\nlark-cli approval tasks query --params '{\"topic\":\"1\",\"start_timestamp\":\"\",\"end_timestamp\":\"\"}' --as user\n\n# 使用 page_token 翻页\nlark-cli approval tasks query --params '{\"topic\":\"1\",\"page_token\":\"example_page_token\"}' --as user\n\n# 表格格式输出，便于快速浏览\nlark-cli approval tasks query --params '{\"topic\":\"1\"}' --format table --as user\n```\n\n## 参数\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `--params '{\"topic\":\"...\"}'` | 是 | 查询参数，使用 JSON 传入 |\n| `topic` | 是 | 任务分组主题，见下方“topic 枚举” |\n| `definition_code` | 否 | 审批定义 Code，用于仅查询某个审批定义下的任务 |\n| `keyword` | 否 | 搜索关键词；非空时走搜索链路，空或仅空格时保持普通列表链路 |\n| `start_timestamp` | 否 | 按任务时间筛选，时间范围开始值，秒级时间戳 |\n| `end_timestamp` | 否 | 按任务时间筛选，时间范围结束值，秒级时间戳 |\n| `locale` | 否 | 返回语言：`zh-CN`、`en-US`、`ja-JP` |\n| `page_size` | 否 | 分页大小 |\n| `page_token` | 否 | 翻页标记；首次请求不填，后续使用上一次返回的 `page_token` |\n| `user_id_type` | 否 | 用户 ID 类型：`user_id`、`union_id`、`open_id` |\n| `--as user` | 否 | 建议显式指定用户身份；审批任务查询通常应使用用户身份 |\n| `--format` | 否 | 输出格式：`json`（默认）、`ndjson`、`table`、`csv` |\n| `--dry-run` | 否 | 预览 API 调用，不执行 |\n\n## topic 枚举\n\n| 值 | 含义 |\n|----|------|\n| `1` | 待办审批 |\n| `2` | 已办审批 |\n| `17` | 未读知会 |\n| `18` | 已读知会 |\n\n## 输出重点字段\n\n返回结果中常见字段：\n\n| 字段 | 说明 |\n|------|------|\n| `count` | 列表计数，只在第一页返回；当任务数大于等于 100 时返回 `99` |\n| `has_more` | 是否还有更多数据 |\n| `page_token` | 下一页翻页 Token |\n| `tasks[].task_id` | 任务 ID，全局唯一 |\n| `tasks[].instance_code` | 审批实例 Code；后续执行 approve / reject / rollback 等操作时通常需要与 `task_id` 成对使用 |\n| `tasks[].title` | 任务标题 |\n| `tasks[].status` | 任务状态：`1` 待办、`2` 已办、`17` 未读、`18` 已读、`33` 处理中、`34` 撤回 |\n| `tasks[].topic` | 任务所属分组主题 |\n| `tasks[].instance_status` | 审批实例状态：`0` 无状态、`1` 流转中、`2` 已通过、`3` 已拒绝、`4` 已撤销、`5` 已终止 |\n| `tasks[].definition_code` | 审批定义 Code |\n| `tasks[].definition_name` | 审批定义名称 |\n| `tasks[].initiator` | 发起人 ID |\n| `tasks[].initiator_name` | 发起人姓名 |\n| `tasks[].summaries` | 表单摘要字段列表 |\n| `tasks[].support_api_operate` | 是否支持通过 API 同意或拒绝该任务 |\n| `tasks[].user_id` | 任务所属用户 ID |\n| `tasks[].instance_external_id` | 三方审批实例 ID，仅第三方审批实例存在 |\n| `tasks[].task_external_id` | 三方审批任务 ID，仅第三方审批任务存在 |\n| `tasks[].link` | 三方审批跳转链接 |\n\n## 使用建议\n\n- 常见处理链：先用 `tasks query` 拿到 `task_id` 和 `instance_code`，若用户需要查看详情、当前节点、表单内容、流程进度等内容，则调用 `instances get` 查看详情，最后执行 `tasks approve` / `tasks reject` / `tasks transfer` / `tasks add_sign` / `tasks rollback`。\n- 如果你只想看“已发起的审批实例”，使用 `instances initiated`；`tasks query` 更适合围绕“任务分组”来拉取列表。\n- 需要搜索任务标题、摘要或相关内容时传入 `keyword`；搜索排序和普通列表排序不同，按搜索服务结果为准。\n- 按时间排查任务时使用 `start_timestamp` / `end_timestamp` 缩小范围；这两个值都是秒级时间戳。\n- 需要继续翻页时，直接把上一次返回的 `page_token` 放回 `--params`。\n- 当结果量较大时，优先使用 `--format table` 提升可读性。\n","skills/lark-approval/references/lark-approval-tasks-reject.md":"\n# approval tasks reject\n\n拒绝一个审批任务（用户级写操作）。通常先通过 `tasks query` 拿到 `task_id` 和 `instance_code`，必要时再用 `instances get` 查看详情，然后再执行拒绝。\n\n> [!CAUTION]\n> 这是 **high-risk-write** 写操作。建议先用 `--dry-run` 预览；真正执行时，如果用户已明确要拒绝该审批且目标任务无误，再带 `--yes` 运行。不要在未获用户明确同意时静默追加 `--yes`。\n\n需要的 scopes: [\"approval:task:write\"]\n\n## 命令\n\n```bash\n# 先预览请求，不实际执行\nlark-cli approval tasks reject \\\n --data '{\"instance_code\":\"\",\"task_id\":\"\",\"comment\":\"拒绝\"}' \\\n --as user \\\n --dry-run\n\n# 拒绝审批任务，并附带审批意见\nlark-cli approval tasks reject \\\n --data '{\"instance_code\":\"\",\"task_id\":\"\",\"comment\":\"拒绝，信息不完整\"}' \\\n --as user \\\n --yes\n\n# 通过文件传入请求体，适合较长 comment\nlark-cli approval tasks reject \\\n --data @./reject-body.json \\\n --as user \\\n --yes\n```\n\n## 参数\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `--data '{...}'` | 是 | 请求体 JSON，使用 JSON 传入 |\n| `instance_code` | 是 | 审批实例 Code；通常先通过 `tasks query` 或 `instances initiated` / `instances get` 获取 |\n| `task_id` | 是 | 审批任务 ID；通常先通过 `tasks query` 获取 |\n| `comment` | 否 | 审批意见，例如 `拒绝`、`拒绝，信息不完整` |\n| `--as user` | 否 | 建议显式指定用户身份；审批拒绝通常必须以用户身份执行 |\n| `--yes` | 否 | 确认执行高风险写操作；未带时可能返回 `confirmation_required` / exit 10 |\n| `--format` | 否 | 输出格式：`json`（默认）、`ndjson`、`table`、`csv` |\n| `--dry-run` | 否 | 预览 API 调用，不执行 |\n\n## 典型前置步骤\n\n先查到待办任务：\n\n```bash\nlark-cli approval tasks query --params '{\"topic\":\"1\"}' --as user\n```\n\n常用到的两个字段：\n\n| 字段 | 说明 |\n|------|------|\n| `tasks[].instance_code` | 审批实例 Code；执行 approve / reject / rollback 等操作时通常都需要 |\n| `tasks[].task_id` | 审批任务 ID；与 `instance_code` 配对使用 |\n\n如需先确认表单、节点、审批流进度，可继续查看实例详情：\n\n```bash\nlark-cli approval instances get --params '{\"instance_code\":\"\"}' --as user\n```\n\n## 使用建议\n\n- **`instance_code` 和 `task_id` 要成对使用**：仅有实例 ID 或仅有任务 ID 都不足以准确执行拒绝操作。\n- **优先从 `tasks query` 的待办列表拿参数**：尤其是 `topic=1` 的待办审批，最适合作为 reject 的输入来源。\n- **先检查是否支持 API 操作**：如果上一步 `tasks query` 返回的 `tasks[].support_api_operate` 为 `false`，说明该任务可能不支持通过 API 同意/拒绝。\n- **`comment` 建议写清拒绝原因**：例如 `拒绝，缺少合同附件`、`拒绝，预算字段填写不完整`。这有助于发起人理解原因并补充材料。\n- **先 `--dry-run` 再执行**：尤其在批量处理或任务来源不明确时，先预览更安全。\n","skills/lark-approval/references/lark-approval-tasks-remind.md":"\n# approval tasks remind\n\n对审批实例中的指定任务发起催办（用户级写操作）。通常先通过 `tasks query` 找到待办任务，拿到 `instance_code` 和要催办的 `task_ids`，必要时再用 `instances get` 查看详情，然后执行催办。\n\n> [!CAUTION]\n> 这是 **high-risk-write** 写操作。建议先用 `--dry-run` 预览；真正执行时，如果用户已明确要催办该审批且目标实例、目标任务都无误，再带 `--yes` 运行。不要在未获用户明确同意时静默追加 `--yes`。\n\n需要的 scopes: [\"approval:instance:write\"]\n\n## 命令\n\n```bash\n# 先预览请求，不实际执行\nlark-cli approval tasks remind \\\n --data '{\"instance_code\":\"\",\"task_ids\":[\"\"],\"comment\":\"请尽快处理\"}' \\\n --as user \\\n --dry-run\n\n# 催办单个审批任务\nlark-cli approval tasks remind \\\n --data '{\"instance_code\":\"\",\"task_ids\":[\"\"],\"comment\":\"请尽快审批该单据\"}' \\\n --as user \\\n --yes\n\n# 同一实例下催办多个任务\nlark-cli approval tasks remind \\\n --data '{\"instance_code\":\"\",\"task_ids\":[\"\",\"\"],\"comment\":\"请相关审批人尽快处理\"}' \\\n --as user \\\n --yes\n\n# 通过文件传入请求体，适合较长 comment 或多个 task_ids\nlark-cli approval tasks remind \\\n --data @./remind-body.json \\\n --as user \\\n --yes\n```\n\n## 参数\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `--data '{...}'` | 是 | 请求体 JSON，使用 JSON 传入 |\n| `instance_code` | 是 | 审批实例 Code；通常先通过 `tasks query` 或 `instances get` 获取 |\n| `task_ids` | 是 | 被催办的任务 ID 数组；应与 `instance_code` 属于同一审批实例 |\n| `comment` | 否 | 催办说明，例如 `请尽快处理`、`该单据较急，请优先审批` |\n| `--as user` | 否 | 建议显式指定用户身份；审批催办通常必须以用户身份执行 |\n| `--yes` | 否 | 确认执行高风险写操作；未带时可能返回 `confirmation_required` / exit 10 |\n| `--format` | 否 | 输出格式：`json`（默认）、`ndjson`、`table`、`csv` |\n| `--dry-run` | 否 | 预览 API 调用，不执行 |\n\n## 典型前置步骤\n\n先查到待办任务：\n\n```bash\nlark-cli approval tasks query --params '{\"topic\":\"1\"}' --as user\n```\n\n常用到的字段：\n\n| 字段 | 说明 |\n|------|------|\n| `tasks[].instance_code` | 审批实例 Code；催办时必须提供 |\n| `tasks[].task_id` | 审批任务 ID；放入 `task_ids` 数组中 |\n| `tasks[].title` | 任务标题，可用于确认催办对象是否正确 |\n| `tasks[].status` | 任务状态；一般优先催办仍处于待处理状态的任务 |\n\n如需进一步确认当前审批流、节点和人员信息，可继续查看实例详情：\n\n```bash\nlark-cli approval instances get --params '{\"instance_code\":\"\"}' --as user\n```\n\n## 使用建议\n\n- **`instance_code` 和 `task_ids` 要对应同一个审批实例**：不要把不同实例下的任务 ID 混在同一次催办请求中。\n- **`task_ids` 是数组**：即使只催办一个任务，也要按数组形式传入。\n- **优先从 `tasks query` 的待办列表拿参数**：尤其是 `topic=1` 的待办审批，最适合作为 remind 的输入来源。\n- **催办前先确认任务仍需处理**：已经审批完成、已撤回或已终止的任务一般不适合继续催办。\n- **`comment` 建议简洁且明确**：例如 `该单据较急，请优先审批`、`请今天内处理`。避免过长或模糊描述。\n- **先 `--dry-run` 再执行**：尤其在一次催办多个任务、任务来源不明确或需让用户复核催办对象时，先预览更安全。\n","skills/lark-approval/references/lark-approval-tasks-rollback.md":"\n# approval tasks rollback\n\n将一个审批任务退回到指定节点（用户级写操作）。通常先通过 `tasks query` 拿到 `task_id` 和 `instance_code`，再结合实例详情确认可退回的目标节点 `node_ids`，最后执行退回。\n\n> [!CAUTION]\n> 这是 **high-risk-write** 写操作。建议先用 `--dry-run` 预览；真正执行时，如果用户已明确要退回该审批且目标任务、退回节点都无误，再带 `--yes` 运行。不要在未获用户明确同意时静默追加 `--yes`。\n\n需要的 scopes: [\"approval:task:write\"]\n\n## 命令\n\n```bash\n# 先预览请求，不实际执行\nlark-cli approval tasks rollback \\\n --data '{\"instance_code\":\"\",\"task_id\":\"\",\"node_ids\":[\"\"],\"comment\":\"退回补充材料\"}' \\\n --as user \\\n --dry-run\n\n# 退回到单个节点\nlark-cli approval tasks rollback \\\n --data '{\"instance_code\":\"\",\"task_id\":\"\",\"node_ids\":[\"\"],\"comment\":\"请补充附件后重新提交\"}' \\\n --as user \\\n --yes\n\n# 退回到发起节点（发起节点 ID 为 START）\nlark-cli approval tasks rollback \\\n --data '{\"instance_code\":\"\",\"task_id\":\"\",\"node_ids\":[\"START\"],\"comment\":\"退回发起人补充材料\"}' \\\n --as user \\\n --yes\n\n# 传多个候选节点 ID（以实际审批定义支持情况为准）\nlark-cli approval tasks rollback \\\n --data '{\"instance_code\":\"\",\"task_id\":\"\",\"node_ids\":[\"\",\"\"],\"comment\":\"退回上一处理节点\"}' \\\n --as user \\\n --yes\n\n# 通过文件传入请求体，适合较长 comment 或较多 node_ids\nlark-cli approval tasks rollback \\\n --data @./rollback-body.json \\\n --as user \\\n --yes\n```\n\n## 参数\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `--data '{...}'` | 是 | 请求体 JSON，使用 JSON 传入 |\n| `instance_code` | 是 | 审批实例 Code；通常先通过 `tasks query` 或 `instances initiated` / `instances get` 获取 |\n| `task_id` | 是 | 审批任务 ID；通常先通过 `tasks query` 获取 |\n| `node_ids` | 是 | 退回目标节点 ID 数组；发起节点 ID 为 `START`；执行前应先确认这些节点确实可作为退回目标 |\n| `comment` | 否 | 审批意见或退回说明，例如 `请补充附件后重新提交`、`预算说明不完整，请补充` |\n| `--as user` | 否 | 建议显式指定用户身份；审批退回通常必须以用户身份执行 |\n| `--yes` | 否 | 确认执行高风险写操作；未带时可能返回 `confirmation_required` / exit 10 |\n| `--format` | 否 | 输出格式：`json`（默认）、`ndjson`、`table`、`csv` |\n| `--dry-run` | 否 | 预览 API 调用，不执行 |\n\n## 典型前置步骤\n\n先查到待办任务：\n\n```bash\nlark-cli approval tasks query --params '{\"topic\":\"1\"}' --as user\n```\n\n常用到的字段：\n\n| 字段 | 说明 |\n|------|------|\n| `tasks[].instance_code` | 审批实例 Code；执行 approve / reject / transfer / rollback 等操作时通常都需要 |\n| `tasks[].task_id` | 审批任务 ID；与 `instance_code` 配对使用 |\n| `tasks[].support_api_operate` | 是否支持通过 API 处理该任务；退回前建议先检查 |\n\n如需确认流程节点、当前进度和可退回位置，可先查看实例详情：\n\n```bash\nlark-cli approval instances get --params '{\"instance_code\":\"\"}' --as user\n```\n\n## 使用建议\n\n- **`instance_code` 和 `task_id` 要成对使用**：仅有实例 ID 或仅有任务 ID 都不足以准确执行退回操作。\n- **`node_ids` 是必填项**：退回并不是“自动退回上一步”，而是要明确给出目标节点 ID 数组；退回发起节点时传 `START`。\n- **先确认节点是否可退回**：不同审批定义支持的退回目标可能不同；在不确定时，先通过 `instances get` 或业务侧流程信息核实。\n- **优先从 `tasks query` 的待办列表拿任务参数**：尤其是 `topic=1` 的待办审批，最适合作为 rollback 的输入来源。\n- **先检查是否支持 API 操作**：如果 `tasks[].support_api_operate` 为 `false`，说明该任务可能不支持通过 API 执行处理动作，退回前应谨慎验证。\n- **`comment` 建议写清退回原因**：例如 `附件缺失，请补齐后重新提交`、`费用说明不完整，请补充明细`，方便发起人或上一步处理人理解原因。\n- **先 `--dry-run` 再执行**：尤其在节点来源不明确、审批链路复杂或批量处理时，先预览更安全。\n","skills/lark-approval/references/lark-approval-tasks-transfer.md":"\n# approval tasks transfer\n\n转交一个审批任务给其他用户处理（用户级写操作）。通常先通过 `tasks query` 拿到 `task_id` 和 `instance_code`，确认目标任务后，再提供被转交人的用户 ID 执行转交。\n\n> [!CAUTION]\n> 这是 **high-risk-write** 写操作。建议先用 `--dry-run` 预览；真正执行时，如果用户已明确要转交该审批且目标任务、转交对象都无误，再带 `--yes` 运行。不要在未获用户明确同意时静默追加 `--yes`。\n\n需要的 scopes: [\"approval:task:write\"]\n\n## 命令\n\n```bash\n# 先预览请求，不实际执行\nlark-cli approval tasks transfer \\\n --data '{\"instance_code\":\"\",\"task_id\":\"\",\"transfer_user_id\":\"ou_xxx\",\"comment\":\"请你继续处理\"}' \\\n --params '{\"user_id_type\":\"open_id\"}' \\\n --as user \\\n --dry-run\n\n# 按 open_id 转交审批任务\nlark-cli approval tasks transfer \\\n --data '{\"instance_code\":\"\",\"task_id\":\"\",\"transfer_user_id\":\"ou_xxx\",\"comment\":\"转交给你处理\"}' \\\n --params '{\"user_id_type\":\"open_id\"}' \\\n --as user \\\n --yes\n\n# 按 user_id 转交审批任务\nlark-cli approval tasks transfer \\\n --data '{\"instance_code\":\"\",\"task_id\":\"\",\"transfer_user_id\":\"123456789\",\"comment\":\"请补充审核\"}' \\\n --params '{\"user_id_type\":\"user_id\"}' \\\n --as user \\\n --yes\n\n# 通过文件传入请求体，适合较长 comment\nlark-cli approval tasks transfer \\\n --data @./transfer-body.json \\\n --params '{\"user_id_type\":\"open_id\"}' \\\n --as user \\\n --yes\n```\n\n## 参数\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `--data '{...}'` | 是 | 请求体 JSON，使用 JSON 传入 |\n| `instance_code` | 是 | 审批实例 Code；通常先通过 `tasks query` 或 `instances initiated` / `instances get` 获取 |\n| `task_id` | 是 | 审批任务 ID；通常先通过 `tasks query` 获取 |\n| `transfer_user_id` | 是 | 被转交人的用户 ID；需要和 `user_id_type` 保持一致 |\n| `comment` | 否 | 审批意见或转交说明，例如 `转交给你处理`、`请继续审核该单据` |\n| `--params '{\"user_id_type\":\"...\"}'` | 否 | 查询参数 JSON；用于声明 `transfer_user_id` 的 ID 类型 |\n| `user_id_type` | 否 | 用户 ID 类型：`user_id`、`union_id`、`open_id`；未显式指定时要特别确认 `transfer_user_id` 的真实类型 |\n| `--as user` | 否 | 建议显式指定用户身份；审批转交通常必须以用户身份执行 |\n| `--yes` | 否 | 确认执行高风险写操作；未带时可能返回 `confirmation_required` / exit 10 |\n| `--format` | 否 | 输出格式：`json`（默认）、`ndjson`、`table`、`csv` |\n| `--dry-run` | 否 | 预览 API 调用，不执行 |\n\n## 典型前置步骤\n\n先查到待办任务：\n\n```bash\nlark-cli approval tasks query --params '{\"topic\":\"1\"}' --as user\n```\n\n常用到的字段：\n\n| 字段 | 说明 |\n|------|------|\n| `tasks[].instance_code` | 审批实例 Code；执行 approve / reject / transfer / rollback 等操作时通常都需要 |\n| `tasks[].task_id` | 审批任务 ID；与 `instance_code` 配对使用 |\n| `tasks[].support_api_operate` | 是否支持通过 API 处理该任务；转交前建议先检查 |\n\n如果你手里只有姓名或邮箱，建议先通过联系人能力解析出正确的用户 ID，再执行转交。\n\n如需先确认表单、节点、审批流进度，可继续查看实例详情：\n\n```bash\nlark-cli approval instances get --params '{\"instance_code\":\"\"}' --as user\n```\n\n## 使用建议\n\n- **`instance_code` 和 `task_id` 要成对使用**：仅有实例 ID 或仅有任务 ID 都不足以准确执行转交操作。\n- **`transfer_user_id` 与 `user_id_type` 必须匹配**：例如传 open_id 就把 `user_id_type` 设为 `open_id`；不要混用。\n- **优先显式传 `user_id_type`**：这样 agent 更容易判断参数含义，也能减少 ID 类型不匹配带来的失败。\n- **优先从 `tasks query` 的待办列表拿任务参数**：尤其是 `topic=1` 的待办审批，最适合作为 transfer 的输入来源。\n- **先检查是否支持 API 操作**：如果 `tasks[].support_api_operate` 为 `false`，说明该任务可能不支持通过 API 执行同意/拒绝等处理动作，转交前也应谨慎验证。\n- **`comment` 建议写明转交原因**：例如 `你更熟悉该项目，请继续处理`、`转交给预算 owner 审核`，方便接收人理解上下文。\n- **先 `--dry-run` 再执行**：尤其在跨部门转交、批量处理或转交对象来源不明确时，先预览更安全。\n","skills/lark-apps/SKILL.md":"","skills/lark-apps/creative-design/agents/fork-verifier-agent.md":"","skills/lark-apps/creative-design/agents/vision-probe-agent.md":"","skills/lark-apps/creative-design/creative-design.md":"---\nname: creative-design\ndescription: 以自包含 HTML 创建精致的设计产物：UI mockup、可交互原型、线框图（wireframe）、落地页、仪表盘、应用屏幕、移动 App、幻灯片 deck（即 PPT / PowerPoint 演示文稿）、动画视频（motion graphics、产品演示 Demo 动画、数据动画）、可视化报告 / 信息图（infographic）/ 视觉长图与视觉探索。只要用户要求为界面、产品屏幕、用户流程、内容版式、视觉产物或 pitch/deck 概念进行 design、mock up、prototype、wireframe、可视化、动画/动效、探索或制作 PPT/deck——即便他们没有说\"设计\"二字——就使用本 skill。Harness 无关：适用于 Aily、Claude Code、Codex Agent 及类似的具备文件能力的 agent。\n---\n\n## 目录结构与运行环境\n本 skill 附带以下资源，路径均相对于本文件所在目录：\n\n- `references/.md` — 媒介专属技能 prompt（如 `frontend-design.md`、`hi-fi-design.md`、`charts.md` 等；见文末「Skills 元信息」的完整列表）。与下方 harness 工具映射表同在 `references/` 目录。\n- `starter-components/` — 现成的 HTML/JS/JSX 脚手架（`design-canvas.jsx`、`deck-stage.js`、`ios-frame.jsx`、`android-frame.jsx`、`tweaks-panel.jsx`、`macos-window.jsx`、`browser-window.jsx`、`animations.jsx`）。见下文「Starter Components」。\n- `references/.md` — **harness 专属工具映射表**（`claude.md`、`codex.md`、`aily.md`）。本文行文使用的是 harness 无关的 web 工具名——`ask_user_question`、`copy_starter_component`、`invoke_skill(\"X\")`、`generate_image`、`search_images`、展示文件等——**动手前先读取与你当前运行环境对应的 `references/.md`，把这些名字映射成你 harness 里的真实工具**。例如在 Claude Code 里 `ask_user_question` → `AskUserQuestion`、`copy_starter_component` → `Bash cp <本 skill 所在目录>/starter-components/ .`、`invoke_skill(\"X\")` → `Read references/.md`。\n- `assets/index.html` — React + Babel 的 HTML 起步模板（锁定版本 script 标签 + `#root` 挂载点），见下文「React + Babel」。\n\n## 工作流\n1. 理解用户需求。对全新或含糊的工作，提出澄清性问题。弄清输出物、精细度（fidelity）、选项数量、约束条件，以及涉及的 UI kit 与品牌。\n2. 探索所提供的资源。附件、文档链接、网页 URL 都要在动手前解析完（见「输入资料解析」）。\n3. 列出 todo 清单。\n4. 为本次任务创建独立的任务目录——多个任务会在同一个根目录下执行，直接写根目录会互相覆盖、文件串台；每个任务目录是一个**独立的妙搭应用仓库**——新任务先用 `+create` 建应用、再 `+init --app-id --dir <任务目录>` 初始化仓库（会自动 clone 并切到 `sprint/default`，命令见「发布」前提），独立发布互不影响。把资源复制进任务目录，在其中创建交付物。用图片素材提升美观度与丰富度、或需要有依据的内容时，按「图像素材与外部信息」补充。\n5. （如有）自检React + Babel路径是否正确；ReactDOM.createRoot 是否参数正确，对应元素是否存在\n6. 收尾：提交你的改动。\n7. 发布：把产物发布到妙搭拿到可访问链接（见下方「发布」）。写完不发布，用户拿不到线上链接。\n8. 极其简短地总结——只讲注意事项与后续步骤，并给出发布后的可访问链接。\n\n鼓励你并发调用文件探索工具以提升效率。\n\n## 提问\n默认基于用户给的信息、项目上下文和合理假设直接开始，不为收集偏好而打断。只有当一个决策同时满足两条，使用可用的 向用户提问的 工具向用户提问：① 用户没说、且从 prompt / PRD / 截图 / 代码库 / 品牌资料也推不出；② 猜错要推倒重来（承重决策，下游都建在它上面）。两条只要有一条不成立——能合理推断，或猜错只是局部返工——就直接做。\n\n承重、推不出就必须先问的：交付媒介 / 格式（报告 vs deck vs 看板）；视觉 / 美学方向（从零起的项目、且资料里推不出一个有把握不返工的方向时）；大体量交付（整套 deck、多页产物）的受众 / 目的与核心范围。\n局部、给默认直接做的：变体数量与探索维度、界面文案、占位与示例内容、单屏 / 单组件的处理与密度——给合理默认（变体默认摆 2-3 个有清晰差异的方案），让用户在产出上重定向，不为它们提问。\n\n例如：\n\n- \"做一份关于 X 的报告／材料\"但没说格式 → 媒介推不出且承重，先确认交付格式（幻灯片 vs. 视觉报告 vs. 仪表盘），再问格式相关的问题。\n- 为附带的 PRD 做一套 deck → PRD 能推出受众 / 场景就直接做；只有受众、篇幅推不出且影响全局时才问。\n- 用这份 PRD 为 Eng All Hands 做一套 10 分钟的 deck → 无需提问；信息已足够。\n- 把这张截图变成交互原型 → 只有当图片无法说明预期行为时才提问。\n- 做 6 页关于黄油历史的幻灯片 → 媒介、页数已定，直接开工；风格能从主题推断就定，推不出再问。\n- 为我的外卖 app 的 onboarding 做一套原型 → 按常见 onboarding 流程直接做；只问会阻塞产出的承重问题。\n\n当交付格式本身不明确时——用户只说了一个成果（\"一份报告\"\"材料\"\"一份摘要\"）却没说媒介——先解决格式，再讨论任何与格式相关的细节。\n\n问出好问题至关重要。技巧：\n\n- 通常一轮聚焦提问就够；把承重的未知一次问齐，不要挤牙膏式多轮打断。\n- 只问推不出的；能从 PRD、截图、代码库、品牌资产、现有页面和用户原话推断的，先推断，并在产出里说明你的假设。\n\n## 输入资料解析\n用户给的附件、文档链接和 URL 是设计的输入，必须在动手前解析完——数据看板、报告和基于文档的 deck 全都建立在源资料之上，跳过这一步产出的内容只能靠编造。按输入形态处理：\n\n- **数据文件（csv / json / xlsx）**——先看结构（列名、字段类型、行数）和样本行，再决定信息层级与图表选型；指标一律用脚本从源数据计算，不要目测。\n- **压缩包（zip）**——先解压到临时目录，逐个查看内容物，再按各自类型处理。\n- **文档（docx / pdf / 论文 / 需求文档）**——用当前 harness 的文档解析能力读取**全文**（映射见 `references/.md`；Aily 原生支持解析 Word / PDF 等二进制文件），不要只读开头就动手。\n- **飞书云文档 / 多维表格链接**——用 `lark-cli` 读取内容（云文档 / 多维表格相关命令，不确定用法先查 `--help`）；`lark-cli` 不可用时向用户说明并请其导出或粘贴，不要凭标题猜内容。\n- **网页 URL**——用 `web_fetch` 抓取全文后再产出；抓取失败就告知用户，不要凭 URL 和常识编写。\n\n## 如何开展设计工作\n动手前先读取 **`./references/frontend-design.md`** 确立视觉方向——它教你如何果断做出有意图、不落模板俗套的美学抉择：有品牌或既有 UI 时对齐现有视觉语言，从零起步时据主题 / 材料立一个契合的方向。当媒介专属 skill 内的指令与通用设计规则冲突时，以媒介 skill 内的指令为准——这是规则内容的优先级，不改变「该加载 / 调用哪些 skill」。\n\n当用户请你做高保真 UI mockup、界面设计或带多方案的视觉探索时，开始之前先读取 **`./references/hi-fi-design.md`**——它涵盖了设计流程、获取设计上下文、提问以及呈现多个方案。\n\n一次设计探索的输出是单个 HTML 文档。根据你所探索的内容选择呈现格式：\n\n- **静态视觉 / 设计稿 / 多方案探索**（颜色、字体、单个元素、整屏 UI、流程关键帧）→ 通过 `starter-components/design-canvas.jsx` starter component 把各方案铺陈在画布上。除非用户明确要求可点击 / 可交互，否则不要把设计稿升级成点击原型。\n- **用户明确要求可交互的流程或产品 demo** → 将整个产品做成高保真可点击原型，并把关键选项以 Tweak 形式暴露出来。可交互原型禁止使用 `starter-components/design-canvas.jsx`、`` 或画布外壳包裹；它应该作为真实应用界面直接运行。\n\n这两者可以组合，但只限静态设计探索。已经做好的**可交互原型**如果用户接着想探索多个方向，用页内开关、路由、Tabs、Tweak 或模式切换承载变体；不要把交互原型放进 design-canvas 画布，也不要用 `` 并排包裹。\n\n当用户要求新版本或改动时，把它们作为 TWEAKS 加到原件上；拥有一个可切换不同版本开关的主文件，优于拥有多个文件。\n\n## 默认美学指令\n如果用户没给参考或艺术方向：能从主题、材料或场景推断出一个有把握、不会返工的视觉方向，就主动确定，并在设计中体现假设；如果推不出、又是从零起的项目，先用 `ask_user_question` 问清偏好的调性、受众、颜色、字体、情绪等再动手——不要在推不出方向时硬选，slop 就是这么来的。\n\n定下视觉方向后（无论是推断还是问来的），创建设计时遵循以下指引：\n\n- **字体与排版。** 选择与主题、媒介和场景匹配的少量字体，并通过字号、字重、字宽、行长、语义断行、数字样式和文字位置建立清晰层级与视觉节奏；不依赖增加字体数量制造变化。\n- **背景与色彩体系。** 确定主色调，并建立与主题协调的中性基底、主题色和必要的章节／语义色。背景不局限于纯黑、纯白或单一色调，可以根据内容属性、页面角色和叙事节点使用不同色调、主题色底、局部色域、图片或图形背景。\n- **色彩一致性。** 一致性来自共享色板、字体、栅格、图形语言和明确的颜色关系，不要求所有页面使用相同背景。颜色变化应帮助识别章节、信息层级和重点，避免无语义地逐页随机换色。\n- **强调色。** 使用数量克制、关系协调的强调色，并根据背景、信息层级和色彩语义调整明度与彩度。图表、状态和章节色需要清楚可区分，但应属于同一视觉体系。\n- **中性色。** 黑、白、灰可以带有与主题协调的细微色相，避免把纯黑白或低饱和配色作为所有专业场景的默认答案。\n- **视觉复杂度。** 视觉丰富度应服务内容。不要添加无信息价值的装饰，也不要把\"克制\"理解为单调、大量留白、缺少图片图表或所有页面使用同一种构图。\n\n关键：如果已给出其他美学指令（如参考图、品牌体系、设计规范或媒介专属 skill），或项目中已有文件，则完全忽略默认美学。\n\n## 图像素材与外部信息\n图片素材能显著提升产物的美观度与丰富度——不要默认只用纯 CSS/SVG 撑起全部视觉。为氛围、质感和视觉节奏而配图是正当用途，不需要等到\"内容必须有图\"才配图。选择工具的判断规则很简单：**需要真实图片就搜索，需要丰富美观的图片就生成**。当前 harness 若提供以下能力（映射见 `references/.md`；没有对应工具就跳过，用内联 SVG / CSS 图形兜底），在合适的位置主动使用：\n\n- **`generate_image`（AI 图片生成）**——美化、氛围类配图一律走生成：hero 图、插画、照片质感背景、章节题图、空状态插图、信息图（infographic）、产品/场景示意图等任何能让页面更好看的位置，用文生图直接生成；有品牌参考图或用户素材时用图生图对齐既有视觉语言；多屏 / 多页需要风格统一、角色连贯的插画体系时用组图一次生成整个序列；对已有图片做局部调整用图片编辑。生成 prompt 里写清风格、构图、配色与光线，让产出与已确立的视觉方向一致，而不是各自为政。\n- **`search_images`（图片搜索）**——需要真实图片时走搜索：真实存在的实物、产品、地点、人物、logo、截图等生成会失真或造假的素材，以及确立视觉方向时按关键词找参考图（同类产品界面、风格 moodboard）。直接引用搜索结果时注意来源与版权。\n- **`web_search` / `web_fetch`（联网搜索）**——内容需要真实事实、数据、案例或时效性信息时先搜再写，不要编造（见「内容准则」：涉及新增事实、数据时要有依据）。调研型产出（行业研究、政策梳理、竞争格局类 deck / 报告）要先做多轮搜索，把事实、数字与来源收集齐并标注出处，再进入设计。\n- **视频素材**——需要嵌入公开视频（培训短片、案例视频等）时，用联网搜索找到可公开访问的视频页面或可嵌入链接，以 `