setup-copywriting-md

设置 COPYWRITING.md

概述

一次性设置：调研本项目的文案和品类定位信息，然后编写一个供 Agent 和人类遵循的根目录 COPYWRITING.md。除非用户明确要求重新生成或更新该文件，否则不要将此视为持续维护技能。

输出

• 只写入一个文件：仓库根目录下的 COPYWRITING.md。
• 如果 COPYWRITING.md 已存在，只询问一次是覆盖、合并/更新还是中止。不要悄悄覆盖。

工作流

1. 收集项目背景

阅读足够的资料，以了解产品、受众和现有文风：

• 根目录文档：README.md、落地页/营销页面、关于/定价页面、引导文案。
• 产品内文案：UI 标签、空状态、错误、邮件、通知、CTA 模式。
• 品牌或风格说明（如果存在；不要凭空编造不存在的品牌手册）。
• 软件包元数据、网站配置和能够体现定位的公开 URL。

优先采用仓库中的一手资料，而非臆测。

2. 调研外部模式

如果有已配置的调研或网页工具，则使用这些工具；否则，搜索并打开一手页面：

• 直接竞争对手和相近替代品的主页、定价、功能页面和引导流程。
• 具有清晰定位信息的品类领导者和优秀相邻产品。
• 记录反复出现的结构：标题公式、佐证方式、CTA 动词、异议处理、语气。

记录具体示例（简短引文 + URL）。明确区分观察到的模式和建议。

3. 访谈用户（仅针对缺失信息）

只询问仓库和调研无法回答的问题。集中提问。缺少以下信息时，询问：

• 预期的品牌语气（应使用/避免的词语）。
• 不可妥协的宣传主张、合规或法律限制。
• 偏好的语言/地区设置和正式程度。
• 必须排除在范围之外的产品或界面。

如果用户拒绝访谈，则按标注清楚的假设继续。

4. 编写 COPYWRITING.md

使用 references/template.md。填写所有适用章节；省略空白章节。质量要求：

• 内容针对本产品，而非通用营销建议。
• 包含应该做/不应该做的示例，示例应简短且真实或贴近实际。
• 区分事实（当前文案）和指导（建议模式）。
• 列出所用的竞争对手/来源，必要时注明日期或 URL。
• 内容应具备可操作性，让另一个 Agent 无需重新调研也能撰写符合品牌风格的文案。

5. 添加 AGENTS.md 链接（有条件）

COPYWRITING.md 创建后：

1. 仅检查根目录下的 AGENTS.md。
2. 如果不存在，则跳过添加链接。不要创建 AGENTS.md。
3. 如果存在，且缺少链接，则添加指向 COPYWRITING.md 的明确链接：
   • 优先添加到现有的索引/文档/相关文档章节。
   • 否则添加一个简短章节，例如 ## 项目文档，并附上项目符号： - [COPYWRITING.md](COPYWRITING.md) — 语气、风格和文案模式
   • 不要将完整的文案内容重复写入 AGENTS.md。
   • 保留 AGENTS.md 中无关的内容。

6. 交付

• 确认写入的路径。
• 简要总结：用一句话概括文风、列出最重要的 3 条规则，并说明是否更新或跳过了 AGENTS.md。
• 除非用户要求，否则不要提交更改。

独立性

此技能独立运行。不要提及、链接或依赖其他技能。仅引用仓库文件、外部来源和此技能的 references/。

范围之外

• 重写代码库中的所有产品文案。
• 创建完整的品牌手册、设计系统或营销网站。
• AGENTS.md 缺失时创建该文件。
• 除非用户要求重新运行设置，否则不进行定期审查。