@openschool_01/skills 0.1.2 → 0.1.4

package/bundled-skills/human-writing/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@openschool_01/skill-human-writing",
+  "version": "0.1.0",
+  "description": "OpenSchool curated skill: human writing.",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "skill"
+  ]
+}

package/bundled-skills/human-writing/skill/OPENSCHOOL-META.md

@@ -0,0 +1,7 @@
+# OpenSchool 收录说明
+
+- 收录名称：Human Writing
+- 收录方式：OpenSchool 严选整合
+- 当前版本：润色版
+
+当前版本重点解决“AI 写得太像 AI”这个问题，适合和公众号助手、小红书助手串起来用。

package/bundled-skills/human-writing/skill/SKILL.md

@@ -0,0 +1,57 @@
+# Human Writing
+
+适用于把 AI 生成的生硬文案，改成更像真人写的版本。
+
+当前版本专注 4 件事：
+
+1. 减少模板味和说明书腔
+2. 增加真实判断和自然转场
+3. 保留原信息，但让表达更顺
+4. 让文案更适合内容平台直接使用
+
+## 什么时候用
+
+当用户要做这些事时使用：
+
+- 让 AI 文案更像真人写的
+- 给公众号文章去掉 AI 味
+- 给小红书文案去掉模板感
+- 把结构保留但把语气写活
+
+## 推荐工作流
+
+### 1. 先判断目标平台
+
+优先确认：
+
+- 是公众号
+- 小红书
+- 视频口播
+- 普通说明文
+
+### 2. 再判断要保留什么
+
+优先保留：
+
+- 核心结论
+- 关键信息
+- 必要步骤
+
+优先改掉：
+
+- 套话
+- 重复解释
+- 机械转场
+- 空泛词
+
+### 3. 输出时默认给两版
+
+- 精修版
+- 更口语一点的版本
+
+## 输出要求
+
+如果用户没有特别说明，默认补一段简短说明：
+
+- 这次主要改掉了什么
+- 哪一版更适合当前平台

package/bundled-skills/human-writing/skill/references/rewrite-rules.md

@@ -0,0 +1,22 @@
+# 改写规则
+
+## 优先改掉
+
+- 本文将
+- 首先、其次、最后
+- 综上所述
+- 赋能、闭环、全方位打造
+- 大量重复的解释句
+
+## 优先保留
+
+- 核心观点
+- 真实场景
+- 能直接执行的动作
+- 必须保留的事实信息
+
+## 风格目标
+
+- 更像真实人写的
+- 更像平台内容，不像汇报材料
+- 更顺口，但不油腻

package/bundled-skills/nano-banana-pro/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@openschool_01/skill-nano-banana-pro",
+  "version": "0.1.0",
+  "description": "OpenSchool curated skill: nano banana pro.",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "skill"
+  ]
+}

package/bundled-skills/nano-banana-pro/skill/OPENSCHOOL-META.md

@@ -0,0 +1,7 @@
+# OpenSchool 收录说明
+
+- 收录名称：Nano Banana Pro
+- 收录方式：OpenSchool 严选整合
+- 当前版本：提示词版
+
+这个版本先解决“图怎么描述才更容易出好”，不先解决“去哪里出图”和“怎么自动下载”。

package/bundled-skills/nano-banana-pro/skill/SKILL.md

