view --main base_writing.md

base_writing

Name: base_writing
Author: TTAWDTT/skill-writer

base_writing – это open-source решение, разработанное для упрощения и ускорения процесса создания технической документации. Инструмент позволяет существенно сократить время, затрачиваемое на написание и редактирование, предоставляя основу для структурированного и последовательного изложения информации.

Он выступает в качестве мощного инструмента разработчика, автоматизируя рутинные задачи и освобождая ресурсы для более творческой и аналитической работы. Поддерживая различные форматы и обеспечивая гибкость в настройке, base_writing способствует созданию высококачественной документации, соответствующей требованиям проекта.

Благодаря автоматизации многих этапов, base_writing повышает эффективность команд и обеспечивает единообразие стиля и терминологии. Это позволяет создавать документацию, которая легко читается, понятна и соответствует лучшим практикам.

$ git log --oneline --stat

⭐ звёзды: 3

форки: 2

обновлено: 15 марта 2026 года в 05:30

Проводник файлов

4 файлы

SKILL.md

evaluation.md

requirements.yaml

structure.yaml

SKILL.md

readonly --- lines

--- name: base_writing description: 写作元技能（Meta Skill）。为所有文书 Skill 提供必须遵守的全局写作规范与评审标准，提升评审友好性与可用度。 version: "1.0.0" category: 系统工具 tags: - meta-skill - writing - guidelines - rubric role: meta_writing user-invocable: false --- # BaseWritingSkill（写作元技能 / Meta Skill） > 目的：将专家写作经验、潜规则与通用写作技巧，系统性沉淀为所有 Writer / Reviewer 必须遵守的全局写作规范，从而显著提升文书（尤其是申报书）的可用度与评审友好性。 ## 一、设计目标 BaseWritingSkill 是一层**高于具体文书 Skill 的写作元技能（Meta Skill）**，用于承载： - 专家在长期写作实践中形成、但往往难以显性表达的写作经验 - 通用于“章节 / 段落 / 全文”的结构性、逻辑性、评审友好型写作规则 - 可不断累积、融合多位专家经验的写作“潜规则集合” 其核心目标包括： 1. **可积累**：持续吸收专家反馈，形成规则库 2. **可复用**：所有具体 skill 默认继承 3. **强约束**：Writer 生成与 Reviewer 评审同时执行 4. **可演进**：规则可不断补充、细化、重构 5. **评审友好**：显著降低评审理解成本 ## 二、适用范围与层级 - 适用范围： - 全文（document） - 章节（section） - 段落（paragraph） - 技能层级定位： ``` BaseWritingSkill（L0：写作元技能，通用于所有文书） ↑ DomainWritingSkill（L1：领域写作技能，如申报书） ↑ Concrete Skill（L2：具体文书 skill） ``` ## 三、全局写作规范（Guidelines） ### 0. 总体目标（评审友好） - 写作重心必须放在 **“怎么做 / 做了什么 / 为何可行 / 证据是什么”** 上。 - 避免大段背景铺陈与空泛口号。 - 任何时候都应优先降低评审者的理解成本。 ### 1. 结构性规则（必须执行） #### 1.1 总—分—总（章节与段落通用） - 每个章节、每个段落都必须遵循 **“总—分—总”** 的表达逻辑： - **总**：开头 1–2 句给出本节/本段的总体概括、核心结论或要点； - **分**：中间展开具体内容、论证或说明，建议使用分点或小标题； - **总**：结尾用一句话或短语进行总结、收束，并回扣目标。 #### 1.2 章节开头的“逻辑框架摘要”（可文字化） - 每一章节开头 **必须** 提供该章节的逻辑结构与关系说明： - 可采用文字化逻辑框图 - 或流程描述、层级结构说明、要点列表 - 要求读者在**不阅读正文细节的情况下**，也能理解： - 本章在做什么 - 各部分的逻辑关系与顺序 #### 1.3 重点前置，避免头重脚轻 - 背景与意义应 **简明克制**，不得喧宾夺主。 - **技术路线 / 方法 / 工作内容 / 实施方案** 必须占主要篇幅。 - 关键结论、创新点、核心贡献应尽量前置呈现。 ### 2. 表达与信息组织（强烈建议） #### 2.1 结论先行 + 证据支撑 - 推荐表达顺序： - **结论 / 要点** - → **证据 / 数据 / 论据** - → **推导 / 细节说明** #### 2.2 结构化表达优先 - 能用列表就不用长段落。 - 长段落必须具备主题句与内部结构。 - 列表项应语义平行、逻辑可对比。 #### 2.3 术语与概念一致性 - 首次出现的重要概念应给出简明定义。 - 全文术语、缩写、指标口径必须前后一致。 #### 2.4 指标化与可检验 - 能量化的内容尽量量化（指标、输入输出、成功判据）。 - 避免不可检验的表述。 #### 2.5 逻辑闭环（Why–What–How–So What） - 每一个重要主张，至少回答：Why / What / How / So What。 ## 四、评审标准（Evaluation Rubric） ### A. 结构与可读性（40 分） - 是否遵循总—分—总结构 - 章节开头是否有逻辑框架摘要 - 是否避免头重脚轻 ### B. 评审友好与论证闭环（40 分） - 关键结论是否前置 - 是否有证据支撑 - 是否形成逻辑闭环 ### C. 表达规范与一致性（20 分） - 术语是否一致 - 是否避免空泛表述 ## 五、使用方式建议 - 所有具体 Skill 通过 `extends: [base_writing]` 继承本技能。 - 专家反馈持续补充进本技能。 - 目标是形成“专家经验联合体”。 **BaseWritingSkill 是 Skill 体系的智慧层。**

Инициализация мануала...