---
name: tcms-writer
version: "1.3.0"
description: |
  For tech-product marketing teams — turns a product knowledge base into brand-side long-form drafts (blogs, case studies, product write-ups), not third-party analysis.
  Produces only 1500-3000 word long-form drafts from a content brief; does not handle social posts, short content, or channel adaptation.
  Not for neutral industry research — use industry-deep-dive-pipeline for that.
read_when:
  - 写文章
  - 写稿
  - 写初稿
  - 起草
  - 技术博客
  - 品牌技术稿
  - 案例文章
  - 客户案例
  - 产品解读
  - 产品稿
  - 新闻稿
  - content brief
  - draft
  - 按brief写
allowed-tools:
  - read_file
  - write_to_file
  - replace_in_file
  - web_fetch
  - search_content
  - search_file
  - list_dir
disable: false
---

# TCMS Writer

基于产品知识库、品牌规范和选题Brief，产出高质量的长文初稿。

## 工作模式：提示链（Prompt Chaining）

按固定步骤执行，每一步输入输出明确。

---

## Step 1: 确认选题 [确定性]

读取用户提供的选题信息，确认以下要素：

| 要素 | 必须明确 | 缺失时处理 |
|------|---------|-----------|
| 文章类型 | 技术博客 / 客户案例 / 产品解读 | 询问用户 |
| 目标产品 | 具体产品名 | 询问用户 |
| 目标读者 | 架构师/CTO/工程师/分析师 | 默认"技术决策者" |
| 核心信息 | 要传达的关键价值点 | 从知识库提取 |
| 素材来源 | 知识库/内部材料/已发文章 | 默认使用知识库 |
| 保密要求 | 是否有内部案例需脱敏 | 默认全部脱敏 |

如果用户提供了Brief文件路径，直接读取Brief。

---

## Step 2: 读取素材 [确定性]

**只读与目标产品相关的文件，不加载无关产品信息：**

1. **产品知识库** → 搜索目标产品对应章节（不读全文，用search_content定位）
2. **品牌规范** → `references/brand-rules.md`（每次都读）
3. **文章模板** → 按文章类型读取对应模板：
   - 技术博客：`references/templates/tech-blog.md`
   - 客户案例：`references/templates/case-study.md`
   - 产品解读：`references/templates/product-update.md`
4. **补充素材**（按需）：Brief中指定的内部文档或已发布文章

> 以上路径需根据实际项目目录配置。

---

## Step 3: 写作 [LLM]

### 写作规则

**产品名称**：
- 首次提及使用官网全称（参见brand-rules.md产品名称对照表）
- 后续可用简称

**品牌露出**：
- 标题中包含品牌名或具体产品官方名称
- 开头两段内引入品牌或具体产品
- 结尾有固定品牌格式

**数据引用**：
- 所有数据必须来自知识库或已发布文章，不可编造
- 引用时记录来源（用于Step 5生成引用表）

**客户信息**：
- 内部来源的客户案例**默认脱敏**
- 脱敏格式："某+行业+企业规模"
- 不出现客户公司名、内部人员姓名、项目代号
- 用户明确告知已授权的可使用客户名称

**竞品处理**：
- 不直接点名任何竞品
- 使用"某友商平台"等替代表述

**产品能力来源验证**：
- 只引用知识库中存在的产品能力
- 不确定是否已公开的，在预审清单中标注"需确认"

### 英文稿 AI 强特征与作者性门禁 [英文稿必过]

本节是 TCMS 对统一英文规则源 `tech-writing-pipeline/references/english-ai-writing-strategy.md` 的应用说明。可访问该规则源时必须加载；本 Skill 不另建禁词表，也不以 AI detector 分数作为发布结论。本节规则不替代产品、品牌、客户、竞品、命名和知识库约束。

