mcpField
Z
zentao-story

zentao-story

github.com/imyuyu開発361 回インストール22 週間前に更新
リポジトリ

zentao-story について

zentao-storyは、zentao-cliでZenTaoのストーリーを管理するスキルです。製品要件を確認・保守するチーム向けに、ライフサイクルや状態遷移、優先度を説明します。

主な機能

  1. 01ストーリーの一覧と詳細表示
  2. 02作成・更新・変更
  3. 03クローズと再有効化
  4. 04ライフサイクルと状態遷移の説明
  5. 05優先度・タイプ・段階の参照

活用シーン

  1. 01製品やプロジェクトでストーリーを絞り込む
  2. 02優先度や見積もり付きのストーリー作成
  3. 03状態や担当者の更新
  4. 04状態遷移とバージョン要件の確認

インストール

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

$npx skills add https://github.com/imyuyu/zentao-cli --skill zentao-story

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
zentao-story-change.md
zentao-story-close.md
zentao-story-create.md
zentao-story-delete.md
zentao-story-get.md
zentao-story-list.md
zentao-story-update.md

詳細

ストーリー（v2）

重大な注意 — 開始前に、必ず Read ツールを使って ../zentao-shared/SKILL.md を読み込んでください。認証、環境変数の設定、エラー処理、ステータス値の定義が記載されています。

コマンド

ストーリーのライフサイクル

ZenTao の要件には、明確なライフサイクルのステータスがあります。

draft → active → changed → closed
         ↑         ↓
         └─────────┘ (可重新激活)
有効なステータス遷移
現在のステータス遷移可能な次のステータス説明
draftactiveレビューに提出
activechanged, closedレビュー承認またはクローズ
changedactive, closed変更後に再レビューまたはクローズ
closedactive再アクティブ化

ストーリーのステータス値

ステータス日本語説明
draft草稿要件の草稿状態
activeアクティブレビューに提出済み
changed変更済み要件に変更があり、レビュー待ち
closedクローズ済み要件はクローズ済み

優先度レベル

レベル名前説明
1最高最優先
2高高優先度
3中中優先度
4低低優先度

注意：優先度 0 は通常、優先度が設定されていないことを示します。

ストーリーの種類

種類日本語説明
feature機能新機能の要件
enhance拡張機能の拡張
bugfix不具合修正バグ修正
taskタスクタスクの要件
storyユーザーストーリーユーザーストーリー

ストーリーのステージ値

ステージ説明
wait未開始
plan計画済み
developed開発済み
testingテスト中
releasedリリース済み
closedクローズ済み

使用前に zentao-cli story --help を実行すると、すべてのオプションを確認できます。

よくある使用例

1. 製品のすべての要件を表示する
# 列出产品 1 下的所有需求
zentao-cli story list --product 1

# 只看活跃的需求
zentao-cli story list --product 1 --status active
2. 特定の要件の詳細を表示する
# 获取需求详情（包含描述、预估工时、阶段等）
zentao-cli story get 123
3. 新しい要件を作成する
# 基础创建
zentao-cli story create --title "用户登录功能" --product 1 --pri 1

# 完整创建（带类型和预估工时）
zentao-cli story create --title "用户注册功能" --product 1 --pri 1 --type feature --estimate 8
4. 要件のステータスを更新する
# 关闭需求
zentao-cli story update 123 --status closed

# 更新优先级
zentao-cli story update 123 --pri 2

# 变更需求状态并指派
zentao-cli story update 123 --status changed --assigned-to developer-name
5. プロジェクトで要件を絞り込む
# 查看项目 1 下的所有需求
zentao-cli story list --product 1 --project 1

例

# 列出产品 1 下的所有需求
zentao-cli story list --product 1

# 只看活跃的需求
zentao-cli story list --product 1 --status active

# 获取需求详情
zentao-cli story get 123

# 创建新需求
zentao-cli story create --title "用户登录功能" --product 1 --pri 1

# 关闭需求
zentao-cli story update 123 --status closed

出力フィールド

フィールド型説明
idu64要件 ID
titlestring要件のタイトル
productu64製品 ID
statusstring要件のステータス：draft / active / closed / changed
priu8優先度：0-5
categorystring要件カテゴリ：feature / requirement / bug / improvement
stagestring現在のステージ：wait / plan / developed / testing / released / closed
moduleu64所属モジュール ID
assigned_tostring担当者
opened_bystring作成者
estimatef64見積もり工数（時間）
versionu64バージョン番号（楽観ロック用）

注意点

  1. ストーリー ID とタイトル：要件の作成後に返されるのはストーリー ID（数値）であり、タイトルではありません。以降の操作では ID を使用する必要があります。

  2. ステータス遷移：ステータスの変更が受け付けられるのは、遷移ルールに適合している場合のみです。

    • draft → active：レビューに提出
    • active → changed/closed：レビュー操作
    • 不正な遷移を行うとエラーが返されます

  3. 更新時のバージョン：要件を更新する際は、並行更新の競合を防ぐため、楽観ロックを利用できる version フィールドの指定を推奨します。

  4. 見積もりの単位：--estimate パラメーターの単位は時間（hours）です。

  5. 種類とカテゴリ：ストーリーには type（ストーリーの種類）と暗黙的な category（要件の種類）があり、両者は異なる場合があります。実際の業務に合わせて選択してください。

  6. クローズ済みストーリーの再アクティブ化：クローズ済みの要件は、active に設定することで再アクティブ化できます。

  7. 製品は必須：要件の作成時には --product パラメーターが必須です。また、要件は必ずいずれかの製品に属している必要があります。

コメント

Markdown 対応