メインコンテンツまでスキップ

/l-text-expand-story

Text Expand Story Skill

The user wants to expand brief bullet points or notes into a more detailed, narrative story. This is more than just polishing - it requires imagination to flesh out the ideas into engaging prose.

Input​

The user provides brief bullet points or notes like:

/l-text-expand-story

- AIにissueデータを読ませるため、何度も参照する前提でGitHubのissueをローカルにDL
- Claude CodeにNode.jsスクリプトを作らせ、issueをMarkdown化し画像も含めて取得。この方法は学習にオススメ
- 1万件以上のissueを保存して下準備を整え、ドキュメント作成へ

The text after /l-text-expand-story is the target text to expand.

Your Task​

1. Find the Source Location​

Locate which file contains this text. Use these strategies in order:

  1. Check current unstaged changes (PRIMARY) - Run git diff to see the actual content of unstaged changes. The target text should be in the added lines (lines starting with +). This is the most likely location since the user just typed the text.
  2. Search for the text - If not found in unstaged changes, use grep to find the exact location
  3. Check recently modified files - Use find or ls -lt to identify recently edited markdown files

2. Read Context​

Once you find the file and line, read the surrounding content (at least 30-50 lines before and after) to understand:

  • The overall topic and flow of the article
  • The writing style being used
  • What story the author is trying to tell
  • The emotional tone and pacing

3. Read Writing Rules​

Read these files to understand the proper article writing style:

  • doc/docs/overview/writing-style.md
  • doc/docs/overview/markdown-writing-rule.md
  • doc/docs/overview/vocabulary-rule.md

4. Expand the Story​

Transform the brief notes into a fuller narrative:

Key principles:

  • Imagine the full story - Read between the lines to understand what the author wants to convey
  • Add context and motivation - Why did they do this? What were they thinking?
  • Include transitions - Connect ideas naturally with appropriate flow
  • Add personal touches - Include author's reactions, thoughts, or observations
  • Create narrative rhythm - Vary sentence length and structure for readability

5. Replace the Text​

After expanding, directly replace the original bullet points in the file with the expanded narrative using the Edit tool. No need to present multiple candidates.

6. Show the Result​

After making the edit, show the user:

  • The original bullet points
  • The expanded narrative that was written
  • A brief explanation of what was added (motivations, transitions, personal touches)

Important Notes​

  • Be creative but faithful - Expand the ideas, but stay true to what the author likely intended
  • Read the surrounding context carefully - The expansion should fit naturally with adjacent paragraphs
  • Maintain the author's voice - Use Takazudo's characteristic style from the writing guide
  • Add substance, not fluff - Each addition should serve the narrative, not just pad word count
  • Consider the reader's journey - Guide them through the story with clear progression
  • This is a direct replacement - no need to ask for confirmation or provide alternatives

Arguments​

$ARGUMENTS - The bullet points or brief notes to expand into a fuller story