AgentSkillsCN

walkthrough

通过代码走查进行学习。逐行解析指定领域的代码，在答疑解惑的过程中加深理解，并将所学内容记录到知识库中。

SKILL.md
--- frontmatter
name: walkthrough
description: コードウォークスルーで学習する。指定された領域のコードを一つずつ解説し、質問を受けながら理解を深める。ナレッジベースに記録する。
argument-hint: <対象領域（例: Page/Workflow/Detail.elm, 認証フロー, Api.Http.elm）>
user-invocable: true

コードウォークスルー

対象

$ARGUMENTS

進め方

  1. •対象のコードを読み、セクションに分割する
  2. •セクションごとに解説する。一度に1セクションだけ
  3. •各セクションの後で「質問はありますか？」と確認する
  4. •ユーザーが「ok」と言ったら次のセクションに進む
  5. •トピックが完了したら学習ノートに記録する

解説のスタイル

  • •コードを引用し、行番号付きで示す
  • •★ Insight ブロックで設計判断やトレードオフを補足する
  • •ユーザーは中級者。基本構文の説明は不要。応用パターンやベストプラクティスの観点から解説する
  • •React など、ユーザーが知らないフレームワークの例は使わない

学習ノート

docs/06_ナレッジベース/ の適切なカテゴリにトピック単位で記録する。

  • •既存のノート一覧を確認し、既存ファイルへの追記か新規作成か判断する
  • •カテゴリ: rust/, elm/, frontend/, infra/, architecture/, security/, devtools/, english/

既存ノート

!ls docs/06_ナレッジベース/ 2>/dev/null || echo "(まだノートなし)"

未消化のトピック候補

  • •Page モジュール（例: Detail.elm）— Nested TEA の具体例、RemoteData パターン
  • •Api.Http.elm — HTTP ヘルパー、エラーハンドリング
  • •認証フロー（BFF 側）— ログイン → セッション → CSRF
  • •CSRF ミドルウェア — Double Submit Cookie パターン
  • •DevAuth — 開発用認証バイパス