This Skill covers all scenarios for operating Knowledge Planet via zsxq-cli (CLI channel) or the underlying interface tool call_zsxq_api (MCP channel): authentication, planet management, topic management, user information, note management, and Skill Pay WeChat payment.
By default, it is assumed that zsxq-cli is installed and logged in, so there is no need to proactively check every time. Handle it on demand only when a command execution reports an error (see
references/auth-errors.md)。
All identifiers such as IDs, order numbers, and payment codes in the examples of this Skill are simulated data and do not correspond to real resources. When performing operations, the real identifiers must be obtained and verified through query results or user input, and the example values must not be reused directly.
Execution channel
All capabilities of this Skill have two execution channels; determine the channel first, then route:
- The host can execute
zsxq-cli→ CLI channel(preferred; shortcuts have parameter validation and local orchestration, so behavior is the most controllable) - Otherwise, the host tool list contains
call_zsxq_api→ MCP channel - If neither is available → stop and remind the user: install the CLI (see
references/auth-errors.md) or connect the Knowledge Planet MCP in the host (create an api-key on the key management page and then copy the link to connect), and let the user choose
- Channel determination is a one-time environment probe; once selected, use it consistently and do not mix channels. Only when an operation is marked "CLI channel only" / "MCP channel only" should you switch separately for that operation or inform the user.
- Under the MCP channel, all calls go through the underlying interface tool
call_zsxq_api(parameters{method, path, query?, body?});Do not fabricate undocumented method/path— for the capability base table, seereferences/endpoint-catalog.md, and anything not covered is considered unsupported. - The "execution mode" routing (scenario → atomic → exploration) is the same under both channels; the channel only determines which set of call blocks each reference's "## Commands" section uses.
Execution mode
Route user requests in the following order, execute on hit, and do not continue further down:
- Scenario mode — the request hits aregistered scenario: read the scenario entry document and orchestrate atomic operations according to the process
- Atomic operation — the request clearly corresponds to one common operation: read the corresponding reference and directly call the recommended command
- Exploration mode — nothing hits: follow
references/cli-exploration.mdto discover capabilities through CLI help and the API list
When executing atomic operations and scenariosmust notpre-run unrelated
doctor、--helporapi list. Fall back to exploration mode only when the capability does not match or the call fails.
Quick index
Based on the user's intent, jump directly to the corresponding section or reference:
| The user wants to… | Where to look |
|---|---|
| Log in / check login status / troubleshoot authentication or HTTP errors | → references/auth-errors.md |
| Daily patrol: check today's new content that needs attention/handling | → scenarios/daily-patrol.md |
| Organize the comment section, find unreplied comments and draft replies | → scenarios/triage-comments.md |
| Handle questions others have raised to me that haven't been answered yet | → scenarios/manage-inbound-questions.md |
| Curate featured content and tags (feature / tag suggestions) | → scenarios/curate-digest-and-tags.md |
| Generate operations daily report / weekly report / retrospective | → scenarios/compose-operations-report.md |
| Turn Planet content into daily report poster images (PNG) | → scenarios/generate-daily-poster.md |
| Turn Planet posts into vertical animated videos (MP4) | → scenarios/generate-video.md |
| Patrol and monitor negative / risky content | → scenarios/monitor-risky-content.md |
| Batch tag topics with given tags | → scenarios/batch-tag-topics.md |
| Expiring member renewal care (identify members about to expire, write tiered scripts) | → scenarios/care-expiring-members.md |
| Batch collect the latest topics into columns | → scenarios/archive-topics-to-column.md |
| Ask about product rules/features/FAQ (refunds, fees, invoicing, verification, review, bans…) | → references/scenarios/answer-product-docs.md |
| Check/migrate/clean up the old zsxq skill | → references/scenarios/migrate-legacy-skills.md |
| Use Skill Pay to pay to join / renew / purchase / paid questions / tips | → references/scenarios/purchase-with-skill-pay.md |
| Create Knowledge Planet WeChat orders / handle payment challenges and security recovery | → references/wechat-order-create.md |
| Query prices for joining, gift cards, renewals, light reading, or Planet invite codes | → references/wechat-order-create.md#下单前查询价格 |
| Call the underlying API directly / explore unwrapped capabilities | → references/cli-exploration.md |
| Assemble Knowledge Planet share links | → references/share-links.md |
| Understand security rules (write/delete confirmation) | → Security rules |
| List the Planets I've joined / get group_id | → references/group-list.md |
| Edit Planet name / description / background image / highlight image | → references/group-settings.md |
| Browse the latest topics in a Planet | → references/group-topics.md |
| View Planet tags | → references/group-hashtags.md |
| Search content within a Planet | → references/topic-search.md |
| View post details | → references/topic-detail.md |
| Post (normal / poll / question / markdown / AI declaration) | → references/topic-create.md |
| Edit post | → references/topic-edit.md |
| Comment / nested reply | → references/topic-reply.md |
| Answer a question (immediately / scheduled / silently) | → references/topic-answer.md |
| Delete topic | → references/topic-delete.md |
| Schedule topic publishing / modify or cancel scheduled task | → references/topic-schedule.md |
| View pending scheduled tasks and quotas | → references/topic-scheduled.md |
| Set as featured / pinned (owner) | → references/topic-set.md |
| Unfeature (underlying interface api call) | → references/topic-digest.md |
| Set tags for a topic | → references/topic-tags.md |
| Read / set the column a topic belongs to (collect into column) | → references/topic-attached-columns.md |
| View your own user info | → references/user-info.md |
| View posts you've made (across Planets) | → references/user-footprints.md |
| Submit NPS feedback | → references/user-nps.md |
| Create/view/edit/delete notes | → references/note-create.md , etc. |
| What items need confirmation before writing | → Corresponds to the reference's > [!CAUTION] block + Security rules |
Resource relationships
User (user_id) — 已登录账户
│
├── Group (group_id) — 星球/社群
│ ├── Topic (topic_id) — talk / q&a / task / solution
│ │ ├── Comment (comment_id)
│ │ │ └── 楼中楼 Reply (replied_comment_id)
│ │ ├── Answer — q&a 类型专属
│ │ └── Hashtag 标签
│ ├── Scheduled Job (job_id) — 定时发布主题/回答,每星球上限 10
│ └── Hashtag (hashtag_id)
│ └── Topic 列表
│
└── Note (note_id) — 公开笔记,不属于任何星球
Core concepts
- Planet (Group): the community unit of Knowledge Planet, uniquely identified by
group_id(pure digits). A user can be the creator or a member. - Topic: the content unit within a Planet, types:
talk(post),q&a(question),task(assignment),solution(assignment answer). - Note: a content unit independent of Planets,publicly visible, accessible to anyone with the link — not a private memo.
- Comment: Replies under a topic, supports nested replies (
replied_comment_id)。 - Digested / Sticky: Those with management permissions (Star Owner / Admin / Partner) can set a topic as digested or sticky, changing how it is displayed within the planet.
- Scheduled Job: A topic or answer can be scheduled to publish automatically at a future point in time (within a 14-day window), with a limit of 10 per planet.
Security Rules
- Do not output or transmit authentication tokens — a token is a login credential; do not output it in plain text in the terminal, and do not share it with others
- Before write/delete operations, you must confirm the user's intent(posting, editing, commenting, answering, scheduled publishing, setting digested/sticky, modifying planet profile, creating notes, deleting topics or notes, canceling scheduled jobs, submitting NPS feedback, etc.)
- Skill Pay is only supported on WorkBuddy and the host must provide the official
weixinpay_pay; if any condition is not met, you must state that it is not supported and stop before creating an order, and must not callcall_zsxq_apito create an order - Before creating an order, you must query or calculate the price according to the atomic reference, and confirm the type, object, and actual amount payable; fixed prices must not be rewritten by the user, and payment must be authorized by the user personally;
PAYMENT_REQUIREDeven if it returnssuccess: falseit only means pending payment, not failure or successful payment; automatically retrying order creation is prohibited - When unsure about
group_id/topic_id/comment_id/note_id, first use a query command to confirm, then perform the write or delete - Notes are public content, accessible to anyone with the link — do not write privacy-related or sensitive information into notes
api rawwrites must not bypass the security constraints of atomic operations; write interfaces discovered in exploration mode also require user confirmation- The
> [!CAUTION]block of each write/delete reference lists the confirmation items specific to that operation - Once a channel is selected, use it consistently and do not mix channels; the MCP channel must not fabricate method/path values not documented in the reference or endpoint-catalog
Scenarios
Scenarios express business goals and are orchestrated from multiple atomic operations. SKILL.md only links to scenario entry points; for process details, see the entry documents.
| Scenario | Trigger phrase | Entry |
|---|---|---|
| Daily patrol | "Daily patrol / inspect the planet" "See what needs to be handled today" | scenarios/daily-patrol.md |
| Comment section operations | "Organize comment section questions for me to reply to" "Find unanswered comments and draft replies" | scenarios/triage-comments.md |
| Question management | "Find questions others asked me that I haven't answered yet" "Organize pending questions by priority" | scenarios/manage-inbound-questions.md |
| Digest and tag organization | "Organize recent topics, digest what should be digested and tag what should be tagged" "Which posts are worth setting as digested" | scenarios/curate-digest-and-tags.md |
| Operations daily report / weekly report / retrospective | "Make today's operations daily report" "Make this week's operations weekly report" "Review the past 7 days of operations" | scenarios/compose-operations-report.md |
| Generate planet daily report poster | "Generate a planet daily report poster / make a daily report image" "Turn recent content into a poster and send it to the group" | scenarios/generate-daily-poster.md |
| Generate vertical animated video | "Help me turn this post into a video" "Find recent posts suitable for making videos" "Generate this week's video" "Turn planet content into a video" | scenarios/generate-video.md |
| Negative content monitoring | "Patrol / monitor risky content in the planet" "Check for abuse / ads / complaints every hour" | scenarios/monitor-risky-content.md |
| Automatic tagging | "Batch-tag recent topics with given tags" "Batch re-tag historical content" | scenarios/batch-tag-topics.md |
| Expiring member renewal care | "Check members about to expire" "Do renewal care / renewal reminders" "Write scripts for expiring members based on activity level" | scenarios/care-expiring-members.md |
| Include topics in columns | "Include the latest N topics into column XX" "Batch-archive topics into columns / organize topic collections" | scenarios/archive-topics-to-column.md |
| Migrate legacy skill | "Check/clean up/migrate legacy Knowledge Planet skill" "Upgrade zsxq skill" | scenarios/migrate-legacy-skills.md |
| Skill Pay purchase | "Join or renew with Skill Pay / WeChat Pay" "Buy gift cards / light reading" "Paid questions / tips" | scenarios/purchase-with-skill-pay.md |
| Answer product documentation questions | "How do I get a refund for the planet / how long does a refund take" "How much is the fee / what is the rate" "How do I issue an invoice / what materials are needed for enterprise verification" "Why did the review fail / rules for violation bans" | scenarios/answer-product-docs.md |
Skill Pay
When handling Skill Pay purchase intent, read the purchase scenario for orchestration; the parameters and error semantics for creating orders, prices, payment authorization, and secure recovery are governed only by the atomic reference.
- Purchase scenario:
scenarios/purchase-with-skill-pay.md - Create order atomic operation:
wechat-order-create.md
Planet management (group)
| Shortcut | Description | Reference |
|---|---|---|
zsxq-cli group +list |
List joined/created planets and get group_id | group-list.md |
zsxq-cli group +topics |
Browse the latest topics in a planet (paged) | group-topics.md |
zsxq-cli group +hashtags |
List planet tags and topic counts | group-hashtags.md |
zsxq-cli group +settings |
Modify planet name / description / background image / highlight image ⚠️ | group-settings.md |
API(zsxq-cli api call):
| Tool | Parameter | Description |
|---|---|---|
search_groups |
keyword |
Search planets by keyword |
search_group_members |
group_id, keyword, limit |
Search planet members |
get_hashtag_topics |
hashtag_id, limit, end_time |
List topics under a tag (paged) |
Raw HTTP call:
| Operation | Command template | Reference |
|---|---|---|
| Member list | api raw --method GET --path /v2/groups/<group_id>/members --query '<json>' |
group-members.md |
| Column list | api raw --method GET --path /v2/groups/<group_id>/columns |
group-columns.md |
| Create column | api raw --method POST --path /v2/groups/<group_id>/columns --body '{"name":"…"}' ⚠️ |
group-column-create.md |
The member list's
expired_timeis visible only to owners/admins of paid planets. A topic's column affiliation is a topic-dimension operation, seeTopic managementfor the raw HTTP call.
Counterexamples (do not do)
| ❌ Do not do | ✅ Should do |
|---|---|
When finding content by keyword, use +topics to page through and manually filter item by item |
Use topic +search full-text search |
When checking "what I recently posted," run +topics |
Use user +footprints to get cross-planet footprints in one go |
| When the user only gives the planet name, ask the user to provide the group_id themselves | First use group +list or search_groups to find the ID, then continue |
| When the name matches multiple similar planets, default to the first one | List candidates (group_id + name) for the user to confirm |
Treat search_group_members as a member list interface and increase limit to iterate over all members |
It is a keyword search, used only to locate a specific member by nickname |
Topic management (topic)
| Shortcut | Description | Reference |
|---|---|---|
zsxq-cli topic +search |
Full-text search for topics within a planet | topic-search.md |
zsxq-cli topic +detail |
Get full topic details | topic-detail.md |
zsxq-cli topic +create |
Publish a new post (talk / q&a, poll, AI statement, markdown) ⚠️ | topic-create.md |
zsxq-cli topic +edit |
Edit your own post (body / attachments / AI statement / poll) ⚠️ | topic-edit.md |
zsxq-cli topic +reply |
Comment / nested reply ⚠️ | topic-reply.md |
zsxq-cli topic +answer |
Answer a question (supports scheduled / silent) ⚠️ | topic-answer.md |
zsxq-cli topic +set |
Set featured / pinned ⚠️ | topic-set.md |
zsxq-cli topic +schedule |
Schedule topic publishing (create / modify) ⚠️ | topic-schedule.md |
zsxq-cli topic +scheduled |
View pending scheduled tasks and quota | topic-scheduled.md |
zsxq-cli topic +unschedule |
Cancel a scheduled task ⚠️ | topic-unschedule.md |
⚠️ = write operation; you must confirm the content with the user before executing.
API(zsxq-cli api call):
| Tool | Parameter | Description | Reference |
|---|---|---|---|
get_topic_comments |
topic_id, limit, index |
Get the topic's comment list (paginated) | — |
set_topic_digested |
topic_id, digested |
Set/unset featured (planet owner permission) ⚠️ | topic-digest.md |
set_topic_tags |
topic_id, titles |
Set tags for a topic (titles is the complete set of tags) ⚠️ | topic-tags.md |
get_self_question_topics |
topic_filter, count, end_time |
View questions you have initiated | — |
get_self_answer_topics |
topic_filter(unanswered/answered), count, end_time |
View questions others have initiated to me (account-level, returned items include the group field, must be filtered by planet) |
— |
⚠️ = write operation (
set_topic_digested/set_topic_tagswill modify planet content); you must confirm with the user before executing, and comply with thesafety rulesand the corresponding reference's> [!CAUTION]block.
Raw HTTP call:
| Operation | Command template | Reference |
|---|---|---|
| Delete topic | api raw --method DELETE --path /v2/topics/<topic_id> ⚠️ |
topic-delete.md |
| Read the column a topic belongs to | api raw --method GET --path /v2/topics/<topic_id>/attached_columns |
topic-attached-columns.md |
| Set the column a topic belongs to | api raw --method POST --path /v2/topics/<topic_id>/attached_columns --body '{"column_ids":[...]}' ⚠️ |
topic-attached-columns.md |
⚠️ = write operation; you must confirm with the user before executing. Setting the column a topic belongs to is afull replacement:
column_idsand will overwrite the topic's original column membership; to "add to a column" you must first read the existing set and then merge it back, seetopic-attached-columns.md。
User information (user)
| Shortcut | Description | Reference |
|---|---|---|
zsxq-cli user +info |
View the current user's profile (user_id, nickname, etc.) | user-info.md |
zsxq-cli user +footprints |
View cross-planet posting footprint | user-footprints.md |
zsxq-cli user +nps |
Submit NPS feedback ⚠️ | user-nps.md |
When a user expresses product dissatisfaction during use, discovers a missing platform capability, or is frustrated by multiple retries, after completing the main task you may incidentally prompt them to submit NPS feedback; for trigger details see
user-nps.md。
Note management (note)
Notes arepublic content, anyone with the link can access them — do not write privacy-related or sensitive information into notes.
| Shortcut | Description | Reference |
|---|---|---|
zsxq-cli note +create |
Create a public note ⚠️ | note-create.md |
zsxq-cli note +list |
View the note list | note-list.md |
zsxq-cli note +detail |
View note details | note-detail.md |
zsxq-cli note +edit |
Edit a note ⚠️ | note-edit.md |
zsxq-cli note +delete |
Delete a note (irrecoverable) ⚠️ | note-delete.md |