@@ -0,0 +1,62 @@
+# Nano Banana Pro
+
+适用于把一段需求整理成更适合生图模型执行的成品提示词。
+
+当前版本专注 4 件事：
+
+1. 把模糊需求补成完整画面描述
+2. 统一画风、构图、比例和细节层级
+3. 生成主提示词、备选提示词和负面提示词
+4. 让图片更适合海报、封面、宣传图这类场景
+
+当前版本不负责：
+
+- 直接调用生图网站
+- 自动下载图片
+- 自动排版进公众号或小红书
+
+## 什么时候用
+
+当用户要做这些事时使用：
+
+- 生成海报图提示词
+- 生成封面图提示词
+- 生成产品宣传图提示词
+- 优化一段生图需求
+
+## 推荐工作流
+
+### 1. 先明确用途
+
+至少确认：
+
+- 这张图要用在哪里
+- 主要对象是什么
+- 希望什么风格
+- 想强调什么信息
+
+### 2. 再补全关键维度
+
+默认补齐这些信息：
+
+- 画面主体
+- 构图方式
+- 色彩方向
+- 比例
+- 背景与氛围
+- 细节限制
+
+### 3. 默认输出三部分
+
+- 主提示词
+- 2 到 3 条可选变体
+- 负面提示词
+
+## 输出要求
+
+如果用户没指定，默认一起给：
+
+- 中文主提示词
+- 英文高质量版提示词
+- 负面提示词
+- 一句使用建议

package/bundled-skills/nano-banana-pro/skill/references/prompt-rules.md

@@ -0,0 +1,22 @@
+# 提示词规则
+
+## 默认结构
+
+1. 先写画面主体
+2. 再写风格和材质
+3. 再写构图和比例
+4. 最后补背景、氛围和限制
+
+## 适用场景
+
+- 公众号封面
+- 小红书封面
+- 宣传海报
+- 产品配图
+
+## 输出原则
+
+- 不要只给几个关键词
+- 要能直接复制去生图
+- 主提示词尽量完整
+- 负面提示词尽量简洁

package/bundled-skills/wechat-assistant/skill/OPENSCHOOL-META.md

@@ -2,18 +2,19 @@
 
 - 收录名称：公众号助手
 - 收录方式：OpenSchool 严选整合
-- 当前版本：纯内容版
-
-当前版本整合了公众号写作流程里最常用的三块能力：
+- 当前版本：内容与草稿箱双模版
 
+本版本重点能力：
 1. 标题方向整理
-2. 正文写作约束
-3. 微信 HTML 渲染与质量检查
-
-本版本刻意不包含：
+2. 正文写作与质量检查
+3. 公众号预览 HTML 渲染（默认无尾注）
+4. 可选上传草稿箱（用户显式提供 appid/appsecret 时执行）
 
+默认不包含：
 - 生图
-- 封面生成
-- 微信 API 发布
+- 封面自动生成
+- 自动正式发布
 
-这样可以先保证“写得出、改得动、落得下、能预览”这条链路稳定。
+上线约束：
+- 不内置任何个人信息尾注
+- 不在仓库存储真实公众号凭据

package/bundled-skills/wechat-assistant/skill/SKILL.md

@@ -2,108 +2,112 @@
 
 适用于把一个选题整理成可发布到微信公众号的完整内容稿。
 
-当前版本专注 4 件事：
-
-1. 明确选题和读者视角
-2. 生成更像公众号风格的标题方向
-3. 写出 Markdown 正文
-4. 渲染成微信公众号可用的 HTML
-
-这不是一个“全自动发布器”。当前版本不负责：
-
+当前版本重点做 5 件事：
+1. 选题和标题方向整理
+2. 正文 Markdown 写作
+3. 微信预览 HTML 渲染
+4. 文章质量检查
+5. 可选上传到公众号草稿箱（需要用户主动提供凭据）
+
+默认不做：
 - 生图
-- 封面生成
-- 微信草稿箱发布
+- 封面图自动生成
+- 自动正式发布
 
-## 什么时候用
+默认不追加任何个人尾注信息。
 
-当用户要做这些事时使用：
+## 什么时候用
 
 - 写公众号文章
-- 把直播内容整理成公众号稿
-- 生成公众号标题
-- 输出微信公众号排版版式的 HTML
-- 检查文章是否适合公众号发布
+- 把直播内容整理成公众号稿件
+- 生成公众号标题候选
+- 输出可预览、可复制到后台的 HTML
+- 需要通过 API 上传到草稿箱
 
-## 推荐工作流
+## 推荐流程
 
-### 1. 先收集输入
+### 1. 收集输入
 
 至少确认这 4 个信息：
