mcpField
J
jira-status-writeback

jira-status-writeback

github.com/fudesign2008開発655 回インストール今日更新
リポジトリ

jira-status-writeback について

PRまたはMRのマージ成功後にJiraを更新する内部共有スキルです。ステータス変更と修正コメントの投稿を分離し、保存後もWiki記法が保持されているか確認します。

主な機能

  1. 01マージ成功後のみ実行
  2. 02開発者が担当する適切なステータスを選択
  3. 03修正コメントを別途投稿
  4. 04保存されたWiki記法を検証
  5. 05REST代替手段でコメントを修復
  6. 06マージを戻さずに失敗を報告

活用シーン

  1. 01修正のマージ後にJiraを更新
  2. 02修正内容と検証結果の記録
  3. 03記法が変更されたコメントの修復
  4. 04マージを止めずにJira更新失敗を報告

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/fudesign2008/open-skills --skill jira-status-writeback

インストール後、Claude Code で/jira-status-writebackを入力して読み込まれたか確認します。

同梱ファイルscripts/update-comment-wiki.mjsscripts/update-comment-wiki.test.mjs

詳細

Jira ステータス書き戻し

内部共有スキルです。マージ後の Jira ステータス更新と修復コメントの信頼できる唯一の情報源です。ホストはこれを dependencies で宣言し、見つからない場合は中止して、フィールドマップを渡す必要があります。ホスト側で、2 段階の API やステータスの境界をインラインで再記述してはなりません。このスキルは PAT ファイルを解決しません。セッション認証または MCP 認証は jira-read に従います。

前提条件の確認：jira-wiki-markup が利用可能である必要があります。見つからない場合は中止し、標準のインストールヒント（npx skills add FuDesign2008/open-skills -g --skill '*' --yes）を出力してください。

実行タイミング

PR/MR がターゲットブランチに正常にマージされた後に限り実行します。PR 作成時には決して実行しないでください。

SOP

  1. トランジション（トランジション呼び出しではコメントを付けない）

    • jira_get_transitions（または同等のもの）を呼び出し、開発者が管理する「已修复」に相当するステータスを選択します。
    • comment パラメーターを指定せずに jira_transition_issue を呼び出します。
    • クローズ済み／検証済み／QA 管理のステータスには移行しないでください。
    • 該当するトランジションがない場合は、トランジションをスキップし、警告を出して、可能であればコメントを続行します。

  2. コメント（独立した呼び出しで、マークアップの忠実性を検証）

    • jira-wiki-markup を読み込み、そのスキルの標準的な修復コメントのひな形（Wiki マークアップ）を使って、ホストのフィールドマップから body を作成します。
    • 修復用の body の行が h1. または h2. で始まる場合は、コメントが h3.／h4. とリストで構成されるよう、それらのタイトルを番号付きの # *name* 項目に書き換えます。
    • 利用可能なコメントツールで、body フィールドにテキストを指定して投稿します。修復記録に jira_transition_issue の comment パラメーターを使用してはなりません（その内容は黙って破棄される場合があります）。
    • 完了とする前に忠実性を検証してください：ツールの応答（または後続の読み取り）から保存された body を読み戻し、作成したテキストと比較します。行頭の見出し（h3.／h4.）、*bold*、{{mono}}、[label|url] がすべてそのまま保持されている必要があります。2xx 応答だけでは成功とはみなせません。中間レイヤーがマークアップをエスケープして（*bold* を \*bold\* として保存するなど）、あるいは見出しを書き換えて（h3. X を ### X にするなど）も、2xx が返されることがあります。
    • 忠実性に問題がある場合は、同梱の REST フォールバック scripts/update-comment-wiki.mjs を使用してコメントを書き換えます（認証情報のチェーンは jira-read と同じです。新規作成時はコメント ID を渡さず、更新時はコメント ID を渡します。このスクリプトは独自に忠実性を再検証します）。その後、PASS 出力に基づいて報告します。

  3. 失敗時の処理

    • トランジションまたはコメント API の失敗は警告し、ホストへの報告に記録します。すでに完了したマージを妨げたり、取り消したりしてはなりません。

ホストのフィールドマップ

ホストは、これらの意味フィールドに具体的な値を必ず指定してください（本当に該当しない場合に限りフィールドを省略し、その旨を記載します）。

フィールド意味
修正ブランチソースブランチ名
コミットマージされた先端 SHA、または主要な修正コミット
PR/MR URLマージリクエストの URL
根本原因根本原因の簡潔な要約
修正概要変更内容
変更ファイル主要なパス
検証機能／境界／回帰に関するメモ（ホストは各項目を 2 件以上必須にできます）
追加情報ホスト固有の情報：分析レポートのパス（jira-fix-workflow）、OpenSpec 変更パス（opsx-jira-fix-workflow）、QA リスクなど

統合

  • frontmatter の dependencies で jira-status-writeback を宣言します。
  • 書き戻し時にこのスキルを読み込み、フィールドマップを渡し、SOP に従います。
  • ホスト側に残すのは、ステージの順序で書き戻しを実行するタイミング（マージ後。必要な場合はアーカイブ後）と、フィールドマップのみです。

コメント

Markdown 対応