Openclaw向けFlatnotes + Tasks.md + GitHub 監査

Flatnotes および Tasks.md のデータを GitHub の PR と照合し、ドキュメントとタスクの正確性を確保するテクニカル監査ユーティリティです。

branexp
v1.0.0
Feb 7, 2026
2
2.6k
0

インストール&ダウンロード

1. ClawHub CLI

レジストリから直接スキルをインストールする最速の方法です。

npx clawhub@latest install flatnotes-tasksmd-github-audit

2. 手動インストール

スキルフォルダを以下のいずれかの場所にコピーしてください

グローバル
~/.openclaw/skills/
ワークスペース
<project>/skills/

優先順位:ワークスペース > ローカル > バンドル

3. プロンプトのインストール

このプロンプトをOpenClawにコピーするだけで、自動的にインストールされます。

Clawhubを使って flatnotes-tasksmd-github-audit をインストールして。Clawhubがインストールされていない場合は、先にインストールしてください(npm i -g clawhub)。

ダウンロードをご希望ですか?

ZIPアーカイブで生のスキルファイルを取得します。

Flatnotes + Tasks.md + GitHub 監査 とは?

このスキルは、ドキュメント用の Flatnotes とプロジェクト管理用の Tasks.md で構成される二重システムの生産性スタックの整合性を維持するために設計された、専用の監査エンジンを提供します。Openclaw Skills エコシステムを活用することで、カンバンのレーンが健全に保たれ、プロジェクトのドキュメントが完全な状態を維持し、タスクのステータスが GitHub のプルリクエストの実態を正確に反映するようにします。手動のメモ作成と自動化されたソース管理メタデータの間のギャップを埋め、ワークスペース内の情報の乖離を防ぎます。開発者にとって最も実用的な Openclaw Skills の一つとして、PR とタスクカードをクロスリファレンスする退屈なプロセスを自動化します。

Flatnotes + Tasks.md + GitHub 監査 のユースケース

  • Openclaw Skills 標準を使用して、レーンルールの違反や WIP 制限について Tasks.md カンバンボードを監査する。
  • Project Registry 内のすべての有効なプロジェクトに、Overview、Research、Plan、Log などの必要なドキュメントメモがあることを確認する。
  • オープンまたはマージされた GitHub PR を既存の Tasks.md カードと照合し、不足している更新やステータスの不一致を特定する。
  • Flatnotes ドキュメントへの必須ポインタが欠落している Tasks.md カードを特定する。
  • 優先度に基づいたレーン配置を強制する(ノイズを減らすために低優先度のカードをバックログに戻すなど)。

Flatnotes + Tasks.md + GitHub 監査 の仕組み

  1. Flatnotes 内の Project Registry を解析し、アクティブなプロジェクトのスラグ、ステータス、および関連する GitHub リポジトリ URL を特定します。
  2. Tasks.md 内のすべてのカードをレーンおよびプロジェクトタグごとにインデックス化し、フォーマットエラーや欠落しているドキュメントポインタにフラグを立てます。
  3. Flatnotes ディレクトリをスキャンし、登録されたすべてのプロジェクトに対して標準化されたノート構造が存在することを確認します。
  4. gh CLI を介して GitHub API にクエリを送り、タスクボードに対してオープンまたは最近マージされたプルリクエストをクロスリファレンスします。
  5. 乖離と違反を詳細に記した、Openclaw Skills レポートスイートの一部として包括的な Markdown および JSON レポートを生成します。

Flatnotes + Tasks.md + GitHub 監査 のセットアップ

GitHub CLI が認証済みであり、依存関係が利用可能であることを確認してください。Openclaw Skills デプロイメントの一部としてデフォルト以外の場所を使用している場合は、環境変数を通じてルートパスを設定します。

# 照合のために GitHub CLI を認証
gh auth login

# カスタムパスを設定 (任意)
export TASKS_ROOT="/path/to/tasks"
export FLATNOTES_ROOT="/path/to/flatnotes"

# 監査を実行
node skills/flatnotes-tasksmd-github-audit/scripts/audit.mjs --since-days 30 --write

Flatnotes + Tasks.md + GitHub 監査 のデータスキーマとタクソノミー

このスキルはローカルファイルシステムの構造と対話し、Openclaw Skills エコシステム内でのシステムの状態を追跡するために特定のレポート出力を生成します。

エンティティ パス/ソース 説明
Tasks ルート /home/ds/.config/appdata/tasksmd/tasks プライマリカンバンボードのソース。
Flatnotes ルート /home/ds/.config/appdata/flatnotes/data Markdown ベースのプロジェクトドキュメント。
Markdown レポート tmp/flatnotes-tasksmd-audit.md 人間が読める形式の監査サマリー。
JSON レポート tmp/flatnotes-tasksmd-audit.json 他の Openclaw Skills 用の機械読み取り可能な監査データ。

Flatnotes + Tasks.md + GitHub 監査 の高度な機能

  • 不足しているドキュメントテンプレートや ADR リンクを作成するための自動修正適用。
  • PR のタイトルと Tasks.md カードの説明の間のヒューリスティックなマッチングにより、リンクされていない作業を自動的に検出。
  • p2 優先度のカードをアクティブな Next レーンから制限するなど、複雑なレーンルールの強制。
  • リリースされたコード対記録されたタスクをリアルタイムで照合するための統合された GitHub CLI サポート。
  • Openclaw Skills フレームワーク内の異なるセルフホストファイルシステム設定に適応するためのカスタム環境変数のサポート。

SKILL.md


ローディング

関連するOpenclawのスキル

METADATA

Github Stars: 0
forks: 0

特徴*