-
 - 文章主题
 - 目标读者
-- 读者当前最常见的问题
+- 读者当前最常见问题
 - 这篇文章承诺解决什么
 
-### 2. 先给标题方向
-
-优先输出 3 到 5 个标题，并解释它们分别适合：
-
-- 偏方法拆解
-- 偏观点判断
-- 偏案例复盘
+### 2. 先出标题方向
 
-标题规则见：
+输出 3 到 5 个标题，并说明适用场景。
 
-- `references/title-guidelines.md`
+### 3. 再写正文 Markdown
 
-### 3. 再写正文
+正文建议：
+- 4 到 6 个二级标题
+- 先给判断，再解释
+- 至少 1 个真实场景
+- 至少 1 个常见误区
+- 至少 1 组可执行动作
 
-正文默认要求：
+### 4. 渲染公众号 HTML（无尾注）
 
-- 使用 4 到 6 个二级标题
-- 先给判断，再展开解释
-- 至少包含 1 个真实场景
-- 至少包含 1 个常见误区
-- 至少包含 1 组可执行动作
-- 结尾自然引向下一篇或下一步动作
+```bash
+python scripts/render_wechat_html.py --input "<article.md>" --output "<article>.html"
+```
 
-写作约束见：
+### 5. 质量检查（可选）
 
-- `references/writing-rules.md`
+```bash
+python scripts/audit_article_quality.py --input "<article.md>"
+```
 
-### 4. 渲染 HTML
+### 6. 上传草稿箱（可选）
 
-正文 Markdown 完成后，运行：
+当用户明确需要上传草稿箱时，使用：
 
 ```bash
-python scripts/render_wechat_html.py --input "<article.md>" --output "<article>.html"
+python scripts/wechat_html_api_publish.py \
+  --markdown "<article.md>" \
+  --config "config/wechat-publish-api.example.json" \
+  --dry-run
 ```
 
-### 5. 做一次质量检查
+确认 dry-run 输出没问题后，再去掉 `--dry-run`。
 
-如果用户在意发布质量，再运行：
+也可以直接传入账号参数：
 
 ```bash
-python scripts/audit_article_quality.py --input "<article.md>"
+python scripts/wechat_html_api_publish.py \
+  --markdown "<article.md>" \
+  --appid "<appid>" \
+  --appsecret "<appsecret>" \
+  --author "<author>"
 ```
 
+## 安全约束
+
+- 不要把用户的 appid/appsecret 写死进脚本。
+- 不要把真实凭据提交到仓库。
+- 默认使用示例配置文件，用户自行填写本地私密配置。
+
 ## 目录说明
 
-- `references/title-guidelines.md`
-  标题风格和筛选规则
-- `references/writing-rules.md`
-  正文写作规则和结构要求
-- `assets/wechat-article-template.html`
-  微信 HTML 模板
-- `config/wechat-style-config.json`
-  样式配置
-- `scripts/render_wechat_html.py`
-  Markdown 转微信 HTML
-- `scripts/audit_article_quality.py`
-  质量检查脚本
+- `references/title-guidelines.md`：标题参考
+- `references/writing-rules.md`：正文写作规则
+- `assets/wechat-article-template.html`：公众号预览模板
+- `config/wechat-style-config.json`：样式配置
+- `config/wechat-publish-api.example.json`：草稿箱上传配置示例
+- `scripts/render_wechat_html.py`：Markdown 转公众号预览 HTML（无尾注）
+- `scripts/render_wechat_api_content.py`：Markdown 转 API 友好内容片段
+- `scripts/wechat_html_api_publish.py`：调用公众号接口创建草稿
+- `scripts/audit_article_quality.py`：质量检查
 
 ## 交付要求
 
 默认交付：
-
-- 3 到 5 个标题备选
+- 3 到 5 个标题候选
 - 1 篇 Markdown 正文
-- 1 个 HTML 文件
-
-如果脚本已经执行，还要明确告诉用户：
+- 1 个 HTML 预览文件
 
