ドキュメント&知識ベース · daymade/claude-code-skills

teams-channel-post-writer

Claude Code の機能、ツール、ベストプラクティスに関する社内ナレッジ共有用の教育的な Teams チャネル投稿を作成します。同僚に Claude Code の効果的な使い方を教えたり、新機能をアナウンスしたり、生産性向上のヒントを共有したり、得られた知見をドキュメント化したりするための投稿、通知、資料を作成する際に適用されます。具体的な例、基礎となる原理原則、コンテキストエンジニアリングなどのベストプラクティスとの関連付けを重視したテンプレート、執筆ガイドライン、構造化されたアプローチを提供します。Teams の投稿、チャネルアナウンス、機能ドキュメント、またはヒントの共有に関連するコンテンツでトリガーされます。

L2 ローカル · 作業ディレクトリ限定V1 コミット固定ファイル書き込みDual-pass Audit
Author daymadeGitHub daymade/claude-code-skills ↗Stars 1392License MIT(仓库根 LICENSE,Copyright (c) 2025 daymade;GitHub API spdx MIT)Commit d5c4678cb5
管理レベルは Skill の能力と推奨統制措置を示すものであり、品質や安全性の認証、利用可否の判定ではありません。使用の可否はユーザーおよび管理者が決定します。Agent 環境によって制約が異なるため、自動保護を仮定しないでください。第三者製 Skill の著作権は原著作者に帰属し、利用リスクは利用者が負います。

1仕組みと動作原理

完全なプロンプトオーケストレーション型スキルです。スクリプトや実行可能コードは一切含まず、能力のすべてが「1つのテンプレート+1つの執筆ガイドライン+1つの5ステップワークフロー」で構成されており、生成物はプログラム処理結果ではなく 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 つのサンプルプロンプト)は SKILL.md の 9 ステップの要件と厳密に対応しています。

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' の 3 段階の選択肢は、SKILL.md のステップ 5 および 7 にある「4 key benefits」や「Key configurations」に正確に対応しています。

「Wrong vs Correct(誤り vs 正解)」ではなく「Normal vs Better(通常 vs より良い)」を採用したのは厳格な設計意図であり、読者が非難されていると感じるのを防ぐためです。これは一般的な告知作成プロンプトとの最大の違いであり、品質チェックリストにも明記されています。

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」4 ステップに対応しており、最後の項目は「Check for updates: Ensure information is current」となっています。

単に機能を説明するだけでなく「基礎となる原理原則に結びつける」ことを要求しており、具体例として context engineering(Explore agent を context offloading に例えるなど)を挙げています。これが本スキルの教育的価値の中核です。

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 セクション構成)
025 ステップのワークフロー(テーマ理解 → 構成検討 → テンプレート起草 → ガイドライン照合 → 保存・共有)
032 つのコンテンツパターンのスケルトン(機能アナウンス 5 セクション / ベストプラクティス 6 セクション)
04トーン&スタイル規約(教育的、親しみやすいプロフェッショナル、実用的、簡潔でスキャンしやすい)
05フォーマット規約(見出しのみ emoji 使用、Normal/Better に 📝/⭐ を使用、プロンプトはコードブロック化、手順は番号付き)
06投稿前品質チェックリスト
07ファクトチェック要件(更新履歴に基づくリリース日/バージョン、実機検証済みのサンプル、信頼できる公式リンク)

3外部依存関係

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

4推奨統制措置と判定根拠

安全運用のための推奨統制措置
Agent 向け
作業ディレクトリを限定
管理者向け
操作ログを保持
判定根拠(ファイルパスと抜粋)
  • 本地工作目录: ファイル読み書きおよび成果物出力: エージェント(同梱スクリプトではない)が完成した原稿をローカルの Markdown ファイルに出力します。SKILL.md に 'Save the final post to you' と指示されています。
監査ノート: 判定基準: ディレクトリ内の 3 ファイルはすべて Markdown であり、scripts/、.py/.sh、実行可能コードは一切含まれていません。ネットワーク通信コード、認証情報や環境変数の読み取り、システムコマンドの実行も存在しません。唯一の副作用は、エージェントが指示に従って完成稿をローカルの Markdown ファイルとして保存することです(そのため🟢「ローカル書き込みなし」ではなく、🔵「ローカル読み書きのみ、外部送信・認証情報なし」に分類)。公式ドキュメントの調査はエージェント側のホストツール依存であり、本スキルにエンドポイントやスクレイピング処理はハードコードされていません。運用上の注意点: 出力内容は社内で事実として読まれるため、「投稿前の事前検証」プロセスを確実に遵守する必要があります。

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結論

  • 「同僚向けの教育的な投稿」を再現可能な 9 段の穴埋め形式に落とし込み、出力の再現性と一貫性が高く、社内ナレッジの継続的な発信に適しています。
  • Wrong vs Correct ではなく Normal vs Better を用いた比較パターンにより、学習効果と読者の心理的配慮を両立しています。
  • 「原理の説明」を必須要件に据えることで無味乾燥な機能紹介を回避し、context engineering などの再利用可能な概念を提示できます。
  • 事前調査チェックリスト(リリース日/バージョン、実機検証、一次情報、鮮度確認)により、正確性の担保を明示的なプロセスとして定着させます。
  • アセットの役割分担が明確(真似するテンプレート / 判断基準のガイドライン / 手順の SKILL.md)で、導入および保守コストが極めて低いです。
  • 最適な用途: 適した用途: チーム内で「Claude Code の新機能やベストプラクティス」を同僚へ分かりやすく説明したい人。特に、テンプレートを活用してナレッジ共有を効率的に量産したい技術チームや、社内の発信トーンを統一したいテクニカルライターに最適です。完全なプロンプト資産であるため導入コスト・実行リスクがゼロで、独自の執筆規約を構築するための出発点としても活用できます。
    不向きな用途: 不適な用途: プログラムによる自動投稿や Teams への Adaptive Card 連携が必要な環境(投稿機能やカード形式は非サポート)。画像生成やデザインレイアウトを求める場合(テキスト構造のみ対象)。外部向けのマーケティング文面作成(Normal/Better の教育的アプローチは社内向けに特化)。Claude Code に関連しないテーマ(調査要件や原理への結びつけが機能しなくなります)。
    Install Agent-Ready
    ① Verified Mirror 2026-09-15
    Option A · Direct DownloadDownload teams-channel-post-writer.tar.gz
    sha256: 9aefc4bf9f7ae3af…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit d5c4678cb5.