sync: update from private repo (6fcb0d0)

2026-06-04 03:03:12 +00:00
parent 21be01b699
commit 57685d995c
36 changed files with 2467 additions and 391 deletions
@@ -49,19 +49,37 @@ Piece は「タスクの種類ごとの実行手順」を定義したもので

 > このほか組織が独自に追加した Piece もここに加わります。利用可能なツールの一覧は [ツール一覧](16-tools.md) を参照。

-## カスタム Piece を作る（admin / パワーユーザー）
+## Default Pieces と Custom Pieces
+
+Pieces ページでは「**Default Pieces**」と「**Custom Pieces**」の 2 つのセクションが表示されます。
+
+**Default Pieces（組み込み）**
+
+- システムに同梱され、git で管理されている Piece です
+- **削除は非 admin ユーザーには禁止**されています（削除は admin のみ）
+- **編集は admin のみ** 可能です（非 admin ユーザーは読み取り専用）
+- 非 admin ユーザーは `⎘` ボタンで **「Custom に複製」** でき、別名の Custom Piece として自分用にカスタマイズできます
+
+**Custom Pieces（ユーザー作成）**
+
+- ユーザーが作成した Piece で、自分のユーザーフォルダ配下に保存されます
+- 自分で作った Custom Piece は編集・削除できます
+- Custom Piece は **Default Piece と同名にできません**（別名を付けてください）
+- タスク実行時、Custom Piece はそのオーナーのユーザーフォルダから読み込まれ、正しく実行されます
+
+## カスタム Piece を作る

 ### 方法 1: piece-builder に依頼する

 タスクを作成し、「○○用の Piece を作って」と書きます。`piece-builder` が選ばれ、要件をヒアリングしながら movement 構成・ツール選定・遷移ルールを設計して Piece を保存します。既存 Piece の改良で済む場合はそれを優先します。

-### 方法 2: Pieces ページで手動編集する
+### 方法 2: Pieces ページで手動作成する

-admin は TopBar → Pieces から Piece の一覧・閲覧・新規作成・編集ができます。YAML を直接編集して保存すると `pieces/{name}.yaml` に反映されます。
+TopBar → Pieces → Custom Pieces セクションの `+` から新規作成できます。YAML を直接編集して保存できます。**Default Piece と同名の名前は使えません**（別名を付けてください）。

-### 方法 3: 自分専用に fork する
+### 方法 3: Default Piece を複製してカスタマイズする

-組み込み Piece を少しだけ変えたい場合、ユーザーフォルダ配下に同名の Piece を置くと、自分のタスクではそちらが優先されます。組み込み定義はそのまま残ります。
+Default Piece の行にある `⎘` ボタンをクリックすると「複製名」の入力ダイアログが開きます。別名を入力して複製すると、Custom Pieces セクションに追加されます。元の Default Piece はそのまま残ります。複製後の Custom Piece は自分で自由に編集できます。

 ## Piece を編集するときの勘所