aiworkskills/wechat-article-skills / skills/aws-wechat-article-main
aws-wechat-article-main
Verified公众号运营|微信公众号|公众号一条龙|公众号全流程|自媒体运营|wechat automation|content pipeline|AIGC workflow — 公众号一条龙运营总控入口,选题→写稿→审稿→排版→配图→发布串联 8 个子 skill,单条指令完成整篇图文从 0 到上架。面向公众号小编、自媒体、品牌内容。触发词分层:**一条龙流程**「一条龙」「完整流程」「从头做」「从 0 到发布」;**新做新发**「帮我写篇公众号文章」「做一篇公众号文章」「我想发一篇」「帮我发一篇」「再来一篇」;**选题起点**「今天写什么好」「有什么好写的」「找个话题」「爆款选题」「热点选题」「起个爆款标题」;**策划起点**「内容日历」「系列策划」「专栏规划」「连载」;**流程恢复**「接着上次那篇」「继续昨天的」「继续上次的」「接着之前的进度」;**显式模型新写**「用 GPT 写一篇」「用 DeepSeek 写一篇」「把提纲写成文章」。子 skill(topics/writing/review/formatting/images/publish/sticker/assets)单独触发仅限对**已有产物**的修改场景(如"改标题""润色这段""排版""审稿""加封面""发布");新做/策划/多环节串联一律走本入口。
references/first-time-setup.md
View on GitHub# 首次引导 ⛔ BLOCKING
任何操作执行前,必须执行以下 **「检测顺序」** 中的检查步骤。
---
一条龙 / 总览流水线:**先具备仓库根 `aws.env`、`.aws-article/config.yaml`,并通过 `validate_env.py`**,再按总览 [SKILL.md](../SKILL.md) 交互顺序完成 **「2) 全局账号约束」**:**`article_category` / `target_reader` / `default_author` 须由用户确认后再写入** `config.yaml`(**禁止**从某篇 `article.yaml` 擅自抄录),再进入 **「3) 本篇准备」**。
总览规则见 [SKILL.md](../SKILL.md)「配置检查」。
---
## 检测顺序(智能体先判断 OS)
- **Linux / macOS**:下文用 Bash。
- **Windows**:下文用 PowerShell。
下文命令中的 `{python}` 是**占位符**,须先探测出本机可用的 Python 3 解释器再代入(每次会话探测一次):
- **Linux / macOS**:`python3 --version` 输出 `Python 3.x.x` → `{python}` = `python3`;不存在则试 `python --version`。
- **Windows**:`py -3 --version` 输出 `Python 3.x.x` → `{python}` = `py -3 -X utf8`;`py` 不可用则试 `python --version`,通过则用 `python -X utf8`。
⛔ **Windows 上不要探测 `python3`**——未安装 Python 时它是系统预置的应用执行别名,会静默打开 Microsoft Store 而不报错。`-X utf8` 也不可省略,否则脚本的中文输出在简体中文机器上会以 GBK 编码吐出,读到的是乱码。
要求 **Python 3.10+**;版本更低时先提示用户升级。详见 [SKILL.md 第 0 步](../SKILL.md)。
### 1)`.aws-article/config.yaml` 与 `aws.env` 是否存在(仓库根)
```bash
test -f .aws-article/config.yaml && test -f aws.env && echo ok || echo missing
```
```powershell
if ((Test-Path -LiteralPath ".aws-article\config.yaml") -and (Test-Path -LiteralPath "aws.env")) { "ok" } else { "missing" }
```
⛔ 若为 `missing`,按示例各建一份即可:
1. **`.aws-article/config.yaml`**:复制 **`skills/aws-wechat-article-main/references/config.example.yaml`** 为 **`.aws-article/config.yaml`**。
2. **`aws.env`**:复制 **`skills/aws-wechat-article-main/references/env.example.yaml`** 为仓库根 **`aws.env`**(内容格式为 `KEY=value`)。
**初始化约束**:新建 **`.aws-article/config.yaml`** 时,**`publish_method` 必须初始化为 `draft`**;除非用户明确指定「不接微信/不走上传」,否则禁止初始化为 `none`。
上述两个文件都创建并保存后,在仓库根运行 **`validate_env.py`**(见下节)。
### 2)`validate_env.py`
在**仓库根**执行:
```bash
{python} skills/aws-wechat-article-main/scripts/validate_env.py
```
(默认读取 **`.aws-article/config.yaml`** 与 **`aws.env`**;可用 `--config`、`--env` 指定路径。)
**脚本运行结果**
- **成功(退出码 0)**:输出 **`True`**、**`配置校验通过`**。写作模型、图片模型或 `wechat_N_name` 未配置时会附带警告,但不影响退出码。
- **失败(退出码 1)**:先输出 **`failed`**,再输出微信必要配置的实际缺失项。
#### 校验失败时的配置引导(必须严格执行)
`validate_env.py` 会完成全部检查后统一输出结果。**当退出码为 1** 时,按实际失败项说明:
环境检查结果:公众号必要配置不完整
1. **必填项**:`wechat_accounts`、`wechat_api_base`,以及每个槽位的 `WECHAT_N_APPID` / `WECHAT_N_APPSECRET`。
2. **配置方式(二选一,**不要把密钥粘贴到聊天里**)**:
- **方式 A(推荐)**:在仓库根用编辑器打开 **`aws.env`** 填入 `WECHAT_1_APPID` / `WECHAT_1_APPSECRET` 等,并在 **`.aws-article/config.yaml`** 填入 `wechat_accounts` / `wechat_api_base` 等非密钥项,保存后告诉我「已填好」我来复检。
- **方式 B**:前往平台 **`https://aiworkskills.cn/`** 在网页上配。
**原则**:Agent **不向用户索取密钥**、**不代替用户粘贴密钥到文件**。密钥只由用户在本地编辑器中写入 `aws.env`;validate_env 只做非空校验,不读值外发。
**额外操作**:若用户明确表示不配置微信账号,可将 **`config.yaml`** 中 **`publish_method`** 设为 **`none`**,重跑后跳过微信组校验。写作和图片模型均为可选项。
**⛔ 配置与写稿分两阶段(必须遵守)**
- **`validate_env.py` 退出码 1** 时:**本轮只谈环境配置**——按当前失败分支展示 **环境检查结果 + 三条 + 额外操作** 即可,**结束在该主题**;**禁止**在同一条回复(或同一轮未闭环配置前)里再接:写哪篇文章、是否继续某篇草稿、`drafts/` 路径、选题、定题、`topic-card`、审稿、排版等**任何写稿向流程**。
- **`validate_env.py` 退出码 0(含可选项警告)** 时:流程**不阻断**,可直接进入下一阶段。
- **下一阶段**:用户按上文配置引导完成落盘并重跑校验至 **退出码 0** 后,先完成总览 **「2) 全局账号约束」**,再进入 **「3) 本篇准备」**、写稿等。
- **在不了解用户是要续写旧稿还是新开一篇时**(含刚闭环配置后接写稿):须按总览 **「3) 本篇准备」** 开头规则**先问再动**,**禁止**直接假定某一 `drafts/…` 目录并调用写作脚本。
---
## `validate_env.py` 在做什么(摘要)
| 组别 | `config.yaml` | `aws.env` | 缺失时行为 |
|------|----------------|-----------|------------|
| 微信公众号 | `wechat_accounts`(≥1)、`wechat_api_base` | `WECHAT_{i}_APPID`、`WECHAT_{i}_APPSECRET` | **阻断**:`failed` + 退出码 1 |
| 公众号展示名 | `wechat_{i}_name` | — | **警告**,不阻断 |
| 写作模型 | `writing_model.base_url`、`model`(`provider` 可选) | `WRITING_MODEL_API_KEY` | **警告**,不阻断 |
| 图片模型 | `image_model.base_url`、`model`(`provider` 可选) | `IMAGE_MODEL_API_KEY` | **警告**,不阻断 |
模型与公众号展示名均为可选项。微信槽位与 AppID/AppSecret 保持原有必填规则;`publish_method: none` 时保持原有的跳过微信组逻辑。
---
## 阻断规则
⛔ **缺少 `.aws-article/config.yaml` 或 `aws.env`**,或 **`validate_env.py` 退出码 1**(微信必要配置不完整):
- 禁止进入一条龙默认流水线(除非先设 **`publish_method: none`** 并重跑校验通过)。
- 禁止宣称环境已就绪或一条龙已完成。
写作/图片模型或 `wechat_N_name` 缺失只产生警告,不触发阻断。
---
## 引导流程(简版)
### 第 1 步:说明可选策略
- **环境与密钥**:写作/生图的 **URL 与模型名**在 **`config.yaml`**,**API Key** 在 **`aws.env`**;微信 **AppID/AppSecret** 在 **`aws.env`**,槽位展示名与 **`wechat_api_base`** 等在 **`config.yaml`**。
- **`validate_env.py` 退出码 0** 表示微信必要配置已通过,或已通过 **`publish_method: none`** 跳过微信组;写作/图片模型或展示名可带警告通过。发布前建议再运行 **`check-wechat-env`**。
### 第 2 步:检查通过以后检查并创建预设目录(这个必须执行)
通过环境检查后,必须先判断以下目录是否存在;**不存在就立即创建**:
- `.aws-article/presets/structures`
- `.aws-article/presets/closing-blocks`
- `.aws-article/presets/title-styles`
- `.aws-article/presets/formatting`
- `.aws-article/presets/cover-styles`
- `.aws-article/presets/image-styles`
- `.aws-article/presets/sticker-styles`
- `.aws-article/tmp`
> **业务资料库 `.aws-article/products/{产品名}/`**:**不在首次引导创建**——产品名由用户在写第一份业务介绍时决定,AI 用 Write 工具落库时同时 `mkdir -p` 包括 `images/`,详见 [assets skill 一、业务介绍 .md 入库](../../aws-wechat-article-assets/SKILL.md#一业务介绍-md-入库)。
可按操作系统执行:
```bash
# Linux / macOS
mkdir -p .aws-article/presets/structures .aws-article/presets/closing-blocks \
.aws-article/presets/title-styles .aws-article/presets/formatting \
.aws-article/presets/cover-styles .aws-article/presets/image-styles \
.aws-article/presets/sticker-styles \
.aws-article/tmp
```
```powershell
# Windows PowerShell
$dirs = @(
".aws-article/presets/structures",
".aws-article/presets/closing-blocks",
".aws-article/presets/title-styles",
".aws-article/presets/formatting",
".aws-article/presets/cover-styles",
".aws-article/presets/image-styles",
".aws-article/presets/sticker-styles",
".aws-article/tmp"
)
foreach ($d in $dirs) {
if (-not (Test-Path -LiteralPath $d)) {
New-Item -ItemType Directory -Path $d -Force | Out-Null
}
}
```
### 第 3 步:全局 vs 本篇文件
| 文件 | 时机 | 说明 |
|------|------|------|
| **`aws.env`** | 首次 / 改密钥时 | 仓库根;写作/图片 API Key、微信 AppID/AppSecret 等|
| **`.aws-article/config.yaml`** | 首次 / 改账号策略时 | 文风、模型 endpoint、微信槽位元数据、**`publish_method`** 等 |
| **`article.yaml`** | 每篇、临近发布 | 本篇标题/作者/摘要/封面等;内含 **`publish_completed`**(新建为 **`false`**,发布闭环结束后再改为 **`true`**,便于发布流程分流);可用 `skills/aws-wechat-article-publish/scripts/article_init.py` |
首次引导**不**创建某篇目录,只保证 **`config.yaml` + `aws.env` 存在**,且 **`validate_env.py` 退出码 0**(微信必要配置完整,或 **`publish_method: none`**;可选项可带警告通过)。
### 第 4 步:确认并继续
摘要提示用户(勿打印完整密钥):
- **`validate_env.py` 退出码 0**:环境检测通过,可按总览进入流水线。**要走 `publish.py`(非 none)** 前建议 **`check-wechat-env`**。
可提示:写作规范可复制 **`skills/aws-wechat-article-main/references/writing-spec.example.md`** → **`.aws-article/writing-spec.md`**;预设见 **`.aws-article/presets/`**。
---
## 非首次运行
**每次**进入一条龙、或**仅**触发写作 / 配图 / 发布检查前,都须在仓库根执行:
```bash
{python} skills/aws-wechat-article-main/scripts/validate_env.py
```
**智能体**:若退出码非 0,根据终端 **`failed`** 下列出的汇总句,按上文 **「校验失败时的配置引导」** 文案**原样输出**(含三条配置引导 + **额外操作**);用户补全并落盘后重跑 **`validate_env.py`**。若用户**明确声明本次例外**,按总览 [SKILL.md](../SKILL.md)「智能体行为约束」处理。**禁止**未获补全或明确例外确认就宣称已通过环境校验或一条龙已完成。**禁止**因「上次已通过」而跳过本节命令。
---
## 每次发文目录与顺序(摘要)
- 目录:`drafts/YYYYMMDD-标题slug/`(`drafts_root` 以 **`config.yaml`** 为准时从其读取,否则默认 `drafts/`)。
- 建议内含:`draft.md`、`article.md`、`article.html`、`article.yaml`、`imgs/`、`out/` 等(按需生成)。
- 流程:定题 → 选题 → 写稿 → 审 → 排版 → 配图 → 终审 → **按需发布**:**`draft`** / **`published`** / **`none`** 见 schema;**`none`** 时 **`full`** 直接跳过;**`draft`/`published`** 须微信就绪(**`check-wechat-env`**)。
本篇 **`article.yaml`** 必填项:`title`、`author`、`digest`、`content_source`(默认 `article.html`)、**`publish_completed`**(新建 **`false`**,发布成功后再改为 **`true`**);**`cover_image`** 强烈建议填写。
---
## 智能体行为约束(禁止自作主张)
检测到 **`.aws-article/config.yaml` 或 `aws.env` 缺失**、**`validate_env.py` 退出码 1**(微信配置不完整,且未声明 **`publish_method: none`**),或用户**已要求调用 `publish.py`** 而微信槽位 / 凭证未就绪时:
- **禁止**在未询问用户、未取得用户**明确文字确认**的情况下,自行决定:跳过微信配置、仅出 prompt 却继续宣称「一条龙已完成」、或继续排版/发布并假装配置已就绪。
- **必须先**:向用户说明**具体缺哪一类**(脚本 **`failed`** 下的 **`微信公众号配置不完整`**;或即将 **`publish.py`** 但微信未配齐),并**统一按** [首次引导](references/first-time-setup.md) 中「校验失败时的配置引导」文案执行。
- **输出约束**:该场景下除”环境检查结果”可按实际失败项替换外,其余引导文案须与首次引导保持一致。
- 用户在本地编辑器中填好 `aws.env` 与 `config.yaml` 并保存后,智能体协助重跑 **`validate_env.py`** 复检;若用户明确声明本次例外,按首次引导与本节约束继续处理。
- **凭证处理原则**:Agent **不得索取、不得接收**用户在对话里粘贴的 `APPSECRET` / `API_KEY` 等任何密钥;所有密钥由用户自己在编辑器里写入 `aws.env`(或通过 `https://aiworkskills.cn/` 平台配置)。Agent 只校验存在性、不读取值、不外发值。
> **模型配置是可选项**:默认校验不因写作/图片模型缺失而阻断。进入对应阶段时,有外部 API 配置则可由脚本调用;没有时,写作由 Agent 根据 `write.py prompt` 执行,配图则根据当前 Agent 能力执行或再向用户说明。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |