Skip to content
cccskills
FreePublished on GitHub

project-sync

PJ ドキュメントの同期。PJ CLAUDE.md の更新依頼、ドキュメント整理依頼、コード変更後の CLAUDE.md・README・API 仕様への反映依頼(npm script・環境変数・API 追加等)の時に使用。user-level 設定との整合性確認も行う。

境界: CLAUDE.md が未整備の新規 PJ は組み込みの /init。

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md4.1 KB
  • references/claude-md-template.md2.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

PJドキュメント同期

PJ の CLAUDE.md・.claude/・人間向けドキュメントを、コードと user-level 設定に合わせる。CLAUDE.md のサイズ・強調・命令形・理由の添え方は ~/.claude/context/claude-customization-guide.md「3. CLAUDE.md設計原則」に従う(公式の目標は1ファイル200行未満)。

コード変更起点の差分同期

コード変更後の依頼では、フル同期でなく変更起点の差分同期を行う。

  1. git diff <base-branch> --name-only と git diff <base-branch> で変更を読む
  2. 更新対象を決める
カテゴリ例更新対象
コマンド変更npm script追加CLAUDE.md, README.md
API変更エンドポイント追加API仕様書
設定変更環境変数追加README.md
アーキテクチャ変更新規レイヤーCLAUDE.md
  1. 内部実装だけの変更・テストコードだけの変更・機能の変わらないリファクタは更新しない
  2. 更新提案を示し、承認後に反映する

フル同期

1. 現状把握

PJ の CLAUDE.md(と行数)、.claude/・.claude/rules/・docs/ の構成、.claude/settings.json(permissions.deny の Read ルール・claudeMdExcludes)、~/.claude/AGENTS.md と ~/.claude/context/ の一覧を読む。

2. 差分分析

項目確認内容
CLAUDE.md のサイズ肥大せず簡潔か
変数定義MEMORY_DIR, BASE_BRANCH があるか
品質チェックlint/format/typecheck/test コマンドがあるか
検証方針ローカル起動・テスト・E2E・スクショ・期待出力の指針があるか
レビュー方針critical 不変条件・検証境界・エラーハンドリング方式・却下類型があるか(無ければ追加を提案)
詳細の置き場タスク限定の詳細を .claude/context/ に出し、Read-when で誘導しているか(@ import は毎セッション常駐する)
分離原則人間向け(README.md・docs/)とエージェント向け(CLAUDE.md・.claude/context/・.claude/rules/)が分かれているか
コンテキスト除外秘匿・不要パスが permissions.deny の Read ルールで除外されているか。.claudeignore は公式機能に存在しないので、残っていれば削除を提案する
.claude/rules/パス固有ルールが活用されているか
user-level との重複user-level の AGENTS.md・context に既にある内容(委譲の強制など)を繰り返していないか
強制表現「こまめに」「必ず」「逐次」等の強制表現を多用していないか

3. 更新提案の作成

references/claude-md-template.md の雛形・書かない内容・提案の書式に沿って書く。

4. ユーザー確認

選択肢を示して確かめる(Claude Code: AskUserQuestion)。

  1. 更新提案の承認
  2. 削除対象の確認(誤削除を防ぐため)
  3. PJ 固有の追加要件

5. 実行

承認後に、CLAUDE.md の更新・コンテキスト除外の設定・.claude/rules/ と .claude/context/ の作成(必要な場合)・不要ファイルの削除・移動とリネームを行う。

不要ファイルの判断基準

判断条件
削除古い agent 定義、重複ドキュメント、空ファイル、user-level と重複する指示
移動エージェント向けの内容が docs/ にある → .claude/context/
統合類似内容の複数ファイル → 1ファイルに
保持人間向けドキュメント(README, docs/)、PJ 固有設定

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

コードベース全体のレビュー・監査。perf/sec/test/arch/cq/docs の6観点を並列委譲し、優先度付き issue ファイルと観点サマリをメモリディレクトリに生成する。コードベース全体の監査・定期レビュー・リリース前品質確認の依頼時、/codebase-review 実行時に使用。境界: PR 単位は pr-review、自ブランチの提出前確認は self-review。

The English summary is being prepared. Showing the original description.

ukwhatn/.claude4Updated Oct 19, 2026

commit

Free

変更を git-cz 形式でコミットする。リポジトリの直コミット可否の判定手順と、push 後の CI・conflict の確認を含む。/commit 実行時、「コミットして」「pushして」等の依頼時に使用。--push 引数または「pushして」の依頼で push も行う。境界: PR 作成は create-draft-pr、PR コメントへの対応コミットは pr-comment から呼ばれる。

The English summary is being prepared. Showing the original description.

ukwhatn/.claude4Updated Oct 19, 2026

PR を Draft で作成する。変更をローカルで動かして確かめ、画面が変わるならスクリーンショットを gh の --attach で貼り、PR テンプレートを全セクション埋めて対象 repo の既存 PR の分量に揃え、出した後は CI・レビュー・マージを Monitor で見張る。PR 作成の依頼時、実装が一段落して PR 化する時、/create-draft-pr 実行時に使用(gh pr create を直接実行しない)。引数でベースブランチを指定できる。境界: 個別レビューコメントへの対応は pr-comment、PR 全体のレビューは pr-review、複数 PR 規模の計画は plan-feature-prs。

The English summary is being prepared. Showing the original description.

ukwhatn/.claude4Updated Oct 19, 2026

スキルを新規作成する。「スキルを作って」「この手順をスキル化して」等の依頼時、/create-skill 実行時に使用。AGENTS.md・context・既存スキルと整合させ、重複・競合を避ける。境界: 既存スキル・指示ファイルの修正は update-inst、指示ファイル全体の監査は instructions-audit。

The English summary is being prepared. Showing the original description.

ukwhatn/.claude4Updated Oct 19, 2026

抽象的な要件・事業側の要求を深掘りし、既存実装との整合を確認して実装マスタとシステム要件書を作成する。「こういう機能を作りたい」「この要求を満たす機能を設計して」等の抽象要件の提示時、既存機能の拡張や Phase 分割の要件定義開始時、/design-feature 実行時に使用。境界: 要件確定後の実装計画書・PR 分割と実装進行は plan-feature-prs。

The English summary is being prepared. Showing the original description.

ukwhatn/.claude4Updated Oct 19, 2026

画面の設計判断(ナビゲーション・重ね方・通知と空状態と読み込み・外枠とトークンと状態表現)の型を決定表で選び、アプリ内の全画面で揃える。画面・ページ・レイアウト・ナビゲーション・ダイアログ・コンポーネントを新しく作る・作り直す時、モックやダッシュボードを作る時、サイドバー・タブ・モーダル・シート・toast・バナー・空状態のどれを使うか決める時に使用。PJ に components.json があれば shadcn の部品とトークンへの対応も扱う。主要なデザインシステム(Material・HIG・Carbon・Primer・Atlassian・Fluent・GOV.UK・NN/g・WAI-ARIA APG・WCAG)の一致点を規則にし、食い違いの採否を定めてある。境界: 画面の文言は writing-ui-text、画面に何を出すかと提示前の完了基準は context/ui-artifact-standards.md、コードの実装原則は writing-code、shadcn 部品の API と組み立ては shadcn。

The English summary is being prepared. Showing the original description.

ukwhatn/.claude4Updated Oct 19, 2026

See all skills by ukwhatn

Report a problem with this skill