今すぐ始める

改善案

パックの改善案を CLI から送信 / 取得 / 更新 / 解決します。

改善案はパックに対するテキスト中心の提案です。ワークフロー / コンテキスト・パックを読める人なら誰でも所有者に改善案を送れ、所有者がレビューして解決します。改善案はパックを直接編集しません。ライフサイクルと権限モデルは 改善案 を参照してください。

suggestion create は 5 credits(pack create と同額)、list は 2 credits、get・update・resolve はそれぞれ 1 credit です。さらに1アカウントあたり1日20件まで作成できます。

改善案の送信

epismo suggestion create @market-research --title "Add review step" \
  --content "Add a final human review before publishing to reduce hallucinated findings."
epismo suggestion create $PACK_ID --input @suggestion.json

<reference> はパック ID、@alias、共有 URL、ハブ URL のいずれかで、pack get が受け付けるのと同じ形式です。作成時点のパックの内容がスナップショットとして保存されます。--title と --content は必須で、どちらも --input から渡すこともできます。

改善案の取得

epismo suggestion get $SUGGESTION_ID
epismo suggestion get $SUGGESTION_ID --include-snapshot

--include-snapshot を付けると、保存されたパックの内容がレスポンスに含まれます。レスポンスを小さく保つため、デフォルトでは省略されます。

改善案の一覧

epismo suggestion list                                # 自分が送信した改善案
epismo suggestion list --owner --status open          # 自分の受信箱、open のみ
epismo suggestion list --reference @market-research   # 特定のパック向け
epismo suggestion list --status open,declined         # ステータスで絞り込み
epismo suggestion list --author $ACCOUNT_ID --reference @market-research

list はフラグによって答える内容が変わります。

  • フラグなし — 自分が送信した 改善案。
  • --owner — 自分の 受信箱: 自分が所有するパックへの改善案。
  • --reference — 特定のパック向け の改善案(--author でさらに絞り込み可)。

--status は open, applied, declined, archived のカンマ区切りリストを受け付けます。--page でページ送り(ページサイズ20)、--include-snapshots で保存されたパック内容を含められます。

list が返す各改善案の content は短いプレビュー(短縮版)です。全文は epismo suggestion get <id> で取得します。パックのアウトラインが全文取得に委ねるのと同じ考え方です。

自分の改善案の更新

epismo suggestion update $SUGGESTION_ID --title "Add review step" \
  --content "Please add a reviewer approval step before publish."

改善案のタイトルや本文を更新できるのは投稿者だけです。

改善案の解決

epismo suggestion resolve $SUGGESTION_ID --status applied
epismo suggestion resolve $SUGGESTION_ID --status declined
epismo suggestion resolve $SUGGESTION_ID --status archived

改善案を解決できるのはパックの所有者だけです。--status は open, applied, declined, archived のいずれかです。解決はステータスを変えるだけなので、受け入れる場合はまず pack update で実際の変更を反映してください。

よくある間違い

  • 改善案を解決してもパックは編集されません。pack update で変更を反映してから suggestion resolve --status applied を実行します。
  • update できるのは投稿者だけ、resolve できるのは所有者だけです。
  • スナップショットは改善案作成時点のパックを表し、現在の内容ではありません。