1. **先建英文 claim map。** 英文稿动笔前，用英文记录 `Claim / Evidence / Counterargument / Boundary / What the reader should not infer` 五项。英文稿按英文读者的论证顺序重写，不按中文句序逐句翻译。
2. **P0 直接停止。** 出现虚构事实、数字、引语、关系或归因；空泛开场或结尾承载主要信息；只有积极形容词没有对象、证据和条件；`studies show` / `experts believe` 没有可核查来源；反方只被提及却未评价；把中文平行结构或媒体表达直接搬进英文稿，均退回Brief或素材重建。
3. **P1 进入人工复核。** 单段内修辞包装词成组出现，反复使用 `not just X but Y` 等对举模板，破折号或同构三项并列变成节奏骨架，或积极表述超过对象、来源、测量和限定条件时，进入人工复核。单个风格词不构成问题。
4. **作者性检查。** 每个主要段落都要能指出具体对象、事件、数字或观察行为；作者愿意承担的判断；最强合理反驳；对反驳的处理；以及会使判断变窄或失效的条件。
5. **按渠道解释结构。** LinkedIn 的对象清单、责任清单、承担事实功能的三项并列或结构母题不能单独判为 AI 腔。只有它们与空泛开场、来源不裁决、作者判断缺席或修辞包装叠加时，才升级处理。detector 分数只能作为观察项，不能进入 PASS/FAIL。

### 文章结构

不写成：功能1 → 功能2 → 功能3 的产品说明书

要写成：**问题 → 为什么难 → 方案（自然引入产品能力）→ 效果 → 适用判断**

每篇文章要有明确的读者收获——读完能做出一个判断或学到一个方法。

### 字数

目标 1500-3000字。超过3500字需压缩，低于1200字需补充。

---

## Step 4: 自检 [LLM]

| 检查项 | 通过标准 | 不通过处理 |
|--------|---------|-----------|
| 客户名称泄露 | 内部来源案例无客户名 | 立即替换为脱敏版 |
| 竞品点名 | 无竞品公司名 | 替换 |
| 产品名规范 | 首次提及用官网全称 | 修正 |
| 品牌露出 | 标题/开头/结尾均有 | 补充 |
| 数据有出处 | 每个数字都能指向知识库条目 | 删除无出处数据 |
| 内部代号 | 无未公开的产品代号/功能名 | 删除 |
| 英文 claim map | 英文稿包含 Claim / Evidence / Counterargument / Boundary / What the reader should not infer | 停止并重建 |
| 英文作者性 | 每个主要段落都有具体对象、作者判断、反驳、回应与边界 | 人工复核 |
| 英文 AI 强特征组合 | 无 P0；P1 按上下文复核，不按单词禁用表判定 | 停止或修改 |
| 字数范围 | 1500-3000字 | 调整 |

---

## Step 5: 输出 [确定性]

产出两个文件：

**文件1：文章初稿**
保存路径：`content/drafts/YYYY-MM-{产品}-{主题简称}.md`

**文件2：引用追溯表 + 预审清单**
保存路径：同目录，文件名加 `-review` 后缀

```markdown
## 执行摘要
- 读取素材：[列出实际读取的文件]
- 模板选择：[文章类型]
- 文章字数：[实际字数]
- 引用数据点：[N]个（[M]个公开，[K]个内部脱敏）
- 自检结果：10项检查，[X]通过[Y]修正

## 引用追溯

| 文中数据点 | 知识库条目/来源 | 公开状态 |
|-----------|----------------|---------|
| "xxx" | xxx条目 / 来源文章 | ✅公开 / 📋内部(已脱敏) |

## 预审清单

- [ ] 客户名称脱敏检查
- [ ] 产品能力公开状态
- [ ] PM需确认的数据点
```

---

## 硬性规则

1. **不编造数据。** 没有出处的数字不写。
2. **内部案例默认脱敏。** 除非用户明确告知已授权。
3. **不点名竞品。**
4. **产品名以官网为准。**
5. **不引用知识库中没有的产品能力。** 不确定的标注"需确认"。
6. **每篇文章必须附引用追溯表。**
7. **未确认对外口径的产品不推广。**
8. **英文稿必须通过英文 AI 强特征与作者性门禁**：先建 claim map，再检查 P0、组合式 P1、作者判断、反方处理和证据边界；不得用禁词表或 detector 分数替代门禁。

---

## 失败处理

| 场景 | 处理 |
|------|------|
| 知识库中找不到目标产品信息 | 停止生成，报告"知识库中无{产品}的信息" |
| Brief中要求的文章类型没有对应模板 | 使用tech-blog模板作为默认 |
| 引用数据标注为"已过期" | 不引用，预审清单中标注 |
| 客户授权状态不明 | 默认脱敏 |
| 文章超过3500字 | 给出压缩建议 |

---

## ⚠️ 人工介入

输出完成后，文章进入**人工review环节**。本Skill不自动发布，所有初稿必须经人工确认后才能进入content-adapter进行渠道适配。