Skip to content

Spec

Jump to bottom
Yoshinari Nomura edited this page Jul 11, 2014 · 1 revision

Spec

PBL

PBL Issue 一覧を取得して PBL Wiki Page を自動作成する

STORY

SYNOPSIS

octaccord backlog nomlab/LastNote --search='label:PBL' --replace Product-Backlog.md

DESCRIPTION

Product-Backlog.md 中の

<!-- begin:octaccord backlog -->
...
<!-- end:octaccord backlog -->

で囲まれた部分に，プロダクトバックログのテーブルを埋める．書式は，以下の通り．

No. Title Story Demo Cost
#100 招待機能の実装 メンバとして，ML にメールを投げることでイベントの出欠を簡単に取りたい．それは，イベントの開催を活発にしたいからである． gn メーリングリストに送信する際にアドレス末尾に「+inv」と追記して送信すると，LastNote 上に対応するイベント参加者一覧のページが作成される．メンバに届いたメール本文には，イベント出欠を返答するリンクが付いている．出席/欠席のどちらかをクリックすると，出欠一覧ページに出欠状況として名前が反映される． 5
No
PBL Issue の番号 [#100](../issues/100) のように Issue へのリンクにする．
Title
PBL Issue のタイトル
Story
PBL Issue の記述中の # Story 以下の記述を抜き出してきたもの
Demo
PBL Issue の記述中の # Demo 以下の記述を抜き出してきたもの
Cost
実装するのにかかるコストを示す整数(空欄でよい)

ただし，既にテーブルがある場合は，以下の状態を保存する

  • No. と Cost の値
  • ソート順

既存のテーブルになかった新規の PBL Issue は，末尾に追記する．

指定された PBL Issue の内容から Task Issue を作成する

STORY

SYNOPSIS

octaccord pbl-to-task nomlab/LastNote --add-label=Itr0094 100 111 ...

DESCRIPTION

  1. 引数の各 PBL Issue について
  2. description か comment から # Tasks 以下の項目を抜き出す (末尾の comment の # Tasks を優先する)
  3. 子要素である各 ## title... 項目を Task Issue として新規作成する
  4. Task Issue の本文中に，元となる PBL Issue への参照を入れる．(#100 のように)
  5. 元となる PBL Issue の # Task 以下の ## title... 部分を ## #150 title... のように置き換える．
  6. 同じ操作を繰り返しても Task Issue を新規作成しないように， ## title... の title 部分が #番号 で始まる場合は，無視する
  7. 作成した Task Issue には，=-add-label= で指定された label を付ける

Floating Issue を発見してラベルを付ける

STORY

  • スクラムマスターが，重要なラベルが付いていない Task Issue にラベルを付けたい． それは，棚卸すべき Task Issue が何であるかを素早く確認したいからである．

SYNOPSIS

octaccord update-label nomlab/LastNote --search='!label:/^[A-Z]/' --label=Floating

DESCRIPTION

  1. 全ての Issue について， --search 式にマッチした Issue のみに --label で指定されたラベルを付与する．
  2. つまり，マッチしなかった Issue からは，ラベルをはがすことも同時に実行する

Wiki Page 中の Issue 番号に反応して最新の情報を付与する

STORY

SYNOPSIS

octaccord embed-issue-info nomlab/LastNote --replace Itr0094.md

DESCRIPTION

Wiki のページ中に現れる #番号 の記述をスキャンして， リンクやタイトルを付与する．

  • #番号 の記述にリンクを付与して， [#番号](../issues/番号) の記述に置き換える
  • 行頭の * や # の直後に来る場合は後ろに Issue のタイトルも追加する

この機能によって，Wiki 中に

* #150

とだけ書いておけば，リンクとタイトルが付いた記述に置き換えられる．

* =[#番号](../issues/番号)= カレンダをまたぐリカーレンスを作成できないようにする

検索式に一致する Issue を列挙する (要検討)

SYNOPSIS

octaccord issues nomlab/LastNote --search="!label:"

DESCRIPTION

  • ある時刻の範囲でアップデートがあった
  • ある時刻の範囲で作成された
  • あるラベルにマッチする/しない
  • オープン/クローズの別

Nomura Laboratory

Clone this wiki locally