@shinaps/skills 0.51.1 → 0.51.2
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.
- package/docs/install.md +1 -1
- package/package.json +1 -1
- package/plugins/shinaps-claude/.claude-plugin/plugin.json +1 -1
- package/plugins/shinaps-claude/references/linear/configuration.md +1 -1
- package/plugins/shinaps-claude/references/linear/release-qa.md +4 -2
- package/plugins/shinaps-codex/.codex-plugin/plugin.json +1 -1
- package/plugins/shinaps-codex/references/linear/configuration.md +1 -1
- package/plugins/shinaps-codex/references/linear/release-qa.md +4 -2
- package/plugins/shinaps-codex/skills/linear-execute/SKILL.md +1 -1
package/docs/install.md
CHANGED
|
@@ -26,7 +26,7 @@ npx @shinaps/skills@latest recover codex
|
|
|
26
26
|
設定の検証(`validate-linear-config`・`validate-managed-config`)、Managed Agents の操作(`managed`)、規約の機械検査と受け渡し(`lint`・`rule-snapshot`・`rule-coverage`、[規約の機械検査](lint.md))には、配布 CLI `shinaps-skills` を使います。CLI は plugin に含まれないため、利用中のスキルと同じ版を導入します。
|
|
27
27
|
|
|
28
28
|
```sh
|
|
29
|
-
npm install -g @shinaps/skills@0.51.
|
|
29
|
+
npm install -g @shinaps/skills@0.51.2
|
|
30
30
|
shinaps-skills --version
|
|
31
31
|
```
|
|
32
32
|
|
package/package.json
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
## 検証CLIと契約版
|
|
6
6
|
|
|
7
|
-
利用中のskillとCLIの版を確認し、0.51.
|
|
7
|
+
利用中のskillとCLIの版を確認し、0.51.2のskillには同じ版のnpm CLIを導入する(`npm install -g @shinaps/skills@0.51.2`)。pluginだけにはCLIは含まれない。導入・更新は検証に必要な準備として行い、検証のたびに `npx latest` を取得しない。
|
|
8
8
|
|
|
9
9
|
0.48.0から `config_version: 3`(操作ごとの許可の一覧を廃止し `constraints` を必須にした契約)だけを受理する。0.47.x以前のCLIと `$schema` のURLはv3を拒否し、0.48.0以降はv2を拒否するため、skill・CLI・`$schema` の版を揃えてから下の[旧設定の移行](#旧設定の移行)を行う。
|
|
10
10
|
|
|
@@ -32,7 +32,9 @@ Linear進行では、Claudeは実装担当のままで、リリースIssueの進
|
|
|
32
32
|
|
|
33
33
|
## 開発Issue: リリースへ引き継ぐ確認
|
|
34
34
|
|
|
35
|
-
開発IssueのDoneは、必要なQA・レビュー・developへの統合・引継ぎがそろった状態を表し、配布済みを意味しない。通常のPRのbaseはdevelopにし、PR
|
|
35
|
+
開発IssueのDoneは、必要なQA・レビュー・developへの統合・引継ぎがそろった状態を表し、配布済みを意味しない。通常のPRのbaseはdevelopにし、PRの本文に `Relates to <開発Issueのキー>` を書いて開発Issueと関連づける(共通のCLIはこのキーから出所を辿り、ブランチ名だけでは辿らない)。タイトルのキーと、`Relates to` 以外の関連づけの語(`Fixes`・`Part of` など)は使わない。LinearのGitHub連携は、これらでつないだIssueのステータスをPRの作成やmergeに合わせて変えることがあり、`Relates to` は変えない([Linearの資料](https://linear.app/docs/github))。ブランチ名のキーも同じ変更を起こしうるが、ブランチ名の付け方はこの方式では決めず、食い違いは次の段落のとおり直す。
|
|
36
|
+
|
|
37
|
+
開発Issueのステータスは、進行役が工程の証拠にもとづいて動かす(PRの作成やmergeはQA・レビューの証拠ではない)。PRの作成・mergeの後や次にIssueを読んだときに、連携が変えたステータスが証拠と食い違っていれば、証拠に合わせて直す。
|
|
36
38
|
|
|
37
39
|
進行役は、Local Agent QAの合格後、終了地点で止まる前(遅くともdevelopへmergeする前。収集はdevelopへのpushのたびに引継ぎを読む)に、開発Issueのコメントとして引継ぎを書く。材料は受入条件、Local Agent QAの記録、ソースの差分、Claudeの完了報告(未解決の事項など)。
|
|
38
40
|
|
|
@@ -76,7 +78,7 @@ Linear進行では、Claudeは実装担当のままで、リリースIssueの進
|
|
|
76
78
|
|
|
77
79
|
`status` の出力(以前のheadからの変更を含む)を読み、項目の重複・順序・まとめて確かめる方法を決め、`plan` に項目ごとの確かめる環境(staging・本番)と担当(agent・human)か、対象外の理由を記録する。本番で確かめる項目は、[QAと証拠](qa.md)の「本番でも環境差と主要導線を確認する」を材料に選ぶ。理由付きの「なし」は、計画が無くても対象外として扱われる。項目を対象外にするのは、資料から理由が決まる場合(他の項目と重複する、開発中に確かめ済みなど)だけにし、確かめられないことを理由にしない(受入条件の変更に当たるので[停止と人への確認](workflow.md#失敗確認停止の共通ルール)に従う)。
|
|
78
80
|
|
|
79
|
-
未整理の項目は、ソースの差分と受入条件から補い、引継ぎを直して `sync` を起動するか、対象外の理由を記録する。開発Issueを特定できないPRによる未整理は、そのPR
|
|
81
|
+
未整理の項目は、ソースの差分と受入条件から補い、引継ぎを直して `sync` を起動するか、対象外の理由を記録する。開発Issueを特定できないPRによる未整理は、そのPRの本文に `Relates to <開発Issueのキー>` を足して `sync` を起動する。利用者の判断が要る点だけを相談する。
|
|
80
82
|
|
|
81
83
|
### stagingの確認と記録
|
|
82
84
|
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
## 検証CLIと契約版
|
|
6
6
|
|
|
7
|
-
利用中のskillとCLIの版を確認し、0.51.
|
|
7
|
+
利用中のskillとCLIの版を確認し、0.51.2のskillには同じ版のnpm CLIを導入する(`npm install -g @shinaps/skills@0.51.2`)。pluginだけにはCLIは含まれない。導入・更新は検証に必要な準備として行い、検証のたびに `npx latest` を取得しない。
|
|
8
8
|
|
|
9
9
|
0.48.0から `config_version: 3`(操作ごとの許可の一覧を廃止し `constraints` を必須にした契約)だけを受理する。0.47.x以前のCLIと `$schema` のURLはv3を拒否し、0.48.0以降はv2を拒否するため、skill・CLI・`$schema` の版を揃えてから下の[旧設定の移行](#旧設定の移行)を行う。
|
|
10
10
|
|
|
@@ -32,7 +32,9 @@ Linear進行では、Claudeは実装担当のままで、リリースIssueの進
|
|
|
32
32
|
|
|
33
33
|
## 開発Issue: リリースへ引き継ぐ確認
|
|
34
34
|
|
|
35
|
-
開発IssueのDoneは、必要なQA・レビュー・developへの統合・引継ぎがそろった状態を表し、配布済みを意味しない。通常のPRのbaseはdevelopにし、PR
|
|
35
|
+
開発IssueのDoneは、必要なQA・レビュー・developへの統合・引継ぎがそろった状態を表し、配布済みを意味しない。通常のPRのbaseはdevelopにし、PRの本文に `Relates to <開発Issueのキー>` を書いて開発Issueと関連づける(共通のCLIはこのキーから出所を辿り、ブランチ名だけでは辿らない)。タイトルのキーと、`Relates to` 以外の関連づけの語(`Fixes`・`Part of` など)は使わない。LinearのGitHub連携は、これらでつないだIssueのステータスをPRの作成やmergeに合わせて変えることがあり、`Relates to` は変えない([Linearの資料](https://linear.app/docs/github))。ブランチ名のキーも同じ変更を起こしうるが、ブランチ名の付け方はこの方式では決めず、食い違いは次の段落のとおり直す。
|
|
36
|
+
|
|
37
|
+
開発Issueのステータスは、進行役が工程の証拠にもとづいて動かす(PRの作成やmergeはQA・レビューの証拠ではない)。PRの作成・mergeの後や次にIssueを読んだときに、連携が変えたステータスが証拠と食い違っていれば、証拠に合わせて直す。
|
|
36
38
|
|
|
37
39
|
進行役は、Local Agent QAの合格後、終了地点で止まる前(遅くともdevelopへmergeする前。収集はdevelopへのpushのたびに引継ぎを読む)に、開発Issueのコメントとして引継ぎを書く。材料は受入条件、Local Agent QAの記録、ソースの差分、Claudeの完了報告(未解決の事項など)。
|
|
38
40
|
|
|
@@ -76,7 +78,7 @@ Linear進行では、Claudeは実装担当のままで、リリースIssueの進
|
|
|
76
78
|
|
|
77
79
|
`status` の出力(以前のheadからの変更を含む)を読み、項目の重複・順序・まとめて確かめる方法を決め、`plan` に項目ごとの確かめる環境(staging・本番)と担当(agent・human)か、対象外の理由を記録する。本番で確かめる項目は、[QAと証拠](qa.md)の「本番でも環境差と主要導線を確認する」を材料に選ぶ。理由付きの「なし」は、計画が無くても対象外として扱われる。項目を対象外にするのは、資料から理由が決まる場合(他の項目と重複する、開発中に確かめ済みなど)だけにし、確かめられないことを理由にしない(受入条件の変更に当たるので[停止と人への確認](workflow.md#失敗確認停止の共通ルール)に従う)。
|
|
78
80
|
|
|
79
|
-
未整理の項目は、ソースの差分と受入条件から補い、引継ぎを直して `sync` を起動するか、対象外の理由を記録する。開発Issueを特定できないPRによる未整理は、そのPR
|
|
81
|
+
未整理の項目は、ソースの差分と受入条件から補い、引継ぎを直して `sync` を起動するか、対象外の理由を記録する。開発Issueを特定できないPRによる未整理は、そのPRの本文に `Relates to <開発Issueのキー>` を足して `sync` を起動する。利用者の判断が要る点だけを相談する。
|
|
80
82
|
|
|
81
83
|
### stagingの確認と記録
|
|
82
84
|
|
|
@@ -41,7 +41,7 @@ Issueの責務・受入条件・ステータスを、実際の成果と一致さ
|
|
|
41
41
|
| auto経路の起動・観測・resume | [references/claude-cli.md](../../references/linear/claude-cli.md) |
|
|
42
42
|
| manual経路の宛先・依頼・報告 | [references/bridge.md](../../references/linear/bridge.md) |
|
|
43
43
|
| QAの実施・記録・素材 | [references/qa.md](../../references/linear/qa.md) |
|
|
44
|
-
| リリースQA
|
|
44
|
+
| リリースQAの方式を採用した作業先での通常のPRの書き方・引継ぎの記録と、リリースIssueの進行(5工程とは別) | [references/release-qa.md](../../references/linear/release-qa.md) |
|
|
45
45
|
| Cycle完了QA・報告 | [references/cycle-report.md](../../references/linear/cycle-report.md) |
|
|
46
46
|
|
|
47
47
|
コミットはClaudeへ差分確定を依頼して `shinaps:commit` で行い(manualは上の経路の項に従う)、Codexは各コミットの単位照合と全体照合を行う。pushとPRの作成は `shinaps:create-pr`、公開は `shinaps:release` に従い、このスキルで手順を持たない。これらのスキルには実効到達点・`constraints` と前工程の結果を渡す。必要な条件が揃えば再確認せずに進み、個別スキルの完了だけで進行を終えず、[終了条件](../../references/linear/execution.md)まで継続する。
|