{"body":"","comments":[{"id":"IC_kwDOSsyR688AAAABcT4c1Q","author":{"login":"yukihito-jokyu"},"authorAssociation":"OWNER","body":"## 計画記録：docsの構成と成果物更新ルールを整える\n\n### 要点\nスキルとpluginの利用ガイド・導入案内・成果物を分ける。スキル更新時には対応する成果物を全削除し、サブエージェントが更新後のスキルを実行して作り直す。旧実行版を掲載し続ける運用を廃止する。\n\n### 対応する要件と完了条件\n- ガイドを `docs/skills/` と `docs/plugins/`、成果物を `docs/artifacts/skills/<skill-name>/` と `docs/artifacts/plugins/<plugin-name>/` に分ける。\n- 既存の6分類と26スキルのガイドを移し、リンク・検索・ダウンロード・検証処理を追従させる。\n- Skill単体とpluginの導入入口を整え、既存のskill-refiner・explain-html pluginについて用途、対応Agent、生成・導入方法、hooksの確認方法、公開状況を案内する。\n- スキル本文・scripts・referencesなどの実行資料の更新を検知し、更新前の成果物・記録外ファイル・古い成果物の残存を検査する。サブエージェントの実行記録を保存するが、ハッシュ一致だけで再実行を証明したとは扱わない。\n- 更新時は該当成果物を全削除し、更新したスキルをサブエージェントで実行して入力・実出力・必要な画像・検証記録を保存し直す。旧版保持の例外を廃止する。既存成果物は移行時に棚卸しし、再実行が必要な例を作り直す。\n\n### 進め方と判断理由\nガイドの共通構成は既存テストを維持して活用する。成果物管理は運用手順と機械検査の両方を整え、正本変更と成果物更新をセットにする。pluginの成果物は配布物の生成・検証記録として扱い、公開や実環境へのインストールまで実施したと誤認させない。\n\n### 作業順序と検証方法\n1. ガイド・成果物を移し、参照先と公開設定を更新する。\n2. 成果物再作成の手順と変更検知・原本検査を整える。\n3. 導入案内・pluginガイドと生成・検証例を整える。\n4. 変更したスキル・旧版の例をサブエージェントで再作成し、ページへ反映する。\n5. 型検査、検索テスト、成果物検査、本番ビルド、サイトテストで構成・配信・ダウンロードを確認する。\n\n### 承認の根拠\nこの会話でユーザーが提示した要件に対し、上記の構成・更新フロー・検証方針を提案した。その後ユーザーから「計画をissueに登録して対応してください」と指示を受けたため、計画の承認およびこの計画記録の投稿依頼として実施する。\n\n### 残事項\n実装・成果物の再作成・検証と、人間による変更結果の確認。Issueのクローズ・本文更新は対象に含めない。\n","createdAt":"2026-10-15T14:45:44Z","includesCreatedEdit":false,"isMinimized":false,"minimizedReason":"","reactionGroups":[],"url":"https://github.com/yukihito-jokyu/context/issues/79#issuecomment-6194863317","viewerDidAuthor":true}],"number":79,"state":"OPEN","title":"docsの内容についてルールを決めたい","url":"https://github.com/yukihito-jokyu/context/issues/79"}
