1实现原理 · 为什么它能做到
它是纯提示词编排型 skill:没有任何脚本或可执行代码,能力全部由「一份模板 + 一份写作规范 + 一套五步流程」构成,产出物是 Markdown 文本而非任何程序化结果。
Start with the template in `assets/post-template.md` and fill in:
结构被固定成 9 个填空位(标题→引言→是什么→怎么用→为什么用→示例→配置→行动号召→延伸阅读),把「写公告」变成可重复的填空作业,这是它保证输出一致性的主要机制。
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 的九步要求严格对应。
📝 **Normal:** "[Example of typical approach]" ⭐ **Better:** "[Example of improved approach with explicit instructions]"
「Normal vs Better」而非「Wrong vs Correct」是硬性设计选择,目的是避免读者被指责——这是该 skill 与普通「写公告」提示词最可辨识的差异点,且被写进质量检查清单。
### 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
写作前有研究前置条件(查官方发布日/版本、实测行为、找权威来源、确认信息未过时),把「准确」当作发文前提而不是润色项。
**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
内容要求「连接到底层原理」而不只是描述功能,举例直接用 context engineering(把 Explore agent 类比成 context offloading)——这是该 skill 主张的教学价值所在。
### 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.
2核心能力
3外部依赖
| 类型 | 依赖 |
|---|---|
| network | 官方文档 / changelog(工作流要求去查发布日与版本号并引用权威来源;具体站点由使用者决定,skill 未硬编码端点) |
4风险提醒 风险提醒:蓝色 · 知晓即可
- 不提供「发送到 Teams」的任何机制 — skill 只产出一份 Markdown 文件,如何进 Teams(粘贴?Adaptive Card?Webhook?)完全自理;而 marketplace 关键词却登记了 adaptive-cards,容易让人误以为它支持卡片格式。需要真正自动化发布的场景,本 skill 不解决。
- 事实准确性依赖 agent 真的去查证 — 研究清单是流程要求,不是代码校验;若 agent 凭记忆编造发布日/版本号或引用不存在的链接,文档会把错误传播给整个团队。这类内容会被同事当权威阅读,误信成本高。使用时应要求 agent 逐条给出可打开的来源。
- 模板化可能带来千篇一律 — 九段固定结构 + 固定 emoji 用法(📝/⭐)会让多篇帖子高度同质;对需要差异化表达的场合(如高层公告、事故复盘)不一定合适,需自行裁剪。
- 主题范围很窄 — 内容是围绕 Claude Code 功能与用法的内部教学帖,把它用于其他主题(产品发布、市场文案)会失去其研究要求与原理连接的价值锚点。
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结论
9aefc4bf9f7ae3af…d5c4678cb5