PRO Portfolio DEV
GitHubユーザーを入力すると、ライブポートフォリオが出力されます。スクリプトが取得、構築、チェック、公開を行います。
あなたがすべきことは、スクリプトにできない唯一のこと、つまりプロジェクトを選び、正直で簡潔なコピーを書くことだけです。
パスはこのスキルのフォルダからの相対パスです。作業はスクラッチフォルダ(例:portfolio/)で行ってください。
1 · 取得(事実のみ)
python3 scripts/fetch.py USER --out portfolio/repos.json(パブリックAPI呼び出し2回、トークン不要)。
トップリポジトリを出力します。これらが使用できる唯一の事実です。星、ユーザー、結果を決して捏造しないでください。
2 · 計画(確認してから portfolio/plan.json を書く)
1回のメッセージで確認し、ユーザーが「go」と言えば受け入れられるデフォルトを提示します。
- 誰が、誰のために: 名前、役割、対象者(採用担当者、クライアント、同僚)。デフォルト:GitHub名とbio。
- プロジェクト: 最強の4~9個を提案(星の数、直近のプッシュ、ホームページの有無、明確な説明)。ユーザーが選びます。
- スキルと経験: 検索可能にする(オプション)、連絡先リンク。
- 配置場所:
USER.github.io(ルート)またはリポジトリのdocs/フォルダ。URLは最終的なものでなければなりません。
次に plan.json を書きます(スキーマとコピールールは references/plan.md を参照)。コピールールの要約:見出しは8語以内、タグラインは「何を+誰のために」を示す。各プロジェクトには1行のピッチ(利点であり、スタックではない)と、そのリポジトリのREADMEまたはGitHubデータ内にある数値を引用するオプションの proof 行。決して捏造しないでください。
言語: 10言語のUI文字列は scripts/ui.json に同梱されています。ユーザー自身のコピーを翻訳するには、plan.t.<言語> を追加し、ネイティブライターがその言語で言うであろう意味に合わせて翻訳します。文字通りの逐語訳ではなく(references/plan.md、「翻訳」を参照)。その後、各言語をネイティブの読者として一度読み直し、直訳的に聞こえる部分を修正します。
3 · 構築とチェック
python3 scripts/build.py portfolio/repos.json portfolio/plan.json --out portfolio/site
python3 scripts/check.py portfolio/site
check.py は PASS を出力しなければなりません。公開前にブラウザで portfolio/site/index.html を開いて見てください。
タイプミスでの検索を試し、アラビア語(右から左)とダークテーマに切り替えてみてください。
4 · 公開(外部へ:まず確認)
ユーザーにページとターゲットを表示し、同意を得ます。次に:
bash scripts/publish.sh portfolio/site REPO_CLONE URL [--folder root|docs] --yes
コミット、プッシュ、必要に応じてPagesを有効にし、新しいビルドがライブになるまでポーリングし、LIVE … in N s と出力します。
5 · 測定と報告
4行以内で報告:ライブURL、LIVE 時間、check.py のスコア、PageSpeed Insights(pagespeed.web.dev、無料)またはインストールされているローカルの lighthouse によるLighthouse SEO / アクセシビリティ / パフォーマンス。
完了条件
check.pyがビルドされたサイトに対してPASSを出力している。- ページ上のすべてのプロジェクトがユーザーの実際のリポジトリであり、すべての数値がGitHubデータまたはREADMEに遡れる。
- ライブURLが新しいビルドを返している(
publish.shがLIVEを出力した)、またはユーザーが公開しないことを選択した。
絶対にしないこと
- プロジェクト、指標、雇用主、推薦文を捏造すること。代わりに尋ねること。
- ユーザーの同意なしにプッシュ、公開、Pagesの有効化を行うこと。
- トラッカー、分析、Cookie、外部スクリプトを追加すること。このページはサードパーティへのリクエストを行いません。
- 既存のサイトを、何が変わるかを示さずに上書きすること(
--yesなしのpublish.shはドライランです)。