guage-write-flow
中文技术文章与公众号长文写作 Agent Skill:调研核验、选题、两阶段创作、多轮审校与 Markdown 交付;支持已有文章审校,保留作者声音。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 17 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/guage1029/guage-write-flow with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/guage1029/guage-write-flow'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/guage1029--guage-write-flow)HTML
<a href="/listings/guage1029--guage-write-flow"><img src="/api/listings/guage1029--guage-write-flow/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
需要 Bash、Python 3.9+ 和 rsync;打包另需 zip/unzip。Python 校验脚本仅使用标准库,`quick_validate.py` 有 PyYAML 时会使用它解析 frontmatter。
git clone https://github.com/guage1029/guage-write-flow.git cd guage-write-flow # 选择一种安装目标;workspace 可以使用已有稿件目录 bash scripts/install.sh --tool codex --workspace ~/Documents/workspace/writing # bash scripts/install.sh --tool claude-code --workspace ~/Documents/workspace/writing # bash scripts/install.sh --tool hermes --workspace ~/Documents/workspace/writing # bash scripts/install.sh --tool custom --skills-dir ~/.your-agent/skills --workspace ~/Documents/workspace/writing # 不传参数时使用交互式安装向导;--tool auto 可检测已安装工具 # bash scripts/install.sh
Skill 安装到目标 Skills 目录下的 `guage-write-flow/`。安装目录存放指令与脚本,工作区独立存放输入材料和成品文章。
安装时工作区选择顺序:`--workspace` → `GUAGE_WRITE_FLOW_WORKSPACE` → 旧变量 `AI_WRITE_FLOW_WORKSPACE` → 交互询问。环境变量用于安装时选择目录;安装脚本将绝对路径绑定到安装副本的 `references/workspace-config.md`、预检脚本和保存脚本。
运行时读取安装副本的工作区配置;用户在任务中明确指定的路径优先。另选工作区时,保存命令应传 `--output-dir <工作区>/output`,与预检使用同一目录。直接使用未安装的源码时,默认工作区为 `~/Documents/workspace/guage-write-flow`。
从 ai-write-flow 更新
项目和安装目录现在统一命名为 `guage-write-flow`。已有 Git 检出可更新远端地址:
git remote set-url origin https://github.com/guage1029/guage-write-flow.git
重新安装时可继续传原有 workspace 路径,例如 `~/Documents/workspace/ai-write-flow`,无需移动素材或文章。脚本不会自动删除旧的 `ai-write-flow` 安装目录;确认新版本可用后,自行停用旧 skill,避免同名能力重复匹配。覆盖已有 `guage-write-flow` 安装前会询问;覆盖会同步分发包并清除已移除的规则文件,请先备份个人定制。
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 148 lines
- # guage-write-flow
- 
- 中文技术文章和公众号长文写作 Agent Skill。提供调研、选题、两阶段创作、多轮审校和 Markdown 交付,也支持直接审校已有文章、降低 AI 味。
- **职责边界:** 不提供图卡分卡文案、配图策划、图片生成或生成图片的回填。用户已有的截图仍可作为素材或证据读取、核验和引用。配图是独立任务,不影响文章流程单独完成。
- 遵循 [Agent Skills 开放标准](https://agentskills.io/specification)。安装脚本支持 Hermes、Claude Code、Codex,以及通过 `--tool custom --skills-dir` 指定的其他 Agent Skills 目录。
- ## 安装
- 需要 Bash、Python 3.9+ 和 rsync;打包另需 zip/unzip。Python 校验脚本仅使用标准库,`quick_validate.py` 有 PyYAML 时会使用它解析 frontmatter。
- ```bash
- git clone https://github.com/guage1029/guage-write-flow.git
- cd guage-write-flow
- # 选择一种安装目标;workspace 可以使用已有稿件目录
- bash scripts/install.sh --tool codex --workspace ~/Documents/workspace/writing
- # bash scripts/install.sh --tool claude-code --workspace ~/Documents/workspace/writing
- # bash scripts/install.sh --tool hermes --workspace ~/Documents/workspace/writing
- # bash scripts/install.sh --tool custom --skills-dir ~/.your-agent/skills --workspace ~/Documents/workspace/writing
- # 不传参数时使用交互式安装向导;--tool auto 可检测已安装工具
- # bash scripts/install.sh
- ```
- Skill 安装到目标 Skills 目录下的 `guage-write-flow/`。安装目录存放指令与脚本,工作区独立存放输入材料和成品文章。
- 安装时工作区选择顺序:`--workspace` → `GUAGE_WRITE_FLOW_WORKSPACE` → 旧变量 `AI_WRITE_FLOW_WORKSPACE` → 交互询问。环境变量用于安装时选择目录;安装脚本将绝对路径绑定到安装副本的 `references/workspace-config.md`、预检脚本和保存脚本。
- 运行时读取安装副本的工作区配置;用户在任务中明确指定的路径优先。另选工作区时,保存命令应传 `--output-dir <工作区>/output`,与预检使用同一目录。直接使用未安装的源码时,默认工作区为 `~/Documents/workspace/guage-write-flow`。
- ### 从 ai-write-flow 更新
- 项目和安装目录现在统一命名为 `guage-write-flow`。已有 Git 检出可更新远端地址:
- ```bash
- git remote set-url origin https://github.com/guage1029/guage-write-flow.git
- ```
- 重新安装时可继续传原有 workspace 路径,例如 `~/Documents/workspace/ai-write-flow`,无需移动素材或文章。脚本不会自动删除旧的 `ai-write-flow` 安装目录;确认新版本可用后,自行停用旧 skill,避免同名能力重复匹配。覆盖已有 `guage-write-flow` 安装前会询问;覆盖会同步分发包并清除已移除的规则文件,请先备份个人定制。
- ## 使用
- 完整写作:
- ```text
- 使用 guage-write-flow,帮我写一篇关于 MCP 工具开发的文章。
- ```
- 已有文章审校:
- ```text
- 帮我审校这篇文章,降低 AI 味,保留我的表达和已有截图。
- ```
- 只检查:
- ```text
- 只检查这篇文章的问题,先别改正文。
- ```
- 审校快捷入口跳过 Steps 1–4,直接进入 Step 5。局部润色只报告结构或证据缺口,不擅自扩写、追加事实或重做选题;只检查时不输出修订全文、不落盘。
- ## 必做的风格审校与手册迭代
- 初稿、语气改写、全文复查是三个独立阶段。新写长文按当前 `style-guide.md` 逐段打磨:有多少问题就处理多少,直到全部问题解决,不按“至少改 3–5 处”、改写比例或迭代轮数过关。已有文章仍按用户范围保护原作者声音。
- 每次执行都复盘风格手册;在用户已授权持续维护的环境中,根据用户明确反馈、亲自修改或确认的样文修订规则。无新依据时保持规则并报告复盘结论,不把 Agent 自评或骨架确认当成瓜哥的风格偏好。具体规则集中在 `style-guide.md`,身份背景保留在 `persona.md`。
- 交付前需有真实初稿及已完成的审校记录,覆盖终稿全部 Markdown 块、六项口吻证据、全部问题处理和手册复盘,并绑定初稿、终稿及当前规则哈希。模板默认全部待审。`save_article.py` 不再接受只有正文的调用;缺记录、待审、漏项、未解决问题或哈希过期均拒绝保存。只在对话交付终稿也要核验同一记录。
- `check_article.py` 的成功输出是“机械检查通过”,不是风格认证。记录校验只能验证覆盖与一致性,不能证明 Agent 的语义判断真实或文章已经像瓜哥;不得批量填通过或绕过入口直接写文件。
- 执行步骤、临时文件清理与记录字段见 [风格审校契约](skill/references/style-review.md)。
- ## 长文主流程
- | 步骤 | 行为 | 进入下一步的条件 |
- |---|---|---|
- | Step 1 工作区与素材 | 盘点文件、读取内容、判断本轮相关性并保留哈希,生成 preflight | 清单完整,读取与相关性缺口已处理 |
- | Step 2 调研核验 | 核查来源原文、可用事实、排除项和差异,运行 JSON 校验 | 校验通过,未解决差异不得放行 |
- | Step 3 选题 | 给出选题、标题、证据要求和工作量 | 用户选定选题与工作标题 |
- | Step 4 两阶段创作 | 先确认骨架和三份清单,再写正文 | 骨架获确认;三份清单齐全 |
- | Step 5 多轮审校 | R1–R5、独立逐段语气改写、全文复查、手册复盘、作者手迹与格式检查 | 全部问题处理、六项口吻及全文覆盖完成 |
- | Step 6 交付 | 默认保存 Markdown,报告绝对路径 | strict 校验通过并写入成功 |
- 调研按**本轮素材的相关性和可读性**选择模式:有相关可读素材用 `brief_first_verify_mode`,没有则用 `publish_mode`;共享目录非空不代表材料与本轮相关。读取失败或相关性待确认时先解决缺口。旧研究 JSON 重新使用前仍须补预检、检查来源与时效。
- 骨架阶段必须包含【读者兑现映射表】【证据账单】【自设参数清单】。R1–R4 覆盖冷启动、标题承诺、证据使用和自设参数披露,完整稿不通过时返工;R5 检查结尾是否提供新信息。
- 实测、接入和评测文章需要真实产物证据。明确为 `source-analysis` 的资料解析需要真实来源数据表和正文 HTTP(S) 来源链接,不能冒充作者亲测。检查脚本只能识别已编码的结构、格式和证据形式,不能证明图片真实、来源可靠或文章已经接近作者口吻。
- ## 输出与个人定制
- - 完整长文默认保存到 `<workspace>/output/YYYYMMDD-title-slug.md`,日期使用 Asia/Shanghai;重名追加序号,禁止覆盖。
- - 用户要求只在对话中交付时不保存。审校结果、骨架和研究 JSON 默认留在对话中,明确要求保存时才写文件。
- - 审校报告不写入最终文章文件。运行产物不得写入 skill 安装目录。
- - 新文章默认参考瓜哥的作者画像;安装后可修改 `references/persona.md`。已有文章优先保留原作者声音。
- - 调整工作区时重新运行安装脚本,以同步规则与脚本默认路径。
- ## 仓库结构
- ```text
- guage-write-flow/
- ├── skill/ # 可分发的 skill,安装时只复制此目录
- │ ├── SKILL.md
- │ ├── references/ # 事实、调研、作者声音、审校及工作区规范
- │ ├── assets/brief-template.md
- │ └── scripts/ # prepare_research、validate_research、review_style、check_article、save_article 及测试
- ├── scripts/ # 安装、打包与分发自检
- ├── evals/ # 行为用例定义与脚本场景校验
- ├── docs/open-source-guide.md
- ├── quick_validate.py # 分发包基础结构检查
- └── LICENSE
- ```
- ## 验证与打包
- ```bash
- python3 quick_validate.py
- PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s skill/scripts -p 'test_*.py' -v
- PYTHONDONTWRITEBYTECODE=1 python3 scripts/test_distribution.py
- PYTHONDONTWRITEBYTECODE=1 python3 evals/run_evals.py
- bash scripts/package-skill.sh dist 0.0.8
- ```
- `evals/run_evals.py` 校验用例结构、文件引用并执行脚本场景;**不会实际运行 Agent 多轮对话**。行为场景需要在独立会话中验收,不能将用例定义检查通过当成行为测试通过。
- 调研 JSON、文章检查均支持 stdin,例如:
- ```bash
- python3 skill/scripts/validate_research.py - --report < research.json
- python3 skill/scripts/check_article.py - --strict --article-type source-analysis < article.md
- # 改写并全文复查后生成待填写记录,模板自身不能通过门禁
- python3 skill/scripts/review_style.py --draft /tmp/draft.md --final /tmp/final.md > /tmp/review.json
- # 按风格审校契约实际完成全部检查,再填写 review.json
- python3 skill/scripts/check_article.py /tmp/final.md --strict --article-type source-analysis --draft /tmp/draft.md --review /tmp/review.json
- python3 skill/scripts/save_article.py --article-type source-analysis --output-dir /your/workspace/output --draft /tmp/draft.md --review /tmp/review.json < /tmp/final.md
- ```
- 不要提交个人素材、运行产物、密钥或凭据;默认作者画像可按需调整,测试素材中的数字和产品表述不能当作发布事实。
- ## 许可证
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.