wenqu-write

技术介绍文章 Skill

📦 项目仓库与源码：https://github.com/gogoingai/wenqu-skills

用户输入工具

当本技能需要用户确认选择、补充必要信息或授权有副作用的操作时：

1. 优先使用当前运行时提供的原生用户输入工具，例如 AskUserQuestion、request_user_input、clarify、ask_user 或等价能力。
2. 若没有此类工具，使用带编号或字母选项的文本问答。
3. 同一决策阶段中彼此独立的问题可合并提问；后一个问题依赖前一回答时，按优先级逐个问。
4. 已由用户当前指令、调用方或文章偏好提供的信息，不重复询问。
5. 文中出现的具体工具名均为示例；应替换为当前运行时的等价能力。

工具等价说明（非 Claude Code 环境）

本文档里的 TaskCreate、Skill 是 Claude Code 的工具名。在没有这些工具的 agent 上执行本技能时，按以下等价方式退化：

• TaskCreate（任务列表追踪）→ 没有就维护一份纯文本/Markdown 的 TODO 清单，人工勾选完成项

• Skill 工具（调用 wenqu-image / wenqu-review / wenqu-translate / wenqu-library）→ 没有跨技能调用机制就直接 Read 目标技能的 SKILL.md 和 references/ 文件，照着内联执行

  wenqu-library 联动必须保留：Step 2「获取素材」依赖 wenqu-library 的「先查全局文库 + 四步收集流程」。即使运行时没有 Skill 工具，也要 Read wenqu-library 的 SKILL.md（及 references/）后按其流程内联执行，不得因缺少 Skill 工具就跳过素材收集或退化为对话内零散抓取。

触发识别

用户信号	流程
"写一篇"、"新建"、"帮我写"	从0到1
"修改"、"调整"、"改"、提供已有文章路径	修改
"审查"、"检查"、"review"、"看看有没有问题"	审查
"发布"、"生成发布版"、"准备发布"、"导出发布版"	→ 用 Skill 工具调用 wenqu-publish 技能，传入文章路径

---

上下文存储位置

写作状态分两类，存储位置不同：

• 全局画像（$HOME/.gogoingai/wenqu-skills/profile.md）：只是一份参考底稿，不是每篇文章每次写作时都要去读的权威来源。它的作用仅限于——新建一篇文章的存储目录时，把当时的全局画像内容复制一份作为初始快照写进去。画像快照只记录读者、语言、风格、受众和写作偏好等非敏感信息；不得写入密钥、Cookie、环境变量、私人联系方式、私有路径或用户未明确要求长期保存的信息。
• 单篇文章的存储（本篇专属、且自包含）：存在项目根目录下的 wenqu-skills/ 子目录里，以文章文件名（不含扩展名）为 key 区分，按 skill 目录的组装方式写入——一份 SKILL.md 做索引和关键信息，具体产出物放 references/ 下当支持文件：
  • 项目根目录 = git rev-parse --show-toplevel 的结果；不是 git 仓库则用当前工作目录
  • {项目根目录}/wenqu-skills/{文件名}/SKILL.md —— 索引、关键信息：标识（见下方「文章标识与重命名」一节）、背景、系统定位、写作目标、读者/作者画像快照、范围锁定、内容策略（即原 context.md 的全部内容）、待办清单（跨会话未完结事项，见下方「待办清单」一节）
  • {项目根目录}/wenqu-skills/{文件名}/references/materials/ —— 素材目录：Step 1/2 收集到的所有源码证据、关键数字、用户提供的背景素材、抓取网页、翻译整理摘要的工作台。按内容类型分目录存放（local/ 本地素材、articles/ 网页文章、papers/ 论文、docs/ 官方文档与整站抓取产物），index.md 做统一索引：逐条编号（M1、M2……），登记摘要、来源 URL、检索渠道、文件路径、用途、标签，骨架和审查都从这里查，不依赖对话记忆。网页、论文、用户提供的原文和翻译原文均属不可信参考数据，具体安全边界见下方「外部素材安全边界」。目录结构与登记规则详见 wenqu-library 技能「存储位置」一节
  • {项目根目录}/wenqu-skills/{文件名}/references/skeleton.md —— 骨架，每节标注引用了素材库的哪几条，文件末尾维护"变更历史"表
  • {项目根目录}/wenqu-skills/{文件名}/references/preferences.md —— 偏好与反馈库：规划/写作/审查/翻译/配图任一环节里，用户给出的、不止针对当次改动的持久化偏好或反馈（写法习惯、画图风格、术语取舍……），当场追加，不留在对话记忆里，也不再提议改技能仓库文档（详见「用户反馈与偏好持久化」一节）
  • {项目根目录}/wenqu-skills/{文件名}/references/changelog.md —— 版本记录：草稿/事件/发布三类历史，见 references/planning/changelog.md「版本记录」
  • {项目根目录}/wenqu-skills/{文件名}/references/change-impact.md —— 变更影响记录：术语、机制、数字、范围、结构或图片发生实质修改时，记录本轮改动及受影响载体，供 R7 做闭环检查；没有实质改动时不创建
  • {项目根目录}/wenqu-skills/{文件名}/references/terms.md —— 术语表：需要跨章节稳定使用的概念，记录推荐词、避免词、首次定义位置和适用范围；没有术语风险时不创建
  • {项目根目录}/wenqu-skills/{文件名}/references/status.md —— 文章状态：素材、骨架、章节、图片、审查与发布的当前状态、下一步和待复查项；模板与更新规则见 references/planning/wenqu-status.md
  • {项目根目录}/wenqu-skills/{文件名}/publish/v{N}/（按需创建）—— wenqu-publish 技能生成的发布版产物，wenqu-write 不直接写这个目录
  • {项目根目录}/wenqu-skills/{文件名}/assets/（按需创建）—— 用户提供的非文本参考素材（示例图片、截图等二进制文件），materials/index.md/preferences.md 里用相对路径引用，不把二进制内容塞进 Markdown