skills/unnoo__zsxq-skill
1
0
Fork 0
mirror of https://github.com/unnoo/zsxq-skill.git synced 2026-09-14 19:59:58 +08:00
Code Issues Packages Projects Releases Wiki Activity
37 Commits 8 Branches 2 Tags
main
Commit Graph

37 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
Wesson e7d24ddcc1 feat(scenario): 新增 answer-product-docs 产品文档问答场景 (#36) 
将知识星球帮助中心(doc.zsxq.com)只读问答能力作为 zsxq 的一个场景引入，
承担产品规则/功能/常见问题的知识问答分支，与内容操作、数据查询等既有场景互补。

- 新增场景入口 references/scenarios/answer-product-docs.md（10 节齐全）
- 附属文档 answer-product-docs/{doc-index,answer-policy}.md：检索机制与回答边界
- SKILL.md 注册三处：快速索引、场景表、description 触发关键词
- 核心约束：只答帮助中心正文、数字逐字照搬、未收录不编造、操作类交回主路由
- 附验证报告 docs/verification/answer-product-docs.md + 日志（4 用例真实 WebFetch）
 2026-09-14 17:35:24 +08:00
zhuguojie-unnoo f07d7f5778 feat: 支持 Skill Pay 购买流程 (#33) 
* feat: support Skill Pay purchase flow

* fix: harden Skill Pay order flow
2.2.0 		2026-08-28 16:47:42 +08:00
dependabot[bot] 90e8d04876 chore(deps): bump ip-address (#32) 
Bumps the npm_and_yarn group with 1 update in the /skills/zsxq/scripts/scenarios/generate-video directory: [ip-address](https://github.com/beaugunderson/ip-address).


Updates `ip-address` from 10.2.0 to 10.5.0
- [Release notes](https://github.com/beaugunderson/ip-address/releases)
- [Commits](https://github.com/beaugunderson/ip-address/compare/v10.2.0...v10.5.0)

---
updated-dependencies:
- dependency-name: ip-address
  dependency-version: 10.5.0
  dependency-type: indirect
  dependency-group: npm_and_yarn
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
 2026-08-13 20:03:31 +08:00
dependabot[bot] 6e17cd7fd7 chore(deps): bump js-yaml (#28) 
Bumps the npm_and_yarn group with 1 update in the /skills/zsxq/scripts/scenarios/generate-video directory: [js-yaml](https://github.com/nodeca/js-yaml).


Updates `js-yaml` from 4.1.1 to 4.3.1
- [Changelog](https://github.com/nodeca/js-yaml/blob/4.3.1/CHANGELOG.md)
- [Commits](https://github.com/nodeca/js-yaml/compare/4.1.1...4.3.1)

---
updated-dependencies:
- dependency-name: js-yaml
  dependency-version: 4.3.1
  dependency-type: indirect
  dependency-group: npm_and_yarn
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
 2026-08-13 20:02:03 +08:00
zhuguojie-unnoo 341a384acd feat: 同步 zsxq-cli v0.5.0 新能力 — AI 声明/投票/问答/markdown、精华置顶、定时任务、星球设置 (#31) 
* feat: 同步 zsxq-cli v0.5.0 新能力 — AI 声明/投票/问答/markdown、精华置顶、定时任务、星球设置

- 新增 reference：topic-set（精华/置顶）、topic-schedule / topic-scheduled /
  topic-unschedule（定时发布三命令）、group-settings（名称/简介/背景图/亮点图）
- 更新 topic-create（--ai/--ai-mode、--vote-title/--vote-options、--ask/--anonymous、
  --markdown/--markdown-file）、topic-edit（--ai/--ai-mode/--vote-id、AI 声明不可修改实测）、
  topic-answer（--scheduled-time/--silenced 定时回答）
- 修正 topic-reply 附件数说明（仅支持 1 个文件，实测）；topic-digest 交叉引用 +set
- SKILL.md 注册：Shortcuts 表、快速索引、资源关系树、核心概念、安全规则、description 关键词
- auth-errors.md 新增 429 限流行
- 恢复 verification 模板（本地）；9 份验证报告与日志（gitignore 本地留存）
- 实测校准：创建/定时响应不含 job_id、q&a 创建受提问费用配置限制（80105/80106）、
  AI 声明一经设置不可修改、52201 任务不存在、非图片上传报错文案

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* chore: skill 版本号 2.0.0 → 2.1.0（新增精华置顶/定时任务/星球设置/AI 声明/投票/问答/markdown 能力）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
 2026-08-13 20:01:26 +08:00
zhuguojie-unnoo deb89d00c8 docs: 更新 README 适配 skill v2 架构 (#27) 
- 核心能力新增：精华与标签、专栏收录、NPS 反馈、场景编排
- 典型使用场景加入场景化运营示例
- Agent Skills 表扩展，补充三层路由与 28 个 reference 说明
- 功能详情：星球管理加专栏/成员命令，主题操作加精华/标签/专栏收录/删除
- 新增场景编排（Scenarios）节，列出全部 12 个场景
- 高级 API 节更新 api raw 语法与探索模式说明
- 写入操作统一加 ⚠️ 标记

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
 2026-07-31 14:19:04 +08:00
zhuguojie-unnoo 7451f78935 refactor: skill v2 架构升级 — 单一 zsxq skill + 11 个场景 + 全套原子操作 
🤖 Generated with [Claude Code](https://claude.com/claude-code)
 2026-07-31 14:09:24 +08:00
zhuguojie 34205bf1de docs: 新增面向 AI Agent 的安装指南 INSTALL.md 
- 提供 GitHub / Gitee 双通道安装说明
- 包含离线 zip 备选方案
- 面向 AI Agent 编写，支持一句话指令自动安装

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1.3.1 		2026-06-22 14:21:32 +08:00
zhuguojie-unnoo 70a19fbcba Merge pull request #15 from unnoo/auto-optimize/20260612-1145 
feat(group): 新增「反例（不要做）」节补齐反模式清单
 2026-06-12 18:21:10 +08:00
zhuguojie 2d5a2d2f89 optimize zsxq-group: 新增「反例（不要做）」节补齐 dim9 反模式清单 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
 2026-06-12 18:18:35 +08:00
zhuguojie-unnoo 28702aef86 Merge pull request #11 from unnoo/worktree-goofy-mapping-flask 
fix(topic): 移除 article 类型，补全正确的四种主题类型
 2026-05-25 14:02:11 +08:00
zhuguojie a8226a5071 fix(topic): 移除 article 类型，补全正确的四种主题类型 
主题 type 字段实际只有 talk / q&a / task / solution，
article 从未存在于 API 返回值中。+create 仅支持 talk，
在 reference 中补充 [!IMPORTANT] 说明。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-05-25 13:58:56 +08:00
zhuguojie 677113296c chore: 暂时移除 OpenSSF Scorecard 徽章 
仓库尚未被 OpenSSF Scorecard 公共数据库收录,徽章一直显示
"invalid repo path"。先移除以避免 README 看起来像有错误。

后续若部署 OpenSSF Scorecard GitHub Action 自助扫描,可以
再加回来。
 2026-05-21 14:26:39 +08:00
zhuguojie-unnoo 36946c508e Merge pull request #9 from unnoo/docs/readme-star-history 
docs: Star History、NPS 范围调整与异常场景主动提示反馈
 2026-05-21 14:04:47 +08:00
zhuguojie 8adcf65cb6 chore: .gitignore 增加 docs/superpowers/ 
把本地草稿目录(spec/plan)忽略,避免误提交到仓库。
设计/实施文档为本地参考,不进入版本库。
 2026-05-21 13:59:41 +08:00
zhuguojie 9b8310b202 style(shared): 反馈提醒节关键约束第 4 条半角逗号改全角 
与文档其他位置全角标点风格保持一致。
 2026-05-21 13:56:28 +08:00
zhuguojie 35c00c13d0 chore: 4 个 domain SKILL.md 同步 bump 至 1.3.1 
跟随 zsxq-shared 的反馈提醒节新增,domain skill 版本号同步
patch bump,保持跨文件版本一致。
 2026-05-21 13:56:28 +08:00
zhuguojie 89720045e8 style(nps): 主动触发场景 bullet 去除加粗,与「说明」节其他 bullet 风格对齐 2026-05-21 13:56:28 +08:00
zhuguojie 12d33619aa docs(nps): 在 reference 加入主动触发场景交叉引用与 tag 约定 
在 +nps reference 的「说明」节追加主动触发场景说明,链接回
zsxq-shared 的反馈提醒节;在 --suggestion 参数说明里指引用
#产品建议# / #工具反馈# 前缀,便于官方分流。
 2026-05-21 13:56:28 +08:00
zhuguojie 966ee061ec fix(shared): 反馈提醒节 review 修订 
- 关键约束首条改为陈述句,移除疑问从句
- 提示流程 [4] 起草环节补 ≤ 500 字上限提醒
- 索引显示文本补全为「反馈提醒（NPS）」与节标题对齐
- 触发场景表表头由「suggestion 标签」改为「标签」,与文档全中文表头一致
- 排除场景末条「引用本表」改为明确指向「## 常见错误处理 表」
 2026-05-21 13:56:28 +08:00
zhuguojie bfac044688 feat(shared): 新增反馈提醒(NPS)规则节,version 1.3.1 
在 zsxq-shared 增加 ## 反馈提醒(NPS) 通用规则节,描述何时
建议用户提交 NPS 反馈、排除哪些状态类错误、提示流程 5 步、
每会话 1 次频率约束,以及 #产品建议# / #工具反馈# tag 约定。
 2026-05-21 13:56:28 +08:00
zhuguojie 3ecfdb67f3 docs: NPS 推荐分数范围由 0-10 调整为 1-10 
与 CLI 端校验规则保持一致。同步更新 zsxq-user-nps reference、
zsxq-user SKILL.md Shortcuts 表，以及 zsxq-shared 错误说明
分层规则中的举例。

注意:CLI 端 (--score must be 1-10) 校验逻辑需在 zsxq-cli
仓库同步调整,本仓库仅文档侧。
 2026-05-21 13:56:28 +08:00
zhuguojie-unnoo 6c1085ef93 Merge pull request #8 from unnoo/docs/readme-star-history 
docs: 在 README 添加 Star History 曲线
 2026-05-20 17:58:40 +08:00
zhuguojie 66ff456ca4 docs: 在 README 添加 Star History 曲线 
使用 star-history.com，支持暗/亮主题自适应。

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-05-20 17:55:53 +08:00
zhuguojie-unnoo 8f634b88dd Merge pull request #7 from unnoo/feat/zsxq-skill-review-and-nps 
feat: 新增 user +nps 并完成 skill 文档 review
 2026-05-20 17:49:51 +08:00
zhuguojie 932eb16309 chore: 添加 .gitignore 屏蔽 .DS_Store 
避免 macOS Finder 元数据误提交。

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-05-20 17:42:09 +08:00
zhuguojie 1d2ae32aa7 docs: 第 6 轮 review 统一 reference 跨文件格式 
- group +list / +topics 参数表格从 4 列改回 3 列，与其余 15 个 reference 对齐，默认值与最大值合并进说明
- note +list 错误说明补「返回空列表」行，与 group +list / +hashtags / user +footprints 等只读 list 对称

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-05-20 17:38:54 +08:00
zhuguojie 30ae06cb88 docs: 第 5 轮 review 对齐错误说明分层规则 
- 删除 reference 中混入的通用参数缺失错误（topic search、user nps），统一回到 shared
- 删除 topic/note edit 中的"无权限"通用 403，note edit 增加 IMPORTANT 块声明只能编辑自己创建的笔记
- 修正 shared 中 get_user_footprints 示例：默认跨星球，单星球作为可选示例
- shared 安全规则补全编辑/回答/删除/NPS 等动作
- user nps 顶部「前置条件」改为「版本要求」，与统一删除的前置条件措辞区分

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-05-20 17:32:36 +08:00
zhuguojie e1189d35d2 feat: 新增 user +nps 并完成四轮 skill 文档全面 review 
新增能力
- user +nps：提交 NPS 反馈（0–10 分推荐分数 + 必填文字建议，500 字以内）
- 要求 zsxq-cli >= 0.4.6，旧版本下提供升级指引

新增 CLAUDE.md
- 收录 reference 统一模板（写入类 / 只读类）
- 错误说明信息分层规则（通用归 shared，特有归 reference + fallback）
- 措辞约定（不使用「MCP 工具」/「MCP 未封装」等内部实现术语）
- 新增操作的标准流程

第一轮 review
- group +list：实际返回加入与创建的所有星球，移除已不支持的 --scope
- topic SKILL.md：删除主题从 API 表迁出，单列原始 HTTP 调用小节
- user SKILL.md：移除与 group 重复登记的 search_group_members
- 4 个 domain SKILL.md 顶部 CRITICAL 提示软化为按需触发
- zsxq-shared / zsxq-topic description 扩展关键词触发覆盖
- note +create / note +edit CAUTION 块对齐 topic 风格
- 18 个 reference 新增「错误说明」与「失败语义」小节
- note SKILL.md / +create 显式说明笔记是公开内容
- topic +delete 引用列表新增 topic +edit
- note +edit / +delete 末尾补换行符
- zsxq-shared 顶部新增 Commands 表
- 5 个 SKILL.md 版本字段统一为 1.3.0

第二轮 review
- 删除 17 个 reference 顶部冗余「前置条件」行
- zsxq-shared 移除 MCP 相关措辞
- zsxq-topic description 重写：明确评论列表/精华/标签/提问记录均通过 api call 实现
- 删除 zsxq-topic SKILL.md 的 Important Notes 小节
- zsxq-note description / Shortcuts 表把「个人笔记」改为「公开笔记」
- 错误说明信息分层：shared 列通用错误，下游 reference 仅保留特有错误并 fallback

第三轮 review
- group SKILL.md：+list 描述同步「加入或创建的所有星球」；Resource Relationships 补 Reply 与 Answer
- shared SKILL.md：删除与 Commands 表重复的小节，登录流程合并为一段 OAuth 流程说明
- topic-answer / topic-edit / topic-delete：错误说明分层补 fallback
- topic-reply：新增错误说明小节
- user-nps / topic-delete：调整为「失败语义 -> 错误说明」顺序
- topic-delete：标题改为「topic 删除（通过 api raw）」
- note-create：reference 措辞同步为「创建公开笔记」

第四轮 review
- 5 个 SKILL.md 标题去掉 (v1) 标记
- group SKILL.md 删除与 shared Commands 表重复的 api 命令清单
- shared SKILL.md 顶部加目录索引（链接拼接、安全规则、错误码等）
- topic +reply：--reply-to 加楼中楼定义；--files 补多文件示例；
  「获取 comment_id」并入推荐工作流并指向 SKILL.md API 表
- topic +create：去掉工作流「（可选）」；调整为推荐工作流→失败语义→错误说明
- topic +answer：「查找待回答的提问」并入推荐工作流；调整顺序
- topic +detail / user +info：输出示例移除 // 注释，字段说明独立成段
- user +nps：「NPS 分数语义 / 频率与限制」并入「说明」节，整体按统一模板重排
- note +create：补完整模板；删除与 SKILL.md 重复的「不属于任何星球」
- note +delete：补错误说明 fallback
- note +list：删除只读类不需要的「推荐工作流」，并入「说明」
- group +topics：「分页说明」并入「说明」
- group +hashtags：「按标签浏览主题」并入「说明」
- user +footprints：「与 group +topics 的区别」并入「说明」
 2026-05-20 17:20:59 +08:00
zhuguojie ceb77cfb98 docs: 修正 zsxq-shared 中会 404 的 api raw 示例 
- 删除会返回 404 的 GET /v2/groups/<id>/topics 示例
- raw 示例改为写入类（PUT 修改主题）
- 增加引导：列表/查询优先用 api call，api raw 主要用于 MCP 未封装的写入接口

Refs: #6
 2026-05-18 15:14:12 +08:00
zhuguojie 2001e0f94b docs: 修正 shared skill 退出登录命令，补全 topic create 参数说明 
Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
 2026-05-14 17:04:50 +08:00
zhuguojie 56572c0b5b feat: zsxq-skill 适配 zsxq-cli 0.3.0 
- topic +create 参数 --content 统一为 --text
- topic/reply/answer/note +create 新增 --files 附件参数
- 新增 topic +edit 编辑主题（正文、附件）
- 新增 note +edit/+detail/+delete 编辑、查看、删除笔记
- 更新 api raw 文档（去嵌套、--body 简写）
- 新增链接拼接规则（主题/星球的电脑端和手机端 URL）
- 同步更新 README、SKILL.md description 和 Shortcuts 表

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-11 17:16:53 +08:00
zhuguojie 2e323b42df feature: fix docs 2026-04-20 22:05:55 +08:00
zhuguojie 8d7b32997e feat: 新增删除主题功能文档 
添加 zsxq-topic-delete.md 参考文档，记录通过 api raw DELETE 删除主题的用法；
更新 SKILL.md 注册 delete topic 和 get_self_answer_topics API 条目。

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-04-19 17:02:49 +08:00
zhuguojie 464a18592a docs: 在 topic +answer 文档中补充 get_self_answer_topics 查询示例 
新增查看别人向我发起的提问（未回答/已回答）两条命令。

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-04-19 16:50:59 +08:00
zhuguojie 080851b859 docs: 更新 README 文档。 2026-04-18 10:42:02 +08:00
zhuguojie 8c1fe6c8bd feat: 初始化 zsxq-skill，包含 Skills 文档与优化后的 README 
- 初始化仓库，包含 zsxq-group / zsxq-topic / zsxq-note / zsxq-user / zsxq-shared 五个 Skill
- 优化 README：突出官方出品身份、明确权限范围、新增"为什么选"章节、分人类/Agent 两种快速开始、新增 Skills 汇总表和安全风险提示
- 修正"足迹"概念：统一描述为用户在各星球发过的主题
- 全局将真实数据替换为模拟数据，通篇 ID 保持一致

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-16 16:48:08 +08:00