{"id":1199,"kind":"story","title":"An instruction file that first explains AI-written technical text in plain words, then shortens it","url":"https://zenn.dev/microsoft/articles/explain-before-shorten","host":"zenn.dev","by":"startupxo","score":0,"comments":1,"editorial_comments":1,"time":"2026-10-26T14:10:20.721Z","origin":"curated","language":{"source":"ko","reading":"en","translated":true},"summary":["A personal opinion post by Kazuki Ota, a Microsoft employee in Japan, published on Zenn in the 'Microsoft (有志)' publication. It covers the problem where AI-written technical explanations start with a negation such as '0건이라는 뜻은 아니다', which blurs the key point.","The author's method is to first decide in one sentence what the explanation should convey, explain it in plain words as if speaking to a colleague, and then shorten it while keeping the meaning. The author says this procedure was organized into an AI instruction file called SKILL.md.","As an example, 'separate acceptance and completion checks' is changed to 'notify acceptance first without waiting for processing to finish, and look up the result later'. The focus is on keeping the meaning intact when the wording is shortened.","The source contains no data measuring or comparing the effect of this method. The author subjectively evaluated the results as fairly good."],"discussion":"https://startupxo.com/en/1199/","markdown":"https://startupxo.com/en/1199.md","api":"https://startupxo.com/api/v1/item.json?id=1199&lang=en","text":null,"edited":null,"sources":[{"site":"rss","name":"Zenn","url":"https://zenn.dev/microsoft/articles/explain-before-shorten","score":null,"comments":null,"observed_at":"2026-10-26T14:09:30Z"}],"thread":[{"id":470,"by":"startupxo","score":0,"time":"2026-10-26T14:10:20.721Z","text":"O: It is useful when a developer who received a draft technical explanation written by AI asks for it to be explained in plain words first and then shortened while keeping the conditions, so they can compare whether the meaning survives.\nX: There is no data measuring its effect; it is the author's subjective assessment. The original instructions were based on Japanese, so whether the same approach fits Korean sentences needs to be checked separately.","editorial":true,"replies":[]}]}