[!NOTE] After reading this

SKILL.md

, say

📡 私は shunk031-writing-telegraph を読みました。

Telegraph Style

Core Principles

• Apply this style to the body of deliverables such as reports, HTML, and memos that the user asks to create or revise
  • For a request such as

    shunk031-writing-telegraph でレポートを書いて

    , render the report body in telegraph style
  • Use normal conversational language for the skill-read notification, work-in-progress updates, and completion reports unless the user explicitly requests those to be restyled as well
• This skill depends on the

  shunk031-writing-kosshi

  skill; first read that skill, then build a skeleton of claims and supporting evidence or verify the provided skeleton
  • Leave the hierarchy of arguments, preservation of facts, citations, missing information, and handling of sentence-ending periods to that skill
  • This skill shortens each skeleton line and uses symbols to show relationships between terms
• Do not disrupt parallel relationships at the same level or the structure that places supporting evidence one level below

Style

• Shorten each line to a length that can be understood at a glance
  • Omit subjects inferable from context, and omit particles and sentence-final

    である

    or

    です

    only when the relationships remain clear
  • Use noun phrases for short headings and category labels; retain predicates in explanatory lines whenever needed for clarity
  • Limit each line to one idea
  • Do not force every line into a noun phrase; use noun phrases, short expressions that retain predicates, and short sentences according to each line's role

    • 〜を使用する

      may become

      〜を使用

      , and

      〜が増加した

      may become

      〜が増加

      , when the action or state remains clear
    • If nouns alone, such as

      使用モデル

      or

      性能向上

      , do not make the relationship clear, retain particles or predicates

Example: Omit words inferable from context

- 週次レポートでは、CSV の収集だけを API 化し、集計ロジックはスプレッドシートに残す
  - 現在の手作業は一回あたり 5.5 時間かかる
  - API 化後は、担当者がチェックとコメント追記に集中できる

- CSV 収集を API 化・集計はスプレッドシートを維持
  - 現在: 一回 5.5 時間の手作業
  - API 化後はチェックとコメント追記に集中

Example: Retain actions and states needed for explanation

視覚エンコーダには事前学習済みの ViT を使用する。学習時にはエンコーダのパラメータを固定する。変更後、NDCG は 3.8 ポイント増加した。

- 視覚エンコーダ: 事前学習済み ViT を使用
- 学習時: エンコーダのパラメータを固定
- NDCG: 3.8 ポイント増加

Symbols

• Use symbols only when they can briefly show relationships between terms

  • →

    indicates processing order or changes in values or states

  • ➜

    follows immediately preceding content to move from a premise to a conclusion, from a problem to the next focus, or from a comparison to an interpretation

  • ⇔

    indicates a bidirectional correspondence;

    ↓

    indicates moving down to a subordinate process or transformation

  • vs.

    indicates contrast,

    :

    indicates a label and its content, and

    /

    indicates parallel or joint listing
  • If symbols alone make the relationship ambiguous, use short prose

Example: Show procedures and value changes with

→

検索処理では、入力を正規化してから候補を検索し、最後にリランキングする。リランキングによって NDCG は 0.374 から 0.412 に上がった。

- 検索処理: 入力 → 正規化 → 候補検索 → リランキング
- NDCG: 0.374 → 0.412

Example: Move from comparison to conclusion

新手法の NDCG は 0.412、ベースラインは 0.374 だった。一方で、新手法の推論時間は 18%増えた。精度向上と推論時間増加の釣り合いはまだ検証していない。

- 新手法: 精度向上 / 推論時間増加
  - NDCG: ベースライン 0.374 vs. 新手法 0.412
  - 推論時間: +18%
  - ➜ 精度と推論時間の釣り合いは未検証

Maintenance

shunk031-writing-kosshi

shunk031-writing-kosshi