Skip to content

docs(vc): default transcript routing to smart notes over minutes - #1961

Merged
calendar-assistant merged 1 commit into
mainfrom
docs/vc-minutes-transcript-routing
Jul 20, 2026
Merged

docs(vc): default transcript routing to smart notes over minutes#1961
calendar-assistant merged 1 commit into
mainfrom
docs/vc-minutes-transcript-routing

Conversation

@calendar-assistant

@calendar-assistant calendar-assistant commented Jul 20, 2026

Copy link
Copy Markdown
Collaborator

Summary

Agents processing meeting content tend to route to Minutes (妙记) artifacts even when the user only wants a transcript, then hit the Minutes authorization wall. The root cause is skill wording: "smart notes vs minutes" priority was only defined for summary/todo, and transcript was listed as an equal note OR minutes choice. This PR encodes the correct default in the lark-vc skill docs.

Changes

  • skills/lark-vc/SKILL.md: note the access-permission asymmetry in the Minutes concept (smart notes + verbatim docs are auto-authorized to participants; minutes carry the raw recording and require explicit authorization). In the artifact-selection table, drop the flat or minutes default and add a selection rule.
  • skills/lark-vc/references/vc-domain-boundaries.md: add an "authorization" note to each of the two artifact pipelines, and rewrite the pipeline-priority rule so it covers transcripts, not just summary/todo.
  • Selection rule (applies to summary/todo/transcript alike): if only one artifact type exists, use it; if both exist and the user specifies one, follow that choice without rerouting; if both exist and the user is unspecified, default to smart notes and their verbatim doc (auto-authorized, lower access barrier).

Test Plan

  • go test ./internal/qualitygate/skillscan/... passes
  • gofmt -l . produces no output (docs-only change, no Go code touched)

Related Issues

  • None

Summary by CodeRabbit

  • Documentation
    • Clarified post-meeting access rules: AI summaries (including linked transcripts and shared screen materials) are automatically available to attendees, while original recordings/minutes are not automatically authorized and may require approval or a request.
    • Updated artifact-selection guidance to match availability and explicit user intent, including defined defaults for reviewing summaries/transcripts and related content.
    • Added clearer “智能纪要 vs 妙记” selection rules for consistent outcomes when users specify “看妙记…”.

@github-actions github-actions Bot added domain/vc PR touches the vc domain size/M Single-domain feat or fix with limited business impact labels Jul 20, 2026
@coderabbitai

coderabbitai Bot commented Jul 20, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: c76e4d12-fb1d-479a-8373-87da02aa8972

📥 Commits

Reviewing files that changed from the base of the PR and between fe9a17e and 8ecdd37.

📒 Files selected for processing (2)
  • skills/lark-vc/SKILL.md
  • skills/lark-vc/references/vc-domain-boundaries.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • skills/lark-vc/references/vc-domain-boundaries.md

📝 Walkthrough

Walkthrough

Updates VC documentation to clarify post-meeting authorization for AI summaries and Minutes, and formalizes artifact-selection defaults based on availability and explicit user requests.

Changes

VC artifact guidance

Layer / File(s) Summary
Post-meeting authorization rules
skills/lark-vc/SKILL.md, skills/lark-vc/references/vc-domain-boundaries.md
Documents automatic attendee authorization for AI summaries and restricted access for Minutes artifacts containing original recordings.
Artifact selection defaults
skills/lark-vc/SKILL.md, skills/lark-vc/references/vc-domain-boundaries.md
Defines routing for single available artifacts, explicit product requests, and unspecified requests when both AI summaries and Minutes exist.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

  • larksuite/cli#591: Updates overlapping Minutes versus AI-notes routing semantics.
  • larksuite/cli#732: Documents Minutes-derived transcript routing aligned with these selection rules.
  • larksuite/cli#1269: Updates related VC artifact selection and permission guidance.

Suggested labels: documentation

Suggested reviewers: zhaoleibd

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the main change: routing transcript requests to smart notes instead of Minutes.
Description check ✅ Passed The description matches the required template with Summary, Changes, Test Plan, and Related Issues sections filled in.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/vc-minutes-transcript-routing

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@skills/lark-vc/references/vc-domain-boundaries.md`:
- Around line 61-65: Update the “智能纪要 vs 妙记的选择规则” section to distinguish the
source used for independent “总结/提炼” operations from AI-summary output: when the
user requests an independently generated summary, derive it from the selected
transcript rather than reusing 智能纪要’s existing summary. Preserve the existing
explicit-user-selection and default source rules for transcript and other
repeated-artefact requests.

In `@skills/lark-vc/SKILL.md`:
- Line 59: Replace the universal “original meeting recording video” wording in
the Minutes authorization description with content-neutral raw audio/video
wording, while preserving the existing authorization rules. Apply the same
qualification in skills/lark-vc/SKILL.md lines 59-59 and
skills/lark-vc/references/vc-domain-boundaries.md lines 48-49.
- Around line 74-77: Make the “智能纪要 vs 妙记的选择规则” and “逐字稿路由” blockquote
contiguous by removing the blank lines between quoted paragraphs or prefixing
those continuation lines with “>”, while preserving the existing text and
Markdown structure.
- Around line 68-74: The artifact-selection rules must be operation-specific: in
skills/lark-vc/SKILL.md lines 68-74, preserve and explicitly prioritize the
transcript-only independent-analysis rule for 提炼/总结/重新总结/整理会议内容/回顾会议, while
keeping AI artifacts for direct AI-summary, todo, and chapter requests; in
skills/lark-vc/references/vc-domain-boundaries.md lines 61-65, clarify that the
generic default of 智能纪要及其逐字稿 does not authorize reusing the AI summary for
independent summarization.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 8fad0d2b-622e-4937-9a0b-ac4249c2bfed

📥 Commits

Reviewing files that changed from the base of the PR and between 7b98994 and fe9a17e.

📒 Files selected for processing (2)
  • skills/lark-vc/SKILL.md
  • skills/lark-vc/references/vc-domain-boundaries.md

Comment thread skills/lark-vc/references/vc-domain-boundaries.md
Comment thread skills/lark-vc/SKILL.md
Comment thread skills/lark-vc/SKILL.md
Comment thread skills/lark-vc/SKILL.md
@github-actions

github-actions Bot commented Jul 20, 2026

Copy link
Copy Markdown

🚀 PR Preview Install Guide

🧰 CLI update

npm i -g https://pkg.pr.new/larksuite/cli/@larksuite/cli@8ecdd374c7626750977a1d55a9ac85ead953e457

🧩 Skill update

npx skills add larksuite/cli#docs/vc-minutes-transcript-routing -y -g

@codecov

codecov Bot commented Jul 20, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 74.98%. Comparing base (6ff1022) to head (8ecdd37).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #1961   +/-   ##
=======================================
  Coverage   74.98%   74.98%           
=======================================
  Files         895      895           
  Lines       94379    94379           
=======================================
  Hits        70767    70767           
  Misses      18197    18197           
  Partials     5415     5415           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Clarify that smart notes (AI summary) and their verbatim docs are
auto-authorized to participants, while minutes carry the raw recording
and require explicit authorization. Rewrite the artifact-selection rule
to cover transcripts: use whichever exists when only one is present,
follow the user's explicit choice, and default to smart notes when both
exist and the user is unspecified.
@calendar-assistant
calendar-assistant force-pushed the docs/vc-minutes-transcript-routing branch from fe9a17e to 8ecdd37 Compare July 20, 2026 07:53
@calendar-assistant
calendar-assistant merged commit 79adf89 into main Jul 20, 2026
35 of 43 checks passed
@calendar-assistant
calendar-assistant deleted the docs/vc-minutes-transcript-routing branch July 20, 2026 08:49
@liangshuo-1 liangshuo-1 mentioned this pull request Jul 20, 2026
3 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

domain/vc PR touches the vc domain size/M Single-domain feat or fix with limited business impact

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants