文档与知识 · daymade/claude-code-skills
teams-channel-post-writer
Creates educational Teams channel posts for internal knowledge sharing about Claude Code features, tools, and best practices. Applies when writing posts, announcements, or documentation to teach colleagues effective Claude Code usage, announce new features, share productivity tips, or document lessons learned. Provides templates, writing guidelines, and structured approaches emphasizing concrete examples, underlying principles, and connections to best practices like context engineering. Activates for content involving Teams posts, channel announcements, feature documentation, or tip sharing.
L2 本地 · 限定工作目录V1 已固定读写文件Dual-pass Audit
管控等级描述 skill 的能力与建议配套的管控措施，不代表质量或安全认证，也不表示可用或不可用。是否使用由用户和管理者决定。不同 agent 宿主对权限的约束各不相同，请勿假定宿主一定会提供安全兜底。第三方 skill 版权归原作者，使用风险由使用者自行承担。
1实现原理 · 为什么它能做到
它是纯提示词编排型 skill：没有任何脚本或可执行代码，能力全部由「一份模板 + 一份写作规范 + 一套五步流程」构成，产出物是 Markdown 文本而非任何程序化结果。
teams-channel-post-writer/SKILL.md
Start with the template in `assets/post-template.md` and fill in:
全目录仅 3 个文件（SKILL.md / assets/post-template.md / references/writing-guidelines.md），无 scripts/ 目录，无 .py/.sh 文件。
结构被固定成 9 个填空位（标题→引言→是什么→怎么用→为什么用→示例→配置→行动号召→延伸阅读），把「写公告」变成可重复的填空作业，这是它保证输出一致性的主要机制。
teams-channel-post-writer/SKILL.md
1. **Title**: Use an emoji and clear description 2. **Introduction**: Include release date and brief context 3. **What it is**: 1-2 sentence explanation 4. **How to use it**: Show "Normal vs Better" pattern with explicit instructions 5. **Why use it**: Explain the underlying principle with 4 key benefits 6. **Examples**: Provide 3+ realistic, concrete prompts 7. **Options/Settings**: List key configurations or parameters 8. **Call-to-action**: End with actionable next step 9. **Learn more**: Link to authoritative resources
该模板本身就是一个可直接抄的骨架文件，占位符形状（📝 Normal / ⭐ Better、必须 4 条 Benefit、必须 3 条示例 prompt）与 SKILL.md 的九步要求严格对应。
teams-channel-post-writer/assets/post-template.md
📝 **Normal:** "[Example of typical approach]" ⭐ **Better:** "[Example of improved approach with explicit instructions]"
模板里的 '- **Benefit 1**: Explanation' 到 '- **Benefit 4**' 与 '- `option1` - Description' 三档选项，正对应 SKILL.md 第 5、7 步的『4 key benefits』与『Key configurations』。
「Normal vs Better」而非「Wrong vs Correct」是硬性设计选择，目的是避免读者被指责——这是该 skill 与普通「写公告」提示词最可辨识的差异点，且被写进质量检查清单。
teams-channel-post-writer/references/writing-guidelines.md
### 2. Show, Don't Just Tell - Use "Normal vs Better" comparisons instead of "Wrong vs Correct" - Include 3+ concrete example prompts users can adapt - Provide realistic use cases from actual development workflows
SKILL.md 的 Key Principles 也重申：'Always include concrete examples users can adapt. Use "Normal vs Better" comparisons to demonstrate improvements without making readers feel criticized.'
写作前有研究前置条件（查官方发布日/版本、实测行为、找权威来源、确认信息未过时），把「准确」当作发文前提而不是润色项。
teams-channel-post-writer/SKILL.md
**Research checklist:** - [ ] Found official release date/version number - [ ] Verified feature behavior through testing or documentation - [ ] Identified authoritative sources to link to - [ ] Understood the underlying principle or best practice
规范文件侧对应『## Research Requirements』四步，最后一条是『Check for updates: Ensure information is current』。
内容要求「连接到底层原理」而不只是描述功能，举例直接用 context engineering（把 Explore agent 类比成 context offloading）——这是该 skill 主张的教学价值所在。
teams-channel-post-writer/SKILL.md
### Connect to Principles Don't just describe features—explain the underlying best practices. For example, connect the Explore agent to "context offloading" principles in context engineering.
引用 `references/writing-guidelines.md` 展开，SKILL.md 自身只给这句示例。
2核心能力
01可直接填空的 Teams 帖子模板（9 段结构）
02五步工作流（理解主题 → 规划内容 → 套模板起草 → 按规范自检 → 保存分享）
03两类内容模式的骨架（功能公告 5 段 / 最佳实践 6 段）
04语气与风格规范（教育性、专业但不生硬、可操作、简洁可扫读）
05排版约定（emoji 仅用于标题、Normal/Better 用 📝/⭐、提示词用代码块、步骤用编号）
06发文前质量检查清单
07事实核验要求（发布日/版本号来自 changelog，示例须实测可用，链接权威来源）
3外部依赖
| Kind | Dependency / Endpoint |
|---|---|
| network | 官方文档 / changelog（工作流要求去查发布日与版本号并引用权威来源；具体站点由使用者决定，skill 未硬编码端点） |
4管控建议与判定依据
建议配套管控措施
面向 Agent
限定工作目录
面向管理者
保留操作记录
判定依据（文件路径与关键语句摘要）
- 本地工作目录: 文件读写与工件输出: 由 agent（非任何随包脚本）把成稿写成本地 Markdown 文件：SKILL.md 指示 'Save the final post to you
审计说明： 。判定依据：目录内 3 个文件全部是 Markdown，无 scripts/、无 .py/.sh、无任何可执行代码；无网络请求代码、无凭证或环境变量读取、无系统命令；唯一的副作用是 agent 按指示把成稿写成一个本地 Markdown 文件（因此不落🟢『无本地写入』那一档，取🔵『仅本地读写，无网络外发、无凭证』）。研究步骤要求查阅官方文档属于 agent 使用宿主工具的行为，本 skill 未硬编码任何端点或抓取代码。使用注意仅一条：它产出的内容会被同事当作事实阅读，因此『先核实再发文』这条规范需要真的被执行。
5第二遍独立确认
- [ok] 是否真的没有可执行资产（找反例：隐藏脚本、打包物、内联代码块） — glob/find 结果仅 3 个 .md 文件；全目录 grep '.py|.sh|#!/|subprocess|urllib|requests|eval(|exec(' 零命中；三个文件中的代码块全部是 Markdown 结构示例（如 '1. What is it? (with release date)'）。无隐藏资产。
- [ok] 『外部资源/工具』是否只有一项（是否漏掉了隐含依赖） — 第一遍只列了『官方文档/changelog（无固定端点）』。第二遍重新逐行核对：SKILL.md 提到 tree/ls 之类工具？无；提到任何 CLI？无；提到任何 URL 或域名？无（grep 'http' 全目录零命中）；提到任何包？无。规范里的外部资源要求是『Link to authoritative external resources when applicable』，由使用者填。结论：外部依赖仅此一项，且无端点可列。
- [ok] 模板与规范是否真的和 SKILL.md 的九步一致（防止文档内部互相矛盾） — 逐项对应：九步的 1-9 全部在 post-template.md 有对应占位（标题/New in [Tool] ([Date])/What is it?/📝Normal+⭐Better/Why use it? + 4 Benefit/Example prompts ×3/Key settings 3 档/Try it next time/Learn more）；规范文件的 Feature Announcements 5 段与 Best Practices 6 段模式是同一结构的两种裁剪，不冲突。
- [discrepancy] marketplace 关键词是否与正文内容相符 — .claude-plugin/marketplace.json 中该条目 keywords 含 'adaptive-cards'，但全目录 grep 'adaptive'（不分大小写）在 SKILL.md、assets/post-template.md、references/writing-guidelines.md 中零命中：正文只教 Markdown 排版（emoji/粗体/代码块/列表），从未涉及 Microsoft Adaptive Card 的 JSON schema 或发送方式。即登记词超出实际内容，属 marketplace 元数据的轻微夸大；相应地『发到 Teams』这一步在 skill 内没有任何机制或指引（只写 Markdown 文件、由人自行粘贴）。
- [ok] 『Save the final post』这一步是否有落盘机制（是否只是文字要求） — 确认为纯文字要求，无脚本执行：SKILL.md 第 5 步只写 'Save the final post to your team's documentation location with a descriptive filename like "Claude Code Tips.md" or "[Topic Name].md"'，落盘动作由宿主的文件写入工具完成。因此 security.file_writes 记的是 agent 级行为而非 skill 代码行为，已在字段中如此标注。
- [ok] pin commit 与 skill.path 是否与任务书一致 — git rev-parse HEAD = d5c4678cb5d4fd6acc9c922690df035dbd33d247；目录位于仓库根，相对路径 teams-channel-post-writer；本目录最后提交 878f947（2026-09-07）。GitHub API 复核 MIT / stars 1392 / pushed 2026-09-15T09:30:04Z。
6结论
适合： 适合：团队内部要把「某个 Claude Code 新功能 / 某条实践心得」讲清楚给同事听的人——尤其适合已经习惯用模板批量产出知识分享的技术团队，以及想统一内部写作调性的技术写作者。作为纯提示词资产，零安装成本、零运行风险，可作为写作规范的起点直接改。
不适合： 不适合：需要程序化发帖/卡片格式对接 Teams 的场景（skill 不提供发送通道，也无 Adaptive Card 支持）；需要 AI 生成配图或排版的场景（只处理文本结构）；面向外部受众的营销文案（Normal/Better 教学范式与内部教育定位不匹配）；主题不涉及 Claude Code 时，其研究要求与原理连接会失去抓手。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload teams-channel-post-writer.tar.gz
sha256:
Option B · Copy Guide for Agent9aefc4bf9f7ae3af…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit d5c4678cb5.