feat(base): clarify skill routing and reference hierarchy

[zgz2048]

Summary

• route all Base Record reading, search, matching, and analysis tasks through a prominent Record query and analysis SOP
• keep +data-query behind the SOP Cloud aggregation decision and merge its standalone guide into the DSL reference
• rename key Base references so module entries, SOPs, and schema references are immediately recognizable
• update CLI help, validation hints, cross-references, and contract tests to the new hierarchy

Why

Agents could discover data-query or a low-level reference before reading the analysis SOP, which encouraged premature tool selection and incomplete resource discovery. Generic reference names also obscured which files were module entries versus conditional schema details.

This change establishes the standard resource discovery chain (table-list -> field-list -> record-list / record-search) while making the Record SOP the explicit entry for record-related work.

Validation

• go test ./shortcuts/base/...
• go test ./internal/vfs/...
• all skills/lark-base Markdown links resolve
• git diff --check

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d4e16e4c-b002-4ffb-a117-d7599a25f07b

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

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

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

[github-actions]

🚀 PR Preview Install Guide

🧰 CLI update

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

🧩 Skill update

npx skills add zgz2048/cli#codex/clarify-base-skill-routing -y -g