본문으로 건너뛰기
cccskills
무료GitHub에 공개

retro-workspace

Reflect reusable learnings into the current workspace / repository design and automation assets (.github/**, AGENTS.md, repo scripts/tasks). Not for ~/.copilot personal assets or a private skills repository. Use when running a workspace/repo retro. Detects whether a project folder exists and, if not, asks before creating one. Triggers on "retro workspace", "repo retro", "workspace cleanup", "ワークスペース知見反映".

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aktsmm/Agent-Skills
설치 방법 보기

포함된 파일(2)

  • SKILL.md7.7 KB
  • LICENSE.txt5.2 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

retro-workspace

インシデント・会話から再利用可能な知見を抽出し、現在の workspace / repository の設計資産・automation 資産へ最小差分で反映する SKILL。判定とフローはこの SKILL 内で完結させ、他の skill に委譲しない。

When to Use

  • 使う: バグ解決後 / 再発時 / workspace 設計ギャップ発見時
  • 使う: 既存手順より安全・再現可能・高速な script / task / helper へ昇格すべき改善を見つけたとき
  • 使う: .github/**、AGENTS.md、repo 固有 instructions / agents / hooks、scripts、tasks への反映
  • 使わない: typo のみ / 環境固有問題のみ / ~/.copilot personal assets / private skills repository の .github/skills/**（いずれもそのスコープ向けの retro workflow へ渡す）

入力

エラーログ / Git diff / 会話履歴 / ターミナル履歴のいずれか 1 つ以上。なければ追加要求して停止。

Workspace 検出（反映先決定）

実行環境によっては active workspace を取得できない場合がある。知見抽出の前に反映先を決める。

  1. ユーザーまたは host context が workspace path を明示している場合: repo marker の有無を問わず、その folder を反映先にする。CWD や外部の新規プロジェクト候補で上書きしない
  2. 明示 workspace path がない場合: CWD かその親に .git / .github/ / AGENTS.md のいずれかがあれば、その repo ルートを反映先にする
  3. workspace なし: ファイルもフォルダも作らず、ユーザーに確認する
    • 選択肢を提示: (a) 反映せず handoff（知見だけ提示） / (b) 既存の別フォルダを指定する
    • 新規プロジェクトフォルダは、ユーザーが作成先を自分で指定した場合を除き、作成も提案もしない

Mode

  • 既定は safe-auto。workspace scope が明確で、既存資産への小〜中規模更新で済む場合は確認なしで反映してよい
  • review-only / 確認だけ / dry-run / プレビュー が明示された場合だけ、変更案の提示で停止する
  • Confirm only unclear scope, new privileges/destinations/visibility/defaults, destructive deletion or uncertain sensitive data. Bounded fixes need no reapproval; code/hooks widening permissions still do.

Scope Gate

  • 反映先は AGENTS.md、.github/**、repo 固有 scripts / tasks / helpers に限定する
  • secret / 認証情報 / 個人情報 / 顧客情報 / ローカル絶対パス / 端末固有値 / /memories/** は反映しない
  • ~/.copilot は scope 不一致として停止する
  • .github/skills/** は直接編集せず、SKILL 向きなら提案して停止する

Edit Rules

  • 新規ファイルより既存への統合を優先し、削除 → 統合 → 分離 → 追加 の順で検討する
  • 新しいルールを書く前に、同じ判断が scripts / 生成物 / 既存資産に実装済みでないか確認する。実装と矛盾するルールは、次の run に正しい資産を壊させる
  • Use an isolated clean checkout for authorized Git mutations; preserve unrelated dirty, avoid blanket staging/autostash, and group owning-scope edits. Refresh ledger IDs before appending and verify uniqueness after an authorized commit. Do not add unrequested commits/pushes.
  • For an explicitly authorized push, fetch, inspect the permitted ahead range and integrate behind/divergence in the clean execution checkout first; never use force or stale tracking refs.
  • After moving a multi-paragraph Markdown section, verify heading order, exactly one occurrence of the moved heading and its first content line, and git diff --check; delete-plus-insert moves can otherwise leave an omission or duplicate.
  • 圧縮は AI が判断できる最小情報を主目的にし、人間向け可読性は二次とする
  • 正常・例外・停止時の判断を変えない不要・自明・重複の説明は先に削除し、必要な残りだけ圧縮する。根拠 URL・非自明な手順・承認範囲・未検証要件・停止／復旧条件・必要な実例・metadataは残す。履歴は古さだけで削らず、原文の保存を確認し、未保存の追記は保持する
  • 同じ Learning / Evidence / Impact を言い換えて繰り返さず、1 論点 1 塊でまとめる
  • AGENTS.md と .github/copilot-instructions.md のような入口ファイルは役割過多を先に疑う。ただし詳細を別資産へ移すときは、入口に1行のポインタを残す（リンクがないと発見されない。入口サイズを理由に先送りしない）
  • script / task 化は、再利用価値・検証可能性・影響範囲の狭さが揃う場合を優先する

実行手順

0. Pre-Flight Inventory

知見抽出に入る前に、反映先候補を inventory する。どの .instructions.md / tasks.json / scripts/ / AGENTS.md が受け皿になりそうか、適用される scope gate は何かを先に見る。これで scope を早めに定め、複数ファイルへの分散反映や既存資産との重複を防ぐ。

1. 知見抽出

  • 設計原則、workflow、context、automation 改善、繰り返し指示の既定化を優先して拾う
  • 一度の否定的観測（「その機能は無い」）を規則にしない。認証状態、拡張のアクティブ化、モードを潰してから確定し、潰しきれないなら観測条件を添えて残す
  • 1 件ごとに Learning / Evidence / Impact を作る

2. 変更案作成

  • 優先度: Impact x Recurrence（P1/P2/P3）
  • まず既存 workspace 資産へ統合できるかを確認する
  • script / task 化が適切なら既存 runner や script directory を優先する
  • レポート/HTML化で実画面を扱う場合は、actual UI screenshots と生成した evidence view を明示的に分け、Teams/チャット等の共有画面は投稿先・ユーザー・チャネル・URL周辺をマスクしてから反映する
  • entry file では追加より先に圧縮を検討し、AGENTS.md と .github/copilot-instructions.md の役割差分を崩さない
  • safe-auto では最小差分で反映し、review-only と Gate 停止時だけ提案に留める

3. 反映 + 必要時承認

  • safe-auto で編集する
  • 確認が必要な条件に該当する場合だけ、対象・理由・影響を示して承認後に反映する

3.5. 肥大化チェック（反映後）

反映後、DRY 違反・冗長表現・重複定義があれば圧縮・削除・分離する。

Next Candidates

List up to three scoped read-only follow-ups: dirty authoring/private-push/distribution gaps. Use the owning workflow, honor holds/visibility, and never widen scope or execute suggestions.

Example Report

# Retro: [Title]

- Target workspace: <repo root | ユーザー指定フォルダ | handoff>
- Learnings: ...
- Changes: ...
- Gate: pass / stop reason

Stop: 知見なし / ユーザー拒否 / Gate 失敗 / handoff-required / review-only / workspace 未確定

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

agentic-workflow-guide

무료

Design, review, and debug agent workflows, and decide when a request should use a prompt, instruction, skill, agent, or hook before escalating to multi-agent design. Use for .agent.md / .instructions.md / .prompt.md / AGENTS.md work, workflow architecture, orchestration planning, scheduled automation model allocation, or when agent workflows may be overkill. Triggers on 'agent workflow', 'create agent', 'automation models', 'ワークフロー設計', 'orchestrator'.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aktsmm/Agent-Skills262026년 10월 20일 업데이트

ai-cli-benchmark

무료

Design, run, and review fair performance, token, and cost comparisons across GitHub Copilot CLI, Codex CLI, and direct model APIs. Use for AI CLI benchmark, Copilot vs Codex, prompt-cache diagnosis, cache read/write analysis, fresh-process latency measurement, token-cost comparison, or when a benchmark must separate provider caching from local CLI caches.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aktsmm/Agent-Skills262026년 10월 20일 업데이트

analyze-copilot-sessions

무료

Analyze historical VS Code GitHub Copilot Chat sessions by model, reasoning effort, AIU, time, reliability, workflow behavior, and external quality evidence, or safely prune workspace-scoped local chat history by age. Use for session analysis, repeated-task retrospectives, model evaluation, cost/performance analysis, and old session cleanup.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aktsmm/Agent-Skills262026년 10월 20일 업데이트

animated-infographic

무료

Create reproducible animated infographic GIFs from structured data or measured results, with audience-language labels, explicit timing semantics, representative-frame QA, and a static fallback. Use when asked for GIF生成, animated infographic, 動的インフォグラフィック, 結果が流れる図, animated benchmark, or a blog/SNS animation whose displayed metrics must remain traceable to source data.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aktsmm/Agent-Skills262026년 10월 20일 업데이트

archify

무료

Create polished, validated architecture, workflow, sequence, data-flow, and lifecycle/state diagrams as explorable standalone HTML with inline SVG, dark/light themes, optional trace motion, and PNG/JPEG/WebP/SVG/WebM export. Accept plain-language requirements or pasted Mermaid flowchart, sequenceDiagram, and stateDiagram input; inspect repository evidence when the diagram must reflect real code. Use when the user asks to visualize system architecture, infrastructure, cloud/security/network topology, technical workflows, API call sequences, request lifecycles, data pipelines, ETL/ELT, data lineage, state machines, or to convert/beautify Mermaid. Also use for Archify, interactive or animated HTML diagrams, インタラクティブ図, 動く構成図. When an editable .drawio file is required, use the draw.io workflow instead and treat Archify HTML only as a supplement.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aktsmm/Agent-Skills262026년 10월 20일 업데이트

ascii-banner

무료

Generate ASCII-art text banners for terminals, READMEs, and CLI startup messages. Use when a user asks for an ASCII banner, text art, バナー, アスキーアート, or a decorative header for a script/README.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

aktsmm/Agent-Skills262026년 10월 20일 업데이트

aktsmm의 스킬 모두 보기

이 스킬의 문제 신고