全部技能 / 文档与知识 / teams-channel-post-writer
文档与知识 · 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.

风险提醒:蓝色 · 知晓即可AI 侦查报告
作者 daymadeGitHub daymade/claude-code-skills ↗Stars 1392许可 MIT(仓库根 LICENSE,Copyright (c) 2025 daymade;GitHub API spdx MIT)commit d5c4678cb5
agent 宿主通常会约束 skill 执行权限;风险提醒为 AI 侦查观点,不构成质量或安全保证。第三方 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外部依赖

类型依赖
network官方文档 / changelog(工作流要求去查发布日与版本号并引用权威来源;具体站点由使用者决定,skill 未硬编码端点)

4风险提醒 风险提醒:蓝色 · 知晓即可

风险提醒:蓝色 · 知晓即可
  • 不提供「发送到 Teams」的任何机制 — skill 只产出一份 Markdown 文件,如何进 Teams(粘贴?Adaptive Card?Webhook?)完全自理;而 marketplace 关键词却登记了 adaptive-cards,容易让人误以为它支持卡片格式。需要真正自动化发布的场景,本 skill 不解决。
  • 事实准确性依赖 agent 真的去查证 — 研究清单是流程要求,不是代码校验;若 agent 凭记忆编造发布日/版本号或引用不存在的链接,文档会把错误传播给整个团队。这类内容会被同事当权威阅读,误信成本高。使用时应要求 agent 逐条给出可打开的来源。
  • 模板化可能带来千篇一律 — 九段固定结构 + 固定 emoji 用法(📝/⭐)会让多篇帖子高度同质;对需要差异化表达的场合(如高层公告、事故复盘)不一定合适,需自行裁剪。
  • 主题范围很窄 — 内容是围绕 Claude Code 功能与用法的内部教学帖,把它用于其他主题(产品发布、市场文案)会失去其研究要求与原理连接的价值锚点。
风险提醒:蓝色,知晓即可。判定依据:目录内 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结论

  • 把「写给同事看的教育帖」拆成可重复的九段填空,输出一致性强,适合批量产出内部知识分享。
  • Normal vs Better(而非 Wrong vs Correct)的对比范式兼顾了教学效果与读者感受。
  • 「解释原理」被设成硬要求,避免写成干巴巴的功能公告,并给出 context engineering 这类可复用的落点。
  • 研究前置清单(发布时间/版本、实测、权威来源、时效核对)把事实准确性变成流程步骤。
  • 资产分层清晰:模板(照抄)/规范(判断)/流程(SKILL.md),使用与维护成本都低。
  • 适合:适合:团队内部要把「某个 Claude Code 新功能 / 某条实践心得」讲清楚给同事听的人——尤其适合已经习惯用模板批量产出知识分享的技术团队,以及想统一内部写作调性的技术写作者。作为纯提示词资产,零安装成本、零运行风险,可作为写作规范的起点直接改。
    不适合:不适合:需要程序化发帖/卡片格式对接 Teams 的场景(skill 不提供发送通道,也无 Adaptive Card 支持);需要 AI 生成配图或排版的场景(只处理文本结构);面向外部受众的营销文案(Normal/Better 教学范式与内部教育定位不匹配);主题不涉及 Claude Code 时,其研究要求与原理连接会失去抓手。
    安装 agent 直装可复制
    ① 本站镜像 更新 2026-09-15
    方式 A · 人下载镜像包下载 teams-channel-post-writer.tar.gz
    sha256: 9aefc4bf9f7ae3af…
    方式 B · JSON 格式安装指南,复制给 agent
    安装指南
    agent 读 JSON 指南后会自动从本站下载安装,无需更多说明。
    ② 上游 GitHub · 原始来源
    能访问 GitHub?直接去上游安装(实时版,可能已更新)GitHub 原始 ↗
    本页镜像锁定 commit d5c4678cb5;上游为实时仓库。
    来源信息 GitHub 原始
    作者 / 仓库daymade / daymade/claude-code-skills
    Stars1392
    最近推送2026-09-15
    本 skill commitd5c4678cb5
    许可MIT(仓库根 LICENSE,Copyright (c) 2025 daymade;GitHub API spdx MIT)
    本站信息
    收录日期2026-09-06
    分类文档与知识
    侦查报告AI 侦查 · 2 遍 · 2026-09-06
    本站镜像与 GitHub 原始是不同来源:本站锁定 commit 快照经 /r2 分发;GitHub 为实时上游,内容可能已更新。
    同分类邻近