スキル一覧に戻る
ukwhatn

project-sync

by ukwhatn

~/.claude のうち公開可能なもの

2🍴 1📅 2026年1月23日
GitHubで見るManusで実行

SKILL.md


name: project-sync description: PJドキュメント同期。PJ CLAUDE.mdの更新依頼時やドキュメント整理依頼時に使用。user-level設定との整合性確認、ドキュメント分離原則の適用、不要ファイル削除を実施。

PJドキュメント同期

トリガー条件

  • PJ CLAUDE.mdの更新を依頼された場合
  • ドキュメント構造の整理を依頼された場合
  • 「user-level CLAUDE.mdに合わせて」と指示された場合

ドキュメント分離原則

対象配置場所用途
人間向けREADME.md, docs/プロジェクト説明、API仕様、アーキテクチャ図
エージェント向けCLAUDE.md, .claude/context/AI向け指示、作業ルール

実行手順

1. 現状把握

# PJ CLAUDE.mdの確認
cat CLAUDE.md 2>/dev/null || echo "CLAUDE.md not found"
wc -l CLAUDE.md 2>/dev/null

# ドキュメント構造の確認
ls -la .claude/ 2>/dev/null
ls -la docs/ 2>/dev/null

# user-level設定の確認
cat ~/.claude/CLAUDE.md
ls ~/.claude/context/

2. 差分分析

以下を確認:

項目確認内容
CLAUDE.md行数60行以下か
変数定義MEMORY_DIR, BASE_BRANCH があるか
品質チェックlint/format/typecheck/test コマンドがあるか
@参照詳細をcontext/に委譲しているか
分離原則人間向け/エージェント向けが分離されているか

3. 更新提案の作成

## 更新提案

### CLAUDE.md
**現状:** XX行
**提案:** 以下に簡素化

```markdown
# <PJ名>

## 変数
MEMORY_DIR=.local/
BASE_BRANCH=develop

## 品質チェック
```bash
npm run lint
npm run format
npm run typecheck
npm test

特記事項

  • [PJ固有ルール]

### 削除対象
- [ ] <不要ファイル1>(理由: ...)

### 移動対象
- [ ] <ファイル> → <移動先>(理由: ...)

### 新規作成
- [ ] .claude/context/<name>.md(用途: ...)

4. ユーザー確認

AskUserQuestionで以下を確認:

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

5. 実行

承認後、以下を実行:

  1. CLAUDE.mdの更新(60行以下に)
  2. 不要ファイルの削除
  3. ファイルの移動・リネーム
  4. .claude/context/の作成(必要な場合)

6. 検証

# 行数確認
wc -l CLAUDE.md

# 構造確認
ls -la .claude/

# @参照の動作確認(手動)

CLAUDE.md設計原則

60行以下ルール

  • 詳細は@.claude/context/に委譲
  • Progressive Disclosure(段階的開示)を活用

必須セクション

# <PJ名>

## 変数
MEMORY_DIR=<path>
BASE_BRANCH=<branch>

## 品質チェック
[コマンド一覧]

## 特記事項
[PJ固有ルール - 簡潔に]

オプションセクション(必要な場合のみ)

  • アーキテクチャ概要(簡潔に)
  • 命名規則
  • 禁止事項

不要ファイルの判断基準

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

チェックリスト

  • CLAUDE.mdが60行以下
  • 変数(MEMORY_DIR, BASE_BRANCH)が定義済み
  • 品質チェックコマンドが記載済み
  • ドキュメント分離原則に従っている
  • 不要ファイルが削除済み
  • @参照が正しく設定済み

スコア

総合スコア

45/100

リポジトリの品質指標に基づく評価

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

0/5
タグ

1つ以上のタグが設定されている

0/5

レビュー

💬

レビュー機能は近日公開予定です