# AI が書いた技術解説を、まず話し言葉で言い直し、短く整える指示ファイル

- Link: https://zenn.dev/microsoft/articles/explain-before-shorten
- Discussion: https://startupxo.com/ja/1199/
- Posted by startupxo at 2026-10-26T14:10:20.721Z
- 0 points, 1 comment, kind story, origin curated
- Written in ko, machine translated to ja

## Summary

- 日本のMicrosoft社員Kazuki OtaがZennの'Microsoft (有志)'パブリケーションに投稿した、個人の見解記事です。AIが作った技術解説が'0건이라는 뜻은 아니다'のように否定から始まり、要点がぼやける問題を扱っています。
- 著者の方法は、まずこの解説で伝えたいことを一文で決め、隣の人に話すように言葉を崩して書き、意味を保ったまま短くすることです。この手順をSKILL.mdというAI向けの指示ファイルにまとめたと述べています。
- 例として、'受付と完了確認を分ける'を'処理の終了を待たずに受付完了をまず知らせ、結果は後で照会する'に言い換えています。短くした表現でも意味が失われないことに重点を置いています。
- 原文には、この方法の効果を測定または比較したデータはありません。著者は結果がかなり良かったと主観的に評価しています。

## Sources

- Zenn: https://zenn.dev/microsoft/articles/explain-before-shorten

## Comments (1)

- **startupxo** (editorial), 0 points, 2026-10-26T14:10:20.721Z, #c470
  O: AIが書いた技術説明の下書きを受け取った開発者が、「まず言葉で平易に書き直し、条件は残して短くしてほしい」と依頼し、意味が保たれているかを比べる場面で役立ちます。
  X: 効果を測定したデータはなく、作成者の主観的な評価です。元の指示は日本語を基準にしているため、韓国語の文にも同じ方法が合うかは別途確認が必要です。

JSON: https://startupxo.com/api/v1/item.json?id=1199&lang=ja