关于 teams-channel-post-writer
面向 Claude Code 的技能,用于撰写 Teams 知识分享帖,提供资料核验流程、模板和写作指引,将功能介绍联系到工程实践。
主要功能
- 01研究并核实功能信息
- 02围绕核心原则规划内容
- 03使用结构化帖子模板
- 04加入实用提示词与工作流
- 05检查清晰度、准确性和语气
适用场景
- 01发布 Claude Code 功能介绍
- 02与同事分享提示词技巧
- 03记录 Claude Code 使用经验
- 04讲解可复用的工程实践
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ daymade/ claude-code-skills --skill teams-channel-post-writer安装后在 Claude Code 中输入/teams-channel-post-writer确认已加载。
附带文件assets/post-template.mdreferences/writing-guidelines.md
详细介绍
Teams 频道帖子撰写指南
概述
创建结构清晰、具有教育意义的 Teams 频道帖子,围绕 Claude Code 功能和最佳实践开展内部知识分享。本技能提供模板、写作指南和结构化工作流,帮助产出一致且可执行的内容,助力同事学会有效使用 Claude Code。
何时使用此技能
在创建 Teams 频道帖子以用于以下目的时,可使用此技能:
- 宣布并介绍 Claude Code 的新功能
- 分享 Claude Code 技巧和最佳实践
- 教授有效的提示词模式和工作流
- 将功能与更广泛的工程原则联系起来(例如,上下文工程)
- 记录使用 Claude Code 的经验教训
工作流
1. 了解主题
收集要撰写的主题相关信息:
- 通过官方文档深入研究功能或主题
- 从变更日志中核实发布日期和版本号
- 确定帖子要传达的核心价值或原则
- 收集实际使用中的具体示例
研究检查清单:
- 找到官方发布日期和版本号
- 通过测试或文档核实功能行为
- 找到可供引用的权威来源
- 理解其背后的原则或最佳实践
2. 规划内容
根据 references/writing-guidelines.md 中的写作指南,规划以下内容:
- 引子:这个主题有哪些新内容或重要之处?
- 核心原则:它体现了什么最佳实践?
- 示例:哪些具体提示词或工作流能说明这一点?
- 行动号召:读者接下来应该尝试什么?
3. 使用模板起草
从 assets/post-template.md 中的模板开始,填写以下内容:
- 标题:使用表情符号和清晰的描述
- 引言:注明发布日期并提供简要背景
- 功能介绍:用 1-2 句话进行说明
- 使用方法:展示“普通做法与更好做法”的模式,并提供明确指示
- 使用理由:用 4 项主要益处解释其背后的原则
- 示例:提供至少 3 个真实、具体的提示词
- 选项/设置:列出关键配置或参数
- 行动号召:以可执行的下一步结束
- 了解更多:链接到权威资源
4. 应用写作指南
根据 references/writing-guidelines.md 中的质量检查清单审阅草稿:
- 语气具有教育意义且乐于助人
- 采用“普通做法/更好做法”的模式(而非“错误/正确”)
- 示例具体、真实
- 通过原则解释“为什么”
- 结构清晰,使用项目符号和格式排版
- 事实和日期均已核实
5. 保存并分享
将最终帖子保存到团队的文档存放位置,并使用具有描述性的文件名,例如“Claude Code Tips.md”或“[Topic Name].md”。
核心原则
展示,而不只是讲述
始终提供用户可以借鉴的具体示例。使用“普通做法与更好做法”的对比展示改进之处,同时避免让读者觉得受到了批评。
联系原则
不要只描述功能,还要解释背后的最佳实践。例如,将 Explore Agent 与上下文工程中的“上下文卸载”原则联系起来。
确保可执行
明确说明调用方式。用户应能复制粘贴示例并立即使用。
核实所有信息
始终调研发布日期、核实功能行为,并链接到权威来源。准确性能够建立信任。
资源
references/writing-guidelines.md
全面的写作指南,包括:
- 语气和风格标准
- 不同类型帖子的结构模式
- 格式规范
- 研究要求
- 质量检查清单
如需了解语气、结构和质量标准的详细指南,请参阅此文件。
assets/post-template.md
可直接使用的 Markdown 模板,包含以下占位结构:
- 标题和简介
- 功能说明
- 使用示例
- 优势和原则
- 选项和设置
- 行动号召和资源
复制此模板作为新文章的起点,然后自定义内容,同时保留经过验证的结构。