mcpField
Z
zsxq-topic

zsxq-topic

github.com/unnooその他3174.6k 回インストール1 週間前に更新
リポジトリ

zsxq-topic について

zsxq-topic は、知識星球のトピックを管理するスキルです。コンテンツの検索、確認、投稿、コメントを行うユーザー向けで、投稿、質問、課題の編集や回答、精華設定に対応します。

主な機能

  1. 01トピック検索と詳細の確認
  2. 02通常投稿の作成と編集
  3. 03スレッド形式の返信を含むコメント
  4. 04質問トピックへの回答
  5. 05トピックのタグ・精華状態の設定

活用シーン

  1. 01キーワードでグループ内のトピックを検索
  2. 02トピックの内容、コメント、タグを確認
  3. 03通常投稿を公開または修正
  4. 04コメントに返信、またはグループの質問に回答

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/unnoo/zsxq-skill --skill zsxq-topic

インストール後、Claude Code で/zsxq-topicを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
zsxq-topic-answer.md
zsxq-topic-create.md
zsxq-topic-delete.md
zsxq-topic-detail.md
zsxq-topic-edit.md
zsxq-topic-reply.md
zsxq-topic-search.md

詳細

プロジェクトの README より

topic

首次使用或遇到认证错误（401 / token 过期 / not logged in）时，先读 ../zsxq-shared/SKILL.md 了解登录与 API 调用约定。日常调用已登录账户时无需每次重读。

Core Concepts

  • 主题（Topic）：星球内的内容单元，由 topic_id 唯一标识。类型：
    • talk：普通帖子（图文）
    • q&a：提问，可被星主回答
    • task：作业题目
    • solution：作业答案
  • 评论（Comment）：主题下的回复，由 comment_id 标识，支持楼中楼（replied_comment_id）。
  • 精华（Digested）：星主可将优质主题设为精华，在星球内突出展示。

Resource Relationships

Group (group_id)
└── Topic (topic_id) — talk / q&a / task / solution
    ├── Comment (comment_id)
    │   └── 楼中楼 Reply (replied_comment_id)
    ├── Answer（q&a 类型专属）
    └── Hashtag 标签列表

Shortcuts（推荐优先使用）

Shortcut 是对常用操作的高级封装（zsxq-cli topic +<verb> [flags]）。有 Shortcut 的操作优先使用。

Shortcut说明
+search在星球内全文搜索主题，返回 topic_id / 类型 / 标题 / 时间表格
+detail获取单条主题的完整详情（内容、评论数、点赞数、标签等）
+create在指定星球发布新主题（仅支持 talk 类型），需确认内容后执行
+edit编辑自己发布的主题（正文、附件），需确认内容后执行
+reply对主题发表评论，支持楼中楼回复，需确认内容后执行
+answer对提问类主题（q&a）发布官方回答，需确认内容后执行

API（通过 zsxq-cli api call 直接调用）

Shortcut 未覆盖的高级操作：

工具参数说明
get_topic_commentstopic_id, limit, index获取主题评论列表（分页）
set_topic_digestedtopic_id, digested设置/取消精华（星主权限）
set_topic_tagstopic_id, titles为主题设置标签（标签名数组）
get_self_question_topicstopic_filter, count, end_time查看自己发起的提问（unanswered/answered）
get_self_answer_topicstopic_filter, count, end_time查看别人向我发起的提问（unanswered/answered）

原始 HTTP 调用（zsxq-cli api raw）

操作命令模板说明
删除主题api raw --method DELETE --path /v2/topics/<topic_id>删除主题，不可恢复

コメント

Markdown 対応