@shinaps/skills 0.20.0 → 0.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/package.json +1 -1
  2. package/plugins/shinaps-claude/.claude-plugin/plugin.json +1 -1
  3. package/plugins/shinaps-claude/skills/linear/SKILL.md +4 -2
  4. package/plugins/shinaps-claude/skills/linear/references/configuration.md +1 -1
  5. package/plugins/shinaps-claude/skills/linear/references/issue.md +14 -1
  6. package/plugins/shinaps-codex/.codex-plugin/plugin.json +1 -1
  7. package/plugins/shinaps-codex/skills/linear/SKILL.md +3 -3
  8. package/plugins/shinaps-codex/skills/linear/references/configuration.md +1 -1
  9. package/plugins/shinaps-codex/skills/linear/references/issue.md +14 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@shinaps/skills",
3
- "version": "0.20.0",
3
+ "version": "0.21.0",
4
4
  "description": "Install Shinaps AI workflows and custom agents for Codex",
5
5
  "type": "module",
6
6
  "bin": {
package/plugins/shinaps-claude/.claude-plugin/plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "shinaps",
3
3
  "description": "Shinaps AIの開発ワークフロー。プロジェクトの指示から条件を読み、調査・設計・実装・簡素化・レビュー・コミット・PR・リリースとLinearでの開発進行を支援する12スキル。",
4
- "version": "0.20.0",
4
+ "version": "0.21.0",
5
5
  "author": {
6
6
  "name": "shinaps",
7
7
  "email": "ryuta@shinaps.jp"
package/plugins/shinaps-claude/skills/linear/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: linear
3
- description: Codexが進行するLinearの開発で、AI Terminal Bridge経由の実装・修正依頼を受けて実行し、結果、許可されたコミット、人のレビュー・コミット完了をCodexへ報告する。利用者から明示的に依頼されたIssue整理も行う。
3
+ description: Codexが進行するLinearの開発で、AI Terminal Bridge経由の実装・修正依頼を受けて実行し、結果、許可されたコミット、人のレビュー・コミット完了をCodexへ報告する。利用者から明示的に依頼されたIssue整理と、作業先の規約か依頼が求める着手前のIssueへの紐づけも行う。
4
4
  ---
5
5
 
6
6
  # Linearの開発でClaudeが行うこと
@@ -19,11 +19,12 @@ Codexから許可範囲と受入条件を伴う実装・修正の依頼をBridge
19
19
 
20
20
  依頼を受けたら、[references/workflow.md](references/workflow.md) の「担当と窓口」「再確認せず進める条件」「Bridgeでの依頼と報告」を読む。依頼に添えられたプロジェクトの補足と参照先も読む。
21
21
 
22
- 他の資料は次の場合だけ読む: 依頼で指示された場合、Issue整理を依頼された場合（[references/issue.md](references/issue.md)）、設定を読む必要がある場合（[references/configuration.md](references/configuration.md) の「設定の読み方」）。
22
+ 他の資料は次の場合だけ読む: 依頼で指示された場合、Issue整理を依頼された場合（[references/issue.md](references/issue.md)）、Codexの依頼なしで実作業を依頼された場合（[references/issue.md](references/issue.md) の「着手前に作業をIssueへ紐づける」）、設定を読む必要がある場合（[references/configuration.md](references/configuration.md) の「設定の読み方」）。
23
23
 
24
24
  ## 依頼を受けて実行する
25
25
 
26
26
  - 依頼の範囲・受入条件・Gitの作業ディレクトリ・ブランチ・既存差分・許可範囲を確認する。
27
+ - Codexから依頼された実装・修正は、依頼の対象Issueに紐づく。Claudeは別のIssueを作らない。
27
28
  - 実装・修正には `shinaps:dev` を使う。`shinaps:dev` は内部で簡素化・規約照合・レビューを行うので、これらを別に起動しない。`shinaps:dev` を使えない場合は、独自の手順で代わりに実装せずCodexへ報告する。
28
29
  - `shinaps:dev` の委託（サブエージェントや別のCLI）は、依頼の許可範囲に `dev_delegation` が書かれている場合だけ使う。許可範囲に `dev_delegation` がない依頼では委託しない。worktreeの作成は含まない。
29
30
  - `shinaps:dev` が利用者に確認する場面（計画の判断、不明点、承認）では、人ではなくCodexへ相談する。Codexが既存の合意で答えた内容を人へ再確認しない。仕様・受入条件・許可範囲の変更が必要な場合は、Codexが人に確認する。
@@ -43,5 +44,6 @@ Codexから許可範囲と受入条件を伴う実装・修正の依頼をBridge
43
44
 
44
45
  ## Codexの依頼なしで起動された場合
45
46
 
47
+ - 利用者から直接依頼された実作業（開発進行の依頼を除く）は、着手前に [references/issue.md](references/issue.md) の「着手前に作業をIssueへ紐づける」に従う。Issueの作成は利用者がその場で依頼した場合だけ行い、設定の `issue_update` を根拠にしない。
46
48
  - 利用者から明示的にIssueの整理を依頼された場合は、[references/issue.md](references/issue.md) に従って整理する。Issueの更新は、依頼で指定された範囲だけにする（設定の有無にかかわらない）。
47
49
  - 開発進行（実装からQAを経て終了地点までの進行）を依頼された場合、Claudeは進行役を兼ねない。作業先リポジトリの設定で `bridge_request` が許可され、BridgeでCodexのセッションを特定できる場合は、[references/workflow.md](references/workflow.md) の「開発進行の引き渡し」の項目を添えてCodexへ引き渡す。設定は [references/configuration.md](references/configuration.md) の「設定の読み方」に従って読む。許可や相手のセッションがない場合は、必要な準備（設定、Codexセッションの起動、Bridgeの導入）を利用者へ案内する。
package/plugins/shinaps-claude/skills/linear/references/configuration.md CHANGED
@@ -67,7 +67,7 @@
67
67
 
68
68
  | 値 | 許可する操作 |
69
69
  | --- | --- |
70
- | `issue_update` | 対象のteam・projectの中で、利用者が任せたIssue・Cycleの範囲に対する運用上の更新（本文・コメント・状態・依存・Linearへの添付、整理で必要になったIssueの作成・分割）。チーム設定の変更、未合意の範囲・期限の変更、Cycle外への進行、Issueの削除、外部への送信を含めない |
70
+ | `issue_update` | 対象のteam・projectの中で、利用者が任せたIssue・Cycleの範囲に対する運用上の更新（本文・コメント・状態・依存・Linearへの添付、整理で必要になったIssueの作成・分割）と、利用者から任された目的の作業を着手前にIssueへ紐づけるための作成（[issue.md](issue.md) の「着手前に作業をIssueへ紐づける」）。チーム設定の変更、未合意の範囲・期限の変更、Cycle外への進行、Issueの削除、外部への送信を含めない |
71
71
  | `bridge_request` | BridgeによるCodexからClaudeへの実装・修正の依頼と、ClaudeからCodexへの開発進行の引き渡し |
72
72
  | `stage` | レビュー・コミットの対象差分だけをステージする |
73
73
  | `commit` | 対象Issueの差分を、Local Agent QAの合格と `human_code_review` に従った工程の後に、`shinaps:commit` でローカルにコミットする。AIのコミットには `stage` の許可も併せて必要。push・PR・履歴の書き換え、人のレビューの省略を含めない。`document_only_changes: ai_commit` による文書だけの変更のコミットは、`commit` がなくても行える（`stage` は必要） |
package/plugins/shinaps-claude/skills/linear/references/issue.md CHANGED
@@ -4,6 +4,19 @@
4
4
 
5
5
  共通ルールはスキルとリポジトリ、製品仕様はその正本、個別Issueの判断と結果はIssueに置く。共通手順をIssueへ転載しない。
6
6
 
7
+ ## 着手前に作業をIssueへ紐づける
8
+
9
+ 作業先リポジトリの規約が作業のIssueへの紐づけを求める場合、または利用者が紐づけを明示的に依頼した場合に、この手順で紐づける。進捗・完了を管理する作業は、開発・調査・運用・設定変更・文書整理を問わず、またGit変更の有無にかかわらず、実作業の着手前に一つのIssueへ紐づける。原則として一つの目的を一つのIssueで管理する。その場の質問・相談・短い状態確認と、紐づけたIssueの中の細かな手順には新しいIssueを作らない。相談から実作業へ移る時点で適用する。紐づけに必要な設定の確認・初期設定と、そのためのIssueの読み取り・検索・整理は紐づけの一部であり、それ自体のIssueを作らない。
10
+
11
+ 1. 作業先リポジトリと、紐づけ先のworkspace・team・projectを決める。紐づけ先は、[configuration.md](configuration.md) の「設定の読み方」に従って読んだ作業先リポジトリの設定の `target`、または利用者がその場で指定した先にする。
12
+ 2. 決めた先で、目的と作業先に合う既存Issue（依頼で示されたIssue、未完了のIssue、作業を含む親・関連Issue）を探し、あれば再利用する。作業が既存Issueの範囲に入る場合は、そのIssueの中の手順として扱う。
13
+ 3. 該当がなければ、利用者から任された目的について、下の「共通Issueテンプレート」に従って作成する。作成は、各版のSKILL.mdと [configuration.md](configuration.md) の「許可」で認められた範囲だけで行う。新しいIssueをCycleへ入れるのは、既存の合意か明示依頼がある場合だけにする（「Cycle・期限・見積もり」）。作成の後は読み戻し、結果が不明なら現状を確かめてから再試行し（「要件を整理する手順」）、同じ目的のIssueを重ねて作らない。
14
+ 4. 使うIssueのリンクを、会話またはBridgeの依頼・報告に示してから実作業に入る。
15
+
16
+ 紐づけ先が決まらない、接続できない、または新しいIssueの作成が必要だがその許可がない場合は、別のworkspace・team・projectや別のリポジトリの設定で代わりに作成・更新しない。紐づけを必要とする実作業の前で止まり、理由と必要な判断・準備（作成の許可がない場合はIssue案）を利用者に伝え、回答を得てから再開する。
17
+
18
+ Issueの作成・紐づけは作業の記録であり、担当・人のレビュー・終了地点・継続の範囲を変えない。コミット・push・公開・外部への送信の許可を追加せず、開発進行・Cycleの継続・ゴールの設定を始めない。
19
+
7
20
  ## 要件を整理する手順
8
21
 
9
22
  1. 正しいアカウント・workspace・teamで、本文・親子・依存・Cycle・ラベル・状態・コメントを読む。一覧は最後のページまで取得する。関連仕様の正本・実装・会話の合意と照合する。
@@ -27,7 +40,7 @@
27
40
  | 取りまとめだけの親Issue | CycleとEstimateを付けない |
28
41
 
29
42
  - 期限は「いつまでに必要か」、Cycleは「いつ取り組むか」を表す。前提作業を後続のCycleに置かない。時期未定の案に予定を作らない。見積もり・期限・Cycle範囲の変更は、既存の合意または明示的な依頼の範囲でだけ行う。
30
- - 依存Issueを作るのは、独立した担当・完了条件が必要な作業だけ。既存のIssueを優先する。機能専用ならサブIssue、共有の準備なら独立したIssueにする。その場の質問ごとにIssueを作らない。
43
+ - 依存Issueを作るのは、独立した担当・完了条件が必要な作業だけ。既存のIssueを優先する。機能専用ならサブIssue、共有の準備なら独立したIssueにする。
31
44
 
32
45
  ## 共通Issueテンプレート
33
46
 
package/plugins/shinaps-codex/.codex-plugin/plugin.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "shinaps",
3
- "version": "0.20.0",
3
+ "version": "0.21.0",
4
4
  "description": "Shinaps AIのCodex向け開発ワークフロー",
5
5
  "skills": "./skills/"
6
6
  }
package/plugins/shinaps-codex/skills/linear/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: linear
3
- description: LinearのIssue・Cycleを起点に、Issue整理、開発の進行とAgent QA、AI Terminal Bridge経由のClaudeへの実装依頼、設定に従った人のレビューの確認または省略の記録、許可されたコミットの依頼と確認、設定した終了地点までの進行とCycle完了報告を行う。.shinaps/linear.yamlの初期設定・変更にも使う。
3
+ description: LinearのIssue・Cycleを起点に、作業先の規約か依頼が求める着手前のIssueへの紐づけ、Issue整理、開発の進行とAgent QA、AI Terminal Bridge経由のClaudeへの実装依頼、設定に従った人のレビューの確認または省略の記録、許可されたコミットの依頼と確認、設定した終了地点までの進行とCycle完了報告を行う。.shinaps/linear.yamlの初期設定・変更にも使う。
4
4
  ---
5
5
 
6
6
  # Linearを起点に開発を進める
@@ -31,7 +31,7 @@ Codexから許可範囲と受入条件を伴う実装・修正の依頼をBridge
31
31
  ## 設定と補足を読む
32
32
 
33
33
  - 設定の所在・読み方・補足との関係・不足時の止め方は、[references/configuration.md](references/configuration.md) の「設定の読み方」に従う。
34
- - 作業先リポジトリは、Issue本文の「対象・範囲外」で特定する。ローカルの場所は、自分の作業ディレクトリ、`list_sessions` の `project_path`、利用者の指示から確認し、確定できなければ一問確認する。ローカルの絶対パスをIssueに書かない。
34
+ - 作業先リポジトリは、Issue本文の「対象・範囲外」で特定する。Issueがまだない作業では、依頼の内容で特定する。ローカルの場所は、自分の作業ディレクトリ、`list_sessions` の `project_path`、利用者の指示から確認し、確定できなければ一問確認する。ローカルの絶対パスをIssueに書かない。
35
35
  - 操作の許可は作業先リポジトリの設定で決める。同じLinear projectに属するだけでは、別のリポジトリの作業を現在の設定に含めない。作業先を特定できないIssueや、作業先に設定がないIssueでは、開発進行を始めない。
36
36
  - 設定がない場合は、Issueの読み取り、整理案、明示依頼された更新だけを行い、初期設定を案内する。
37
37
 
@@ -40,7 +40,7 @@ Codexから許可範囲と受入条件を伴う実装・修正の依頼をBridge
40
40
  | 作業 | 読む資料 |
41
41
  | --- | --- |
42
42
  | 初期設定・設定変更 | [references/configuration.md](references/configuration.md) |
43
- | Issueの作成・整理・本文の更新 | [references/issue.md](references/issue.md) |
43
+ | 着手前の紐づけ、Issueの作成・整理・本文の更新 | [references/issue.md](references/issue.md) |
44
44
  | 担当、工程、待ち状態、Bridge、人への依頼、継続の範囲 | [references/workflow.md](references/workflow.md) |
45
45
  | QAの実施・記録・素材 | [references/qa.md](references/qa.md) |
46
46
  | Cycle完了QA・報告 | [references/cycle-report.md](references/cycle-report.md) |
package/plugins/shinaps-codex/skills/linear/references/configuration.md CHANGED
@@ -67,7 +67,7 @@
67
67
 
68
68
  | 値 | 許可する操作 |
69
69
  | --- | --- |
70
- | `issue_update` | 対象のteam・projectの中で、利用者が任せたIssue・Cycleの範囲に対する運用上の更新（本文・コメント・状態・依存・Linearへの添付、整理で必要になったIssueの作成・分割）。チーム設定の変更、未合意の範囲・期限の変更、Cycle外への進行、Issueの削除、外部への送信を含めない |
70
+ | `issue_update` | 対象のteam・projectの中で、利用者が任せたIssue・Cycleの範囲に対する運用上の更新（本文・コメント・状態・依存・Linearへの添付、整理で必要になったIssueの作成・分割）と、利用者から任された目的の作業を着手前にIssueへ紐づけるための作成（[issue.md](issue.md) の「着手前に作業をIssueへ紐づける」）。チーム設定の変更、未合意の範囲・期限の変更、Cycle外への進行、Issueの削除、外部への送信を含めない |
71
71
  | `bridge_request` | BridgeによるCodexからClaudeへの実装・修正の依頼と、ClaudeからCodexへの開発進行の引き渡し |
72
72
  | `stage` | レビュー・コミットの対象差分だけをステージする |
73
73
  | `commit` | 対象Issueの差分を、Local Agent QAの合格と `human_code_review` に従った工程の後に、`shinaps:commit` でローカルにコミットする。AIのコミットには `stage` の許可も併せて必要。push・PR・履歴の書き換え、人のレビューの省略を含めない。`document_only_changes: ai_commit` による文書だけの変更のコミットは、`commit` がなくても行える（`stage` は必要） |
package/plugins/shinaps-codex/skills/linear/references/issue.md CHANGED
@@ -4,6 +4,19 @@
4
4
 
5
5
  共通ルールはスキルとリポジトリ、製品仕様はその正本、個別Issueの判断と結果はIssueに置く。共通手順をIssueへ転載しない。
6
6
 
7
+ ## 着手前に作業をIssueへ紐づける
8
+
9
+ 作業先リポジトリの規約が作業のIssueへの紐づけを求める場合、または利用者が紐づけを明示的に依頼した場合に、この手順で紐づける。進捗・完了を管理する作業は、開発・調査・運用・設定変更・文書整理を問わず、またGit変更の有無にかかわらず、実作業の着手前に一つのIssueへ紐づける。原則として一つの目的を一つのIssueで管理する。その場の質問・相談・短い状態確認と、紐づけたIssueの中の細かな手順には新しいIssueを作らない。相談から実作業へ移る時点で適用する。紐づけに必要な設定の確認・初期設定と、そのためのIssueの読み取り・検索・整理は紐づけの一部であり、それ自体のIssueを作らない。
10
+
11
+ 1. 作業先リポジトリと、紐づけ先のworkspace・team・projectを決める。紐づけ先は、[configuration.md](configuration.md) の「設定の読み方」に従って読んだ作業先リポジトリの設定の `target`、または利用者がその場で指定した先にする。
12
+ 2. 決めた先で、目的と作業先に合う既存Issue（依頼で示されたIssue、未完了のIssue、作業を含む親・関連Issue）を探し、あれば再利用する。作業が既存Issueの範囲に入る場合は、そのIssueの中の手順として扱う。
13
+ 3. 該当がなければ、利用者から任された目的について、下の「共通Issueテンプレート」に従って作成する。作成は、各版のSKILL.mdと [configuration.md](configuration.md) の「許可」で認められた範囲だけで行う。新しいIssueをCycleへ入れるのは、既存の合意か明示依頼がある場合だけにする（「Cycle・期限・見積もり」）。作成の後は読み戻し、結果が不明なら現状を確かめてから再試行し（「要件を整理する手順」）、同じ目的のIssueを重ねて作らない。
14
+ 4. 使うIssueのリンクを、会話またはBridgeの依頼・報告に示してから実作業に入る。
15
+
16
+ 紐づけ先が決まらない、接続できない、または新しいIssueの作成が必要だがその許可がない場合は、別のworkspace・team・projectや別のリポジトリの設定で代わりに作成・更新しない。紐づけを必要とする実作業の前で止まり、理由と必要な判断・準備（作成の許可がない場合はIssue案）を利用者に伝え、回答を得てから再開する。
17
+
18
+ Issueの作成・紐づけは作業の記録であり、担当・人のレビュー・終了地点・継続の範囲を変えない。コミット・push・公開・外部への送信の許可を追加せず、開発進行・Cycleの継続・ゴールの設定を始めない。
19
+
7
20
  ## 要件を整理する手順
8
21
 
9
22
  1. 正しいアカウント・workspace・teamで、本文・親子・依存・Cycle・ラベル・状態・コメントを読む。一覧は最後のページまで取得する。関連仕様の正本・実装・会話の合意と照合する。
@@ -27,7 +40,7 @@
27
40
  | 取りまとめだけの親Issue | CycleとEstimateを付けない |
28
41
 
29
42
  - 期限は「いつまでに必要か」、Cycleは「いつ取り組むか」を表す。前提作業を後続のCycleに置かない。時期未定の案に予定を作らない。見積もり・期限・Cycle範囲の変更は、既存の合意または明示的な依頼の範囲でだけ行う。
30
- - 依存Issueを作るのは、独立した担当・完了条件が必要な作業だけ。既存のIssueを優先する。機能専用ならサブIssue、共有の準備なら独立したIssueにする。その場の質問ごとにIssueを作らない。
43
+ - 依存Issueを作るのは、独立した担当・完了条件が必要な作業だけ。既存のIssueを優先する。機能専用ならサブIssue、共有の準備なら独立したIssueにする。
31
44
 
32
45
  ## 共通Issueテンプレート
33
46