Night Market 技能 — 从 claude-night-market/scribe 迁移而来。如需完整体验（含 agent、hook 和命令支持），请安装 Claude Code 插件。

文档生成器

一份文档的成本，等于其所有读者所花费的时间总和。要么值得这份成本，要么就精简它。

生成立足于具体主张的文档，以核心论点（thesis）开篇，并确保每一句话都具备明确价值。诸如“在当今快节奏的世界中”这类空洞套话，以及缺乏实证支撑的模糊表述（如“全面的”“完整的”），均属冗余。此外，任何未承载（carry）、未例证（instance）、未限定（bound）或未复述（repeat）该文档唯一核心论点的句子，也应剔除。

本技能同时强制执行句子级简洁性（禁用松散词汇、过度使用破折号、谄媚式开场白）与文档级经济性（论点先行、每句必有分量、仅对核心论点作必要重复）。完整评估标准详见 Skill(scribe:slop-detector) 模块中的 document-economy.md 文件。

核心写作原则

使用主动语态及作者视角。解释技术选型背后的推理逻辑（例如：为何选用此数据库而非彼数据库），而非堆砌中立模板化内容。仅在需要呈现简短、并列要点时谨慎使用项目符号；将多行项目符号瀑布式列表转为连贯叙述，以保留推理链条。

词汇与风格

避免商业黑话及语言习癖（如镜像式句式结构、破折号滥用）。在 docstring 中统一使用祈使语气（例如：“Validate input”，而非 “Validates input”）。切勿拟人化非生命实体（如“代码希望……”“函数意在表达……”）。

9. 限制拟人化表达

“lives under”、“speaks to” 等类似短语仅适用于有生命体。

10. docstring 使用祈使语气

使用 “Validate”，而非 “Validates”（遵循 PEP 257、pydocstyle 及 ruff 规范）。

必需的 TodoWrite 条目

1. doc-generator:scope-defined — 已明确目标文件与文档类型
2. doc-generator:style-loaded — 已应用风格配置（若存在）
3. doc-generator:content-drafted — 已完成初稿内容生成
4. doc-generator:slop-scanned — 已检查 AI 冗余标记
5. doc-generator:quality-verified — 已通过原则核查清单
6. doc-generator:user-approved — 已获最终用户确认

模式：生成（Generation）

适用于新文档撰写：

步骤 1：定义范围

## Generation Request

**Type**: [README/Guide/API docs/Tutorial]
**Audience**: [developers/users/admins]
**Audience size**: [1 / small team / org / public]
**Read frequency**: [once / weekly / per-invocation]
**Thesis**: [读者必须带走的一句话核心论点]
**Length target**: [约 X 字或 X 节]
**Style profile**: [配置名 或 "default"]

“Thesis” 字段为必填项。 若无法用一句话清晰陈述核心论点，则说明范围尚未就绪。受众规模与阅读频次共同决定读者时间预算（参见 scribe:slop-detector 模块中的 document-economy.md）：每日被 50 名用户加载的技能，其预算远高于一份一对一的设计备忘录。

步骤 2：加载风格配置（若存在）

若已存在风格配置文件：

cat .scribe/style-profile.yaml

据此应用语气、词汇及结构规范。

步骤 3：起草内容

以核心论点开篇。 首段须直陈唯一核心论点。即使读者仅阅读首段即停止，也应已掌握关键信息。在正文中部与结尾各复述一次论点；其余所有重复一律删除。

严格遵循上述 10 条核心原则。针对每个章节，请执行以下流程：

1. 起始即提供最关键信息（陈述论点本身，或其一个明确实例）
2. 仅当上下文能切实增强价值时才添加（即：是否承载、例证或限定论点？）
3. 使用具体示例（一个为佐证；两个为强调；三个即属冗余）
4. 优先采用连贯叙述，而非项目符号
5. 信息完备即止（不加填充式总结，不写“In conclusion”等重复性结语）

步骤 4：运行冗余检测器（Slop Detector）

Skill(scribe:slop-detector)

修复全部问题后，方可进入下一步。

步骤 5：质量门禁（Quality Gate）

依据以下核查清单进行验证：

句子级：

• 无一级冗余词（tier-1 slop words）
• 每千字破折号数量 ＜ 3 个
• 项目符号占比 ＜ 40%
• 所有主张均有具体依据支撑
• 无套路化开场或收尾
• 具备作者视角
• 无 emoji（除非明确要求）

文档级（document-economy 模块）：

• 核心论点在首段明确提出，且唯一、清晰（2/2）
• 超过 80% 的句子承担、例证、限定或复述核心论点（2/2）
• 核心论点至少复述 3 次；非论点内容的重复均已剔除（2/2）
• 写作耗时大致正比于（受众规模 × 阅读频次 × 单次阅读耗时）

模式：修正（Remediation）

适用于已有内容的清理优化：

加载：@modules/remediation-workflow.md

步骤 1：分析当前状态

# 获取冗余评分
Skill(scribe:slop-detector) --target file.md

步骤 2：分节处理

对于大文件（＞200 行），建议增量式编辑：

## Section: [名称] (第 X–Y 行)

**当前冗余评分**: X.X  
**发现的问题**: [问题列表]

**建议修改**:
1. [修改 1]
2. [修改 2]

**修改前**:
> [当前文本]

**修改后**:
> [建议文本]

是否继续？[Y/n/edit]

步骤 3：保持原意

只修改表达方式（HOW），绝不更改实质内容（WHAT）。若原意不清，务必提问确认。

步骤 4：重新验证

完成编辑后，再次运行 slop-detector，确认冗余评分已改善。

Docstring 专用规则

编辑代码注释时，请遵守：

1. 仅修改 docstring / 注释文本本身
2. 绝不改动周边代码
3. 使用祈使语气（例如：“Validate input”，而非 “Validates input”）
4. 简洁优于冗长 — 删除所有填充性内容
5. 若存在 Args/Returns 结构，则予以保留

模块参考

• 参阅 modules/generation-guidelines.md 获取内容创作模式
• 参阅 modules/quality-gates.md 获取验证标准

与其他技能的集成

退出条件

• 文档内容已完成生成或修正
• 冗余评分 ＜ 1.5（达到“clean”评级）
• 质量门禁核查清单全部通过
• 已获得用户批准
• 文档中不含 emoji（除非明确指定）