SuperAPI AI 工具集

teams-channel-post-writer

写作与研究

查看项目

更新于 10-13 20:08

技能介绍

是什么

teams-channel-post-writer 是一个用于撰写 Teams 频道科普帖的技能,目标是为内部知识分享创作结构良好、具有教育意义的帖子,内容围绕 Claude Code 的功能与最佳实践。该技能提供模板、写作指南和结构化工作流,用于产出一致、可操作的内容,帮助同事学习高效使用 Claude Code 的方法。

适用场景

该技能在创建 Teams 频道帖子时启用,用于:

  • 发布并解释 Claude Code 新功能
  • 分享 Claude Code 技巧与最佳实践
  • 教授有效的提示词模式与工作流
  • 将功能与更广泛的工程原则(例如上下文工程)建立关联
  • 记录使用 Claude Code 的经验教训

工作流

1. 理解主题

收集要撰写内容的相关信息:

  • 借助官方文档彻底调研该功能或主题
  • 从更新日志中核实发布日期与版本号
  • 确定帖子应传达的核心收益或原理
  • 从真实使用中收集具体示例

调研检查清单:

  • 找到官方发布日期/版本号
  • 通过测试或文档核实功能行为
  • 确定可链接的权威来源
  • 理解其背后的原理或最佳实践

2. 规划内容

依据 references/writing-guidelines.md 中的写作指南,规划:

  • 引子(Hook):该主题有哪些新内容或重要之处?
  • 核心原理:它体现了什么最佳实践?
  • 示例:有哪些具体提示词或工作流可以说明这一点?
  • 行动号召:读者接下来应该尝试什么?

3. 套用模板起草

从 assets/post-template.md 中的模板开始,填写以下部分:

  • 标题:使用表情符号和清晰的描述
  • 引言:包含发布日期和简要背景
  • 它是什么:用 1-2 句话解释
  • 如何使用:展示“常规 vs 更佳”模式,并给出明确指引
  • 为什么使用:解释背后的原理,列出 4 项关键收益
  • 示例:提供 3 个及以上真实、具体的提示词
  • 选项/设置:列出关键配置或参数
  • 行动号召:以可执行的下一步结尾
  • 了解更多:链接到权威资源

4. 应用写作指南

对照 references/writing-guidelines.md 中的质量检查清单审阅草稿:

  • 教育性与有帮助的语气
  • 使用“常规/更佳”模式(而非“错误/正确”)
  • 具体、真实的示例
  • 通过原理说明“为什么”
  • 用项目符号和格式呈现清晰结构
  • 已核实的事实与日期

5. 保存与分享

将最终帖子保存到团队文档位置,使用描述性文件名,例如“Claude Code Tips.md”或“[Topic Name].md”。

核心原则

展示,而不只是讲述

始终包含用户可以改编的具体示例。使用“常规 vs 更佳”对比来展示改进,而不让读者感到被批评。

关联原理

不要只描述功能——要解释背后的最佳实践。例如,把 Explore agent 与上下文工程中的“上下文卸载”(context offloading)原则关联起来。

让它可操作

明确说明调用模式。用户应能复制粘贴示例并立即使用。

核实一切

始终调研发布日期、核实功能行为,并链接到权威来源。准确性建立信任。

资源

references/writing-guidelines.md

全面的写作指南,包括:

  • 语气与风格标准
  • 不同帖子类型的结构模式
  • 格式约定
  • 调研要求
  • 质量检查清单

查阅此文件以获取关于语气、结构和质量标准的详细指引。

assets/post-template.md

可直接使用的 Markdown 模板,为以下内容提供占位结构:

  • 标题与引言
  • 功能说明
  • 使用示例
  • 收益与原理
  • 选项与设置
  • 行动号召与资源

复制此模板作为新帖子的起点,然后在保持已验证结构的同时自定义内容。