Communityコーディング&開発github.com

fact-find

Bottlerocketに関する具体的な事実を引用付きで素早く検索します。

fact-find とは?

このスキルは、Bottlerocket OSに関する具体的な事実(設定値、パーティション構成、systemdユニット、ファイルパス、バージョン情報など)を、適切な引用と共に迅速に回答します。主にドキュメント(README、設計ドキュメントなど)から情報を検索し、必要に応じてソースコードも参照します。回答は簡潔で、インライン引用とソース一覧を含むことが特徴です。Claude CodeやCodexなどのAIエージェント上で動作し、crumbly searchコマンドやgrep、rg、findなどのツールを使って情報を収集します。このスキルは、特定の事実に基づく質問に対してのみ使用し、アーキテクチャや設計に関する広範な質問にはdeep-researchスキルを使用することを推奨します。また、回答の最後にはResearch Quality Indicatorを付与し、情報源の品質(ドキュメント由来かソースコード由来か)を明示します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cbgbt/bottlerocket-forest/tree/main/skills/fact-find

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Fact Find

Bottlerocketに関する具体的な事実について、適切な引用と共に高速かつ焦点を絞った回答を提供します。

目的

Bottlerocketに関する具体的な事実を素早く見つけ、引用します:

  • 設定値とデフォルト値
  • パーティション構成とディスクレイアウト
  • Systemdのユニットとターゲット
  • ファイルパスと場所
  • バージョン番号と依存関係

使用タイミング

  • 説明ではなく、具体的な事実が必要な場合
  • 質問に確定的な答えが存在する場合
  • 「何が」「どこに」という情報を探している場合

アーキテクチャや設計に関するより広範な質問には、代わりにdeep-researchを使用してください。

手順

1. 検索

キーワードを含む焦点を絞ったクエリを作成します:

crumbly search "質問から特定の用語"

上位3~5件の結果を確認し、関連ファイルを見つけます。

2. 読み取り

最も関連性の高いファイルを読み、答えを見つけます:

# 対象を絞った読み取りのためのパターン検索
grep -n "関連用語" path/to/file.md

# ファイル全体が必要な場合
cat path/to/file.md

3. ドキュメントが不十分な場合

Crumblyはドキュメント(ソースコードではありません)をインデックス化しています。ドキュメントで答えが見つからない場合は、コードベースを直接検索します:

# 重要:常に検索範囲を特定のディレクトリに限定してください!
# フォレスト(リポジトリ全体)は80GB以上あり、範囲指定なしの検索はハングします。
rg "検索語" --type rust bottlerocket/sources/
find bottlerocket/sources -name "*関連名*"

これはドキュメントのギャップを示しています。Research Quality Indicatorにその旨を記録してください。

4. 引用付きで回答

インラインの上付き引用とソースセクションを含む、直接的で簡潔な回答を提供します:

Bottlerocketはデュアルパーティション構成を採用し、セットAとBを持ちます<sup>[1]</sup>。デフォルトのAPIソケットは`/run/api.sock`です<sup>[2]</sup>。

## ソース

<sup>[1]</sup> [`sources/updater/signpost/README.md`](../sources/updater/signpost/README.md)
- パーティションセットの構造

<sup>[2]</sup> [`sources/api/README.md`](../sources/api/README.md)
- APIソケットの設定

引用ガイドライン:

  • 事実のインラインには <sup>[1]</sup>、<sup>[2]</sup> などを使用
  • パスは対象リポジトリからの相対パス
  • ファイルパスはMarkdownリンクで記述
  • リポジトリ間参照にはGitHub URLを使用:https://github.com/bottlerocket-os/REPO/blob/develop/FILE.md
  • 各ソースが提供した内容を簡潔な箇条書きで説明

検証

優れたfact-find応答の条件:

  • ✓ 特定の質問に直接回答している
  • ✓ 簡潔(通常2~4文)
  • ✓ インラインに上付き引用がある
  • ✓ 番号付き参照を含むソースセクションがある
  • ✓ 不必要なコンテキストや説明がない

Research Quality Indicator

応答の最後に以下を付記します:

  • ✅ ドキュメントから回答 - READMEファイル、設計ドキュメント、またはナラティブドキュメントで見つかりました。
  • ⚠️ ソースコードから回答 - ドキュメント不足のため、実装ファイルを読む必要がありました。
  • 🔍 部分的なドキュメント - 完全に回答するためにドキュメントとソースコードの両方が必要でした。

Individual skills in this repo

This repo contains 19 individual skills — each has its own dedicated page.

ad-hoc-implementation-plan

Transform a rough plan into implement-commit ready artifacts. Allows rigorous review while implementing.

build-kit-locally

Build a kit and publish it to a locally hosted registry for development testing

build-variant-from-local-kits

Build a variant using locally published kits for development validation

deep-research

Create educational documents that build understanding progressively with citations

edit-spec-file

Edit Bottlerocket RPM spec files following project style conventions

idea-honing

Clarify feature ideas through iterative Q&A, recording insights to guide concept development

implement-commit

Implement commits from an implementation plan using a TDD pipeline

local-registry

Start and manage a local OCI registry for Bottlerocket kit development

prepare-core-kit-release

Prepare bottlerocket-core-kit for release by bumping version and updating changelog

propose-feature-concept

Create a new feature concept document to pitch the idea and explain the problem/solution

propose-feature-design

Create or update feature technical design document with architecture and implementation guidance

propose-feature-requirements

Create or update feature requirements specification using EARS notation with examples and appendices

propose-feature-test-plan

Create a test plan mapping EARS requirements and Critical Constraints to specific tests

propose-implementation-plan

Create an implementation plan with atomic commits that build toward a complete feature

review-code

Deep code review generating PR comments via principled question-driven analysis

review-scope

Verify code changes match intended scope and requirements without exceeding boundaries

review-style

Verify code follows project style guides without providing improvement suggestions

test-local-twoliter

Build and test local changes to twoliter before releasing

update-twoliter

Update all Bottlerocket repositories to a new Twoliter version

関連スキル