第12章
課題を管理する
「第12条の休日を見直す」のような、これからやることを課題として記録できます。課題には番号(#1、#2 …)が付き、版や改定案と結び付けて、どの版で解決したかを後から追えます。GitHub や GitLab の Issue と同じ仕組みで、リポジトリをリモートに接続していなくても使えます。

課題の画面は、リポジトリホームの右上の「課題」、文書を開いているときの右上の「課題」、改定案のメニューの「課題」、検索の欄(Ctrl+K)の「課題」から開きます。ボタンには未完了の課題の数が付きます。左上の「← 〇〇に戻る」を押すと、開く前の画面(文書やリポジトリホーム)に戻ります。
左が課題の一覧で、「未完了」と「完了」を切り替えられます。課題を押すと、右に本文と紐付いた版が出ます。
課題を作る
- 右上の「新しい課題」を押します。
- 題名と本文を書きます。本文は Markdown で書けます。
- 「作る」を押します。
編集の欄で右クリックして「この条について課題を作る」を選ぶと、本文に「就業規則 第2条(休日)」のように文書名と条が入った状態で作成画面が開きます。
版と課題を結び付ける
版を保存するときに選ぶ

版を保存の画面の「課題」で、未完了の課題を選びます。選んだ課題の左のボタンを押すと、次の 2 つを切り替えられます。
- 解決する:この版で課題が片付いたことを表します。メッセージの最後に
Closes #1の行が入り、課題が閉じます(閉じるタイミングは次の節)。 - 関連する:課題に関係する版として残します。メッセージに
Refs #1の行が入り、課題は閉じません。
メッセージに番号を書く

「何を変えたか」の欄で # を打つと、未完了の課題の候補が出ます。↑↓ で選んで Enter を押すと番号が入ります。メッセージに #1 と書いた版は課題 #1 に紐付き、Closes #1・Fixes #1・Resolves #1 と書いた版は課題 #1 を解決します(英語の書き方です。GitHub と GitLab が同じ書き方を使うためです)。
改定履歴やトップページなどに出るメッセージの #1 は、押すとその課題を開きます。
保存したあとの版を紐付ける

改定履歴で版を選び、右上の「課題に紐付ける」を押して課題を選びます。課題の画面の「版を紐付ける」からも同じことができます。
改定案ごと紐付ける
改定案で作業しているときは、改定案のメニューの「この改定案で解決する課題…」で課題を選べます。選んだ課題は、その改定案を現行版に反映したときに閉じます。
課題を閉じる
課題が閉じるのは、解決する版が現行版に入ったときです。
- 現行版に
Closes #1の版を保存したとき:すぐに閉じます。 - 改定案に
Closes #1の版を保存したとき:まだ閉じません。改定案を現行版に反映したときに閉じます。 - 改定案のメニューで紐付けた課題:改定案を現行版に反映したときに閉じます。
手で閉じるときは、課題の画面の「閉じる」を押します。解決した版を選ぶこともできます(選ばなくても閉じられます)。閉じた課題は「開き直す」で未完了に戻せます。
コメントで話し合う

課題の下の欄にコメントを書いて「コメントする」を押すと、課題にコメントが付きます。Ctrl+Enter(Mac は ⌘+Enter)でも送れます。「先方に確認中」「11/20 の打合せで決定」のような経過を残しておくと、なぜその条文にしたかを後から追えます。
- コメントは Markdown で書けます(箇条書き・太字・リンクなど)。リンクはブラウザーで開きます。
- コメントは古い順に並び、書いた人と日時が付きます。
- 書いたコメントは、今のところアプリでは直したり消したりできません。
リモートに接続していないリポジトリでも使えます。コメントはリポジトリの記録に保存し、同期すればほかの PC でも見られます。2 台の PC で同時に書いても、どちらのコメントも残ります。
GitHub・GitLab に接続しているとき
リモートが GitHub か GitLab のときは、課題はそのサイトの Issue そのものです。アプリで作った課題はサイトにも出て、サイトで作った課題はアプリにも出ます。「GitHub で開く」(GitLab では「GitLab で開く」)を押すと、ブラウザーで開きます。
- コメントは Issue のコメントそのものです。サイトで書かれたコメントも、課題を開いたときに出ます。課題を開いたまま新しいコメントを見るときは、右上の再読み込みのボタンを押します。コメントを直したり消したりするときは、サイトで行います。
- 版の紐付けは、Issue のコメント(「版 … を紐付けました(ClauseDown)」)としてサイトに残ります。アプリのコメントの一覧では、話し合いのコメントと分けて 1 行の記録として出します。
Closes #1の版が現行版に入ると、サイトが Issue を閉じます。- 改定案で紐付けた課題は、確認依頼(プルリクエスト・マージリクエスト)の説明に
Closes #1として入ります。
ローカルで作った課題を移す:リモートに接続する前に作った課題は、接続したあと課題の画面に出る案内から、サイトに移せます。コメントも一緒に移ります。サイト上の投稿者は接続した人のアカウントになるため、コメントの先頭に「(事務員A・2026/11/12 14:03 のコメント)」のように、元の書き手と日時を書き残します。新しく作った空のリポジトリなら、番号はそのまま(#1 は #1)です。サイトにすでに Issue やプルリクエストがあって番号がずれるときは、移した課題の本文に元の番号を書き残します。過去の版のメッセージにある #番号 は、サイトでは別の課題を指すことがあります。
GitHub では、ClauseDown の GitHub App に Issues の権限が必要です。権限が足りないと、課題を開いたときにその旨が出ます。