-- Markdown 文件路径
-- HTML 文件路径
-- 质量检查结果
+如果执行了草稿箱上传，还要明确返回：
+- 是否 dry-run
+- 草稿接口返回结果
+- 产物文件路径

package/bundled-skills/wechat-assistant/skill/config/wechat-publish-api.example.json

@@ -0,0 +1,6 @@
+{
+  "appid": "YOUR_WECHAT_APPID",
+  "appsecret": "YOUR_WECHAT_APPSECRET",
+  "author": "OpenSchool",
+  "content_source_url": ""
+}

package/bundled-skills/wechat-assistant/skill/scripts/render_wechat_api_content.py

@@ -0,0 +1,191 @@
+#!/usr/bin/env python3
+"""Render markdown into WeChat Official Account API-friendly HTML fragment."""
+
+from __future__ import annotations
+
+import argparse
+import html
+import re
+from pathlib import Path
+
+WECHAT_INLINE = {
+  "p": "margin:0 0 18px;line-height:1.85em;font-size:16px;color:#222;text-align:justify;word-break:break-word;",
+  "h2": "margin:30px 0 14px;line-height:1.75em;font-size:17px;font-weight:700;color:#0f6fff;",
+  "h3": "margin:22px 0 12px;line-height:1.75em;font-size:15px;font-weight:700;color:#0f6fff;",
+  "li": "margin:0 0 10px;line-height:1.85em;font-size:16px;color:#222;",
+  "blockquote": "margin:0 0 18px;padding:10px 14px;background:#f7faff;border-left:3px solid #0f6fff;color:#355070;line-height:1.85em;font-size:15px;",
+  "pre": "margin:0 0 18px;padding:12px 14px;background:#f7f8fa;border:0;border-left:3px solid rgba(15,111,255,.45);overflow-x:auto;",
+  "code": "font-size:14px;line-height:1.75em;color:#333;font-family:Consolas,Menlo,monospace;white-space:pre-wrap;",
+  "sep": "margin:22px 0 20px;text-align:center;color:#bbb;letter-spacing:1px;",
+  "cta": "margin-top:28px;padding-top:14px;border-top:1px solid #e6e6e6;",
+}
+
+
+def convert_inline(text: str) -> str:
+  text = html.escape(text)
+  text = re.sub(r"`([^`]+)`", r"<code style=\"%s\">\1</code>" % WECHAT_INLINE["code"], text)
+  text = re.sub(r"\*\*([^*]+)\*\*", r"<strong style=\"color:#0f6fff;font-weight:700;\">\1</strong>", text)
+  text = re.sub(r"\*([^*]+)\*", r"<em>\1</em>", text)
+  text = re.sub(r"\[([^\]]+)\]\(([^)]+)\)", r'<a href="\2">\1</a>', text)
+  return text
+
+
+def markdown_to_api_blocks(content: str):
+  lines = content.splitlines()
+  title = ""
+  blocks = []
+  in_code = False
+  code = []
+  para = []
+  quote = []
+  list_items: list[str] = []
+  list_kind = ""
+  has_cta = False
+
+  def flush_para():
+    nonlocal para, has_cta
+    if not para:
+      return
+    txt = re.sub(r"\s+", " ", " ".join(p.strip() for p in para if p.strip())).strip()
+    para = []
+    if not txt:
+      return
+    if any(k in txt for k in ["留言", "评论", "关键词", "下一篇", "下篇", "领取"]):
+      has_cta = True
+    blocks.append(f'<p style="{WECHAT_INLINE["p"]}">{convert_inline(txt)}</p>')
+
+  def flush_quote():
+    nonlocal quote
+    if not quote:
+      return
+    txt = re.sub(r"\s+", " ", " ".join(q.strip() for q in quote if q.strip())).strip()
+    quote = []
+    if not txt:
+      return
+    blocks.append(f'<blockquote style="{WECHAT_INLINE["blockquote"]}">{convert_inline(txt)}</blockquote>')
+
+  def flush_list():
+    nonlocal list_items, list_kind
+    if not list_items:
+      return
+    tag = "ol" if list_kind == "ol" else "ul"
+    items = "".join(f'<li style="{WECHAT_INLINE["li"]}">{convert_inline(item)}</li>' for item in list_items)
+    blocks.append(f"<{tag}>{items}</{tag}>")
+    list_items = []
+    list_kind = ""
+
+  for raw in lines:
+    s = raw.rstrip()
+    st = s.strip()
+    if st.startswith("```"):
+      flush_para()
+      flush_quote()
+      flush_list()
+      if in_code:
+        code_html = html.escape("\n".join(code))
+        blocks.append(f'<pre style="{WECHAT_INLINE["pre"]}"><code style="{WECHAT_INLINE["code"]}">{code_html}</code></pre>')
+        code = []
+        in_code = False
+      else:
+        in_code = True
+      continue
+
+    if in_code:
+      code.append(s)
+      continue
+
+    if not st:
+      flush_para()
+      flush_quote()
+      flush_list()
+      continue
+
+    if not title and st.startswith("# "):
+      flush_para()
+      flush_quote()
+      flush_list()
+      title = st[2:].strip()
+      continue
+
+    if st.startswith("## "):
+      flush_para()
+      flush_quote()
+      flush_list()
+      blocks.append(f'<h2 style="{WECHAT_INLINE["h2"]}">{convert_inline(st[3:])}</h2>')
+      continue
+
+    if st.startswith("### "):
+      flush_para()
+      flush_quote()
+      flush_list()
+      blocks.append(f'<h3 style="{WECHAT_INLINE["h3"]}">{convert_inline(st[4:])}</h3>')
+      continue
+
+    if st.startswith("> "):
+      flush_para()
+      flush_list()
+      quote.append(st[2:])
+      continue
+
+    if re.match(r"^\d+\.\s+", st):
+      flush_para()
+      flush_quote()
+      kind = "ol"
+      if list_kind and list_kind != kind:
+        flush_list()
+      list_kind = kind
+      list_items.append(re.sub(r"^\d+\.\s+", "", st))
+      continue
+
+    if re.match(r"^[-*]\s+", st):
+      flush_para()
+      flush_quote()
+      kind = "ul"
+      if list_kind and list_kind != kind:
+        flush_list()
+      list_kind = kind
+      list_items.append(re.sub(r"^[-*]\s+", "", st))
+      continue
+
+    if st == "---":
+      flush_para()
+      flush_quote()
+      flush_list()
+      blocks.append(f'<p style="{WECHAT_INLINE["sep"]}">———</p>')
+      continue
+
+    para.append(st)
+
+  flush_para()
+  flush_quote()
+  flush_list()
+  return title, "\n".join(blocks), has_cta
+
+
+def render_api_content(markdown: str, title_override: str = "") -> tuple[str, str, bool]:
+  title, body, has_cta = markdown_to_api_blocks(markdown)
+  title = title_override or title or "公众号文章"
+  cta = (
+    ""
+    if has_cta
+    else f'<section style="{WECHAT_INLINE["cta"]}"><p style="{WECHAT_INLINE["p"]}color:#355070;">如果这篇内容对你有帮助，欢迎留言关键词，我会继续补充相关资料。</p></section>'
+  )
+  return title, body + cta, has_cta
+
+
+def main() -> None:
+  parser = argparse.ArgumentParser()
+  parser.add_argument("--input", required=True)
+  parser.add_argument("--output", required=True)
+  parser.add_argument("--title", default="")
+  args = parser.parse_args()
+
+  markdown = Path(args.input).read_text(encoding="utf-8")
+  _, html_doc, _ = render_api_content(markdown, args.title)
+  out = Path(args.output)
+  out.parent.mkdir(parents=True, exist_ok=True)
+  out.write_text(html_doc, encoding="utf-8")
+
+
+if __name__ == "__main__":
+  main()