shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 其它需要 API Key

Own-style-writer

|Own Style Writer 是一个“按你的参考文风写作”的 Agent Skill。它会把要学习文风的材料和本次写作用的内容素材分开处理：前者决定文章怎么写，后者决定文章写什么。

person作者: user_4195c5bahubcommunity
download下载资源包

Own Style Writer

Own Style Writer 是一个“学习指定文章风格，再按本次素材写作”的 skill。它不内置固定作者人格、固定口癖或默认语料。每次写作都必须以用户当次提供的风格素材为最高文风依据。

Inspired by khazix-writer, but contains no khazix-writer persona, corpus, prompts, or runtime dependency.

First Ask

触发后先问清楚，不要把“风格素材”和“写作素材”混为一谈：

  1. 哪一个目录是要学习文风的？
  2. 哪些文件、目录、链接、粘贴内容或口述信息是本次写作用的素材？
  3. 本次写作需求是什么：主题、目标读者、篇幅、输出语言、观点倾向、是否先给大纲？
  4. 是否允许把本地文档上传到 MinerU 做高质量解析？
  5. 是否已经设置 MINERU_API_KEY？

如果用户没有 MinerU key，提示：

如果你想使用 MinerU 精准解析，需要先获取 API Key：
https://mineru.net/apiManage/docs

没有 key 也可以继续：
1. 尝试 MinerU 轻量解析 API，适合 10MB / 20 页以内文件，受 IP 限频影响；
2. 或使用内置 MarkItDown 做本地离线转换。

User Inputs

  • 风格素材目录：最好是一个文件夹，里面放用户想模仿文风的文章、PDF、Word、Markdown 等。只用于学习结构、节奏、语气、段落密度、开头结尾方式和表达禁忌。
  • 写作素材：可以是另一个文件夹、单个文件、链接、粘贴文本或用户口述需求。只用于事实、案例、数据、观点和背景信息，不自动学习其文风。
  • 写作需求：说明本次要写什么、写给谁、想多长、用什么语言、要不要保留某些观点或限制。

写作素材不参与文风学习，除非用户明确说“也参考这些素材的风格”。

Conversion

优先转换策略：

  1. 用户允许上传且设置了 MINERU_API_KEY：使用 MinerU 精准解析 API，默认模型 vlm，可用 MINERU_MODEL_VERSION 覆盖。
  2. 用户允许上传但没有 key：尝试 MinerU 轻量解析 API，只适合 10MB / 20 页以内文件，受 IP 限频影响。
  3. 用户不允许上传，或 MinerU 失败、超限、限频：使用内置 MarkItDown 本地离线转换。

转换入口：

powershell -ExecutionPolicy Bypass -File scripts/run_prepare_workspace.ps1 `
  -StyleDir "D:\writing\my-style-samples" `
  -ContentDir "D:\writing\topic-materials" `
  -OutputDir "D:\writing\workspace\.own-style-writer" `
  -Recursive

允许上传到 MinerU 时增加：

-AllowUpload

macOS/Linux/WSL：

scripts/run_prepare_workspace.sh "/path/to/style-samples" "/path/to/topic-materials" --recursive --allow-upload

也可直接运行 Python：

python3 scripts/prepare_writing_workspace.py \
  --style-dir "/path/to/style-samples" \
  --content-dir "/path/to/topic-materials" \
  --output-dir "/path/to/output/.own-style-writer" \
  --converter auto \
  --recursive

Outputs

转换脚本保留可复查产物：

  • style/converted/*.md
  • style/corpus.md
  • content/converted/*.md
  • content/corpus.md
  • style_corpus.md
  • content_corpus.md
  • manifest.json
  • conversion_errors.json

manifest.json 每条记录包含 role、source、output、status、extension、bytes、characters、converter、converter_mode、error。

后续由 Agent 生成：

  • style_profile.md：只从 style/corpus.md 提炼文风。
  • content_brief.md：只从 content/corpus.md 和用户粘贴/口述内容提炼事实素材。
  • outline_review.md：结合文风画像和写作素材生成待确认大纲。
  • draft.md：用户确认大纲后才生成。
  • quality_report.md：检查文风贴合、素材使用和事实风险。

Workflow

  1. 确认风格素材、写作素材、写作需求、MinerU 上传许可和 key 状态。
  2. 运行转换脚本，保留所有中间产物。
  3. 阅读 manifest.json，确认转换成功率和失败项。
  4. 阅读 style/corpus.md，参考 references/style_profile_template.md 生成 style_profile.md。
  5. 阅读 content/corpus.md，参考 references/content_brief_template.md 生成 content_brief.md。
  6. 阅读 references/writing_principles.md，把通用章法原则翻译成当前题材可用的结构建议。
  7. 参考 references/outline_review_template.md 生成 outline_review.md，展示给用户确认。
  8. 用户确认后，再根据 style_profile.md、content_brief.md 和已确认大纲写 draft.md。
  9. 参考 references/quality_check_template.md 生成 quality_report.md。

默认停在大纲确认阶段，不要第一轮直接写完整正文，除非用户明确说“跳过大纲确认，直接写”。

General Writing Principles

无论参考风格是什么，写作时都要保留基本章法和逻辑底线。生成 outline_review.md 前阅读 references/writing_principles.md，并检查：

  • 标题是否准确、精练、醒目，能反映主题和核心判断。
  • 开头是否开门见山，尽快交代基本意图或核心问题。
  • 正文是否内容充实、层次清楚，围绕主题分段展开。
  • 结尾是否干净利索，有方向性、结论性、建议性、鼓励性或希望性。
  • 全文是否前后照应，详略得当，概念统一，重点突出。
  • 文风是否做到短、新、实、特：简短、有新意、具体实在、有辨识度。

这些原则是写作质量建议，不是固定文风。不要把所有文章写成机关文稿；要把原则转译为当前题材、用户需求和风格语料适用的表达方式。如果风格语料故意采用特殊结构，优先尊重用户风格，同时在大纲或质检里提示它可能带来的结构风险。

Style Extraction

提炼文风时不要只总结主题内容，要写成可执行约束。重点观察：

  • 开头如何启动：叙事、判断、问题、场景、金句、新闻事实，还是直接抛结论。
  • 文章结构：线性推进、分节论证、清单式、故事弧、评论式、研究式、问答式。
  • 段落密度：长段还是短段，单句成段是否高频。
  • 句式节奏：长短句比例、停顿方式、转折方式、是否爱用反问。
  • 论证方式：案例、数据、经验、类比、引用、复盘、情绪判断。
  • 视角和姿态：旁观者、亲历者、导师、朋友、研究员、评论员、交易员、编辑部口吻。
  • 用词习惯：高频词、口头禅、行业术语、情绪词、连接词。
  • 格式习惯：标题层级、编号、加粗、引用、表格、括号、标点。
  • 禁忌：参考文章明显不用或很少用的表达方式。
  • 结尾方式：回扣开头、给判断、留悬念、行动建议、风险提示、情绪收束。

不要写“语言生动”这种泛泛评价；要写“每个核心判断后通常跟一个短句解释，并用口语转折把节奏拉回来”这类可执行规则。

Drafting Rules

写正文时严格依据 style_profile.md、content_brief.md 和已确认的 outline_review.md：

  • 不套用任何固定作者人格。
  • 不继承旧 skill 的固定口癖、固定尾巴或固定价值观。
  • 不把写作素材的风格误当成目标文风。
  • 不编造第一手经历、数据、引用或具体事实。
  • 用户没有提供的信息，用“需要补充”或保守表达处理。
  • 如果素材涉及财经、医疗、法律等高风险领域，避免给出确定性操作指令，并提醒用户核验关键事实。
  • 如果用户要求直接发布稿，仍要附简短 quality_report.md，说明哪些风格特征已对齐、哪些事实仍需人工确认。

Runtime Notes

MinerU 精准解析需要 MINERU_API_KEY。设置示例：

$env:MINERU_API_KEY="你的key"
[Environment]::SetEnvironmentVariable("MINERU_API_KEY","你的key","User")

export MINERU_API_KEY="你的key"

内置 MarkItDown 位于 vendor/markitdown。首次需要 fallback 到 MarkItDown 时，scripts/bootstrap_markitdown.py 会自动创建可复用 Python runtime，并按文件类型安装所需依赖。

默认 runtime 位置：

  • Windows: %LOCALAPPDATA%\own-style-writer\runtime
  • Linux/WSL/macOS: ~/.cache/own-style-writer/runtime

如果不能写用户缓存目录，设置 OWN_STYLE_WRITER_RUNTIME 到一个可写目录。