1仕組みと動作原理
完全なプロンプトオーケストレーション型スキルです。スクリプトや実行可能コードは一切含まず、能力のすべてが「1つのテンプレート+1つの執筆ガイドライン+1つの5ステップワークフロー」で構成されており、生成物はプログラム処理結果ではなく 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 つのサンプルプロンプト)は SKILL.md の 9 ステップの要件と厳密に対応しています。
📝 **Normal:** "[Example of typical approach]" ⭐ **Better:** "[Example of improved approach with explicit instructions]"
「Wrong vs Correct(誤り vs 正解)」ではなく「Normal vs Better(通常 vs より良い)」を採用したのは厳格な設計意図であり、読者が非難されていると感じるのを防ぐためです。これは一般的な告知作成プロンプトとの最大の違いであり、品質チェックリストにも明記されています。
### 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 に例えるなど)を挙げています。これが本スキルの教育的価値の中核です。
### 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外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| network | 官方文档 / changelog(工作流要求去查发布日与版本号并引用权威来源;具体站点由使用者决定,skill 未硬编码端点) |
4推奨統制措置と判定根拠
- 本地工作目录: ファイル読み書きおよび成果物出力: エージェント(同梱スクリプトではない)が完成した原稿をローカルの Markdown ファイルに出力します。SKILL.md に 'Save the final post to you' と指示されています。
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…