是什么
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 模板,为以下内容提供占位结构:
- 标题与引言
- 功能说明
- 使用示例
- 收益与原理
- 选项与设置
- 行动号召与资源
复制此模板作为新帖子的起点,然后在保持已验证结构的同时自定义内容。