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.