docs(calendar): add +rsvp usage to skill

[luojiyin1987]

Summary

This PR makes the calendar +rsvp shortcut directly discoverable from skills/lark-calendar/SKILL.md.
It adds inline usage guidance, concrete accept/decline/tentative examples, and the required scope so agents do not need to dig into references before finding the correct command.

Changes

• Add a dedicated +rsvp usage section to skills/lark-calendar/SKILL.md
• Document the prerequisite of obtaining event_id first and add accept / decline / tentative examples
• Add calendar:calendar.event:reply to the permissions table

Test Plan

• Unit tests pass
• Manual local verification confirms the lark xxx command works as expected
• Verified the documentation diff locally and confirmed the change is limited to skills/lark-calendar/SKILL.md

Related Issues

• Closes chore(calendar): +rsvp shortcut 未在 SKILL.md 中给出，导致模型难以发现 #665

Summary by CodeRabbit

• Documentation
  • Enhanced documentation for the +rsvp shortcut with usage instructions, prerequisite requirements (event_id retrieval via +agenda), and required permission scope details. Updated permissions reference table.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 6a9006a2-1b0a-4f32-b595-9c2fede37441

📥 Commits

Reviewing files that changed from the base of the PR and between 7fb71c6 and 8929941.

📒 Files selected for processing (1)

• skills/lark-calendar/SKILL.md

---

📝 Walkthrough

Walkthrough

This PR adds documentation for the existing +rsvp shortcut in Lark Calendar's SKILL.md file. It clarifies usage prerequisites, required permissions scope, example commands, and important constraints to help models discover and use the RSVP functionality correctly.

Changes

Calendar RSVP Shortcut Documentation

Layer / File(s)	Summary
Feature Usage Documentation skills/lark-calendar/SKILL.md (lines 83–105)	New subsection "+rsvp 用法补充" explains when to use the shortcut, mandatory prerequisite of obtaining event_id via +agenda, required scope calendar:calendar.event:reply, example commands for accept/decline/tentative responses, and explicit guidance against guessing event IDs.
Permissions Reference skills/lark-calendar/SKILL.md (line 175)	Permissions table updated to list +rsvp shortcut with its required scope calendar:calendar.event:reply.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• feat(calendar): implement rsvp shortcut #151: Implements the +rsvp shortcut functionality that this documentation PR describes and promotes for discoverability.

Suggested labels

domain/calendar, size/M

Suggested reviewers

• hugang-lark

Poem

🐰 A shortcut once hidden, now brought to light,
With docs and with guidance, all shining so bright!
Accept, decline, tentative—now clearly they'll see,
How +rsvp makes calendar planning carefree! ✨📅

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'docs(calendar): add +rsvp usage to skill' clearly and concisely describes the main change of adding documentation for the +rsvp shortcut to the skill file.
Description check	✅ Passed	The PR description comprehensively covers all template sections: Summary explains the change motivation, Changes lists the specific modifications, Test Plan documents verification steps, and Related Issues properly links to issue #665.
Linked Issues check	✅ Passed	The PR fulfills all requirements from issue #665: it documents the +rsvp shortcut in SKILL.md with usage examples for accept/decline/tentative, notes the event_id prerequisite, and includes the calendar:calendar.event:reply scope in permissions.
Out of Scope Changes check	✅ Passed	All changes are directly related to documenting the +rsvp shortcut in SKILL.md as required by issue #665, with no out-of-scope modifications detected.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

• Generate code and open pull requests
• Plan features and break down work
• Investigate incidents and troubleshoot customer tickets together
• Automate recurring tasks and respond to alerts with triggers
• Summarize progress and report instantly

Built for teams:

• Shared memory across your entire org—no repeating context
• Per-thread sandboxes to safely plan and execute work
• Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started

---

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

• X
• Mastodon
• Reddit
• LinkedIn

_{Review rate limit: 7/8 reviews remaining, refill in 7 minutes and 30 seconds.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[calendar-assistant]

Thanks for the contribution. I took another look at the current calendar skill, and I don't think we should merge this as-is.

The main skill already lists +rsvp in the Shortcuts table and links to references/lark-calendar-rsvp.md. That reference doc already covers the purpose of +rsvp, the need to obtain event_id first, the accept/decline/tentative examples, and the required calendar:calendar.event:reply scope.

We intentionally keep shortcut-specific command details in the reference docs so the main skill stays focused and does not duplicate every shortcut's full usage. Adding the same details inline here would make the main skill longer and create another place that has to be kept in sync.

Could you share what behavior you observed that made this extra inline section necessary? If the issue was caused by a stale installed skill, updating/installing the latest skill may be the better fix.

Thanks again for looking into +rsvp discoverability and for trying to improve the agent experience.

[luojiyin1987]

It only update skill.md doc. Do you want everyone read your code ?