human-standards

Human Standards

人間工学研究を、実践的な設計標準、実装ガイダンス、AI エージェント向けの読み取り専用コンテキストに翻訳します。

公開ライブラリを見る · MCP サーバーに接続する · Study 001 を読む

Human Standards は役に立ちましたか？ 後で見返せるように保存し、ほかの実務者にも見つけてもらえるよう、GitHub でプロジェクトにスターを付けてください。今後のリリースを確認するためにリポジトリをウォッチしたり、公開されているディスカッションに参加したりすることもできます。

Study 001 は、コーディネーターがレビューした探索的パイロットとして公開されています。 MCP のアクセス方法を指定すると自動評価の結果は改善しましたが、明らかなユーザビリティとアクセシビリティの問題を確実に解消するには至りませんでした。予定されていた独立レビューは完了しておらず、人間による評価結果が得られていないことも明示しています。ケーススタディとエビデンスを読む。

Human Standards が存在する理由

プロダクトチームは、認知、人間工学、アクセシビリティ、ユーザビリティ、人間とコンピューターの相互作用に関する膨大な研究を利用できます。しかし、そのエビデンスを具体的な設計上の決定に結び付けることは、依然として困難です。AI を活用したプロダクト開発では、その隔たりがさらに明らかになります。

Human Standards は、そうした知見を調べて応用しやすくするために設計された、オープンソースのリファレンスライブラリです。誰でもガイダンスを直接参照できます。互換性のある AI ツールは、ローカルの読み取り専用 MCP サーバーを通じて同じ資料を取得できます。

このプロジェクトは、ユーザー調査、アクセシビリティテスト、専門家の判断、または引用している標準や研究に取って代わるものではありません。

含まれる内容

• 人間工学に関するガイダンス — 認知、知覚、感情、意思決定、人間工学、アクセシビリティ、社会的背景
• 設計と実装のガイダンス — インタラクションパターン、プレイブック、コード例、デザイントークンの制約
• 調査手法 — ユーザビリティテスト、認知的ウォークスルー、指標、評価ガイダンス
• エビデンスと参考資料 — ガイダンスの根拠となる標準、出版物、資料へのリンク
• 機械可読なアクセス — 検索、取得、ヒューリスティクス、関係性を優先した空間リズムのガイダンスに対応する、5 つの読み取り専用 MCP ツール
• 公開評価 — 独立レビューと再現可能な分析を目的とした研究プロトコルとエビデンス

現在の状況

Human Standards は現在も積極的に開発されており、完成済みの、または普遍的に検証された標準ではなく、作業中のリファレンスライブラリとして扱ってください。

• ドキュメントライブラリは humanstandards.org で利用できます。
• MCP サーバーは公開されている npm パッケージからローカルで実行され、同梱されたガイダンスを使用します。プロジェクトや外部サービスへの書き込みは行いません。
• Study 001 は探索的パイロットとして公開されています。プロトコルからの逸脱、自動評価のエビデンス、コーディネーターの観察、条件の対応関係、独立レビューの結果が得られていないことが公開されています。
• 不足している点の指摘、修正、異なるエビデンス、範囲が明確な貢献を歓迎します。

ドキュメントライブラリを利用する

はじめにから開始するか、トピック別にライブラリを閲覧してください。各ページでは、原則を実践的な判断や実装ガイダンス、入手可能な場合は一次資料または確立された資料に結び付けています。

サイトをローカルで実行するには：

git clone https://github.com/aklodhi98/humanstandards.git
cd humanstandards
npm ci
npm run dev

http://localhost:4321 を開くと、ローカルサイトを表示できます。

MCP サーバーを使用する

MCP サーバーは、読み取り専用の5つのツールを通じて、互換性のあるAIツールにライブラリを公開します。

• search_standards
• get_standard
• get_heuristic
• get_all_heuristics
• get_spatial_rhythm

MCP クライアントは npm パッケージを実行します。これはアプリケーションの依存関係ではなく、構築するプロジェクトの一部にもなりません。

npx --yes @humanstandards/mcp-server

互換性のあるMCPクライアントで、このコマンドを実行するよう設定してください。

{
  "mcpServers": {
    "human-standards": {
      "command": "npx",
      "args": ["--yes", "@humanstandards/mcp-server"]
    }
  }
}

サーバーは標準入出力を介して通信し、プロジェクトファイルを読み取らず、ネットワークポートを開きません。また、パッケージのリリースに同梱されたHuman Standardsのスナップショットを使用します。Codex、Claude Desktop、Claude Code、ソースからのビルド、検証手順については、MCPセットアップガイドをご覧ください。

プロジェクトのコマンド

コマンド	操作
npm ci	ロックファイルに基づいてドキュメントサイトの依存関係をインストールします
npm run dev	ローカルサイトを localhost:4321 で起動します
npm run build	本番サイトを ./dist/ にビルドします
npm run check	サイトをビルドし、内部リンクを検証します
npm run preview	本番ビルドをローカルでプレビューします
npm run build --prefix human-standards-mcp	MCPサーバーをコンパイルします
npm test --prefix human-standards-mcp	ビルド後にMCPサーバーのテストを実行します

コントリビューション

役立つコントリビューションの例は次のとおりです。

• 不正確、曖昧、または古くなったガイダンスの修正
• 信頼性の高い一次資料や定評ある情報源の追加
• 例や実装の詳細の改善
• 抜けているコンテキスト、制約、アクセシビリティ上の考慮事項の指摘
• ウェブサイト、スタンダードのインデックス、またはMCPサーバーの不具合の報告

コントリビューションのワークフロー、根拠に関する要件、コンテンツの構成、ローカルでのチェックについては、CONTRIBUTING.mdをご覧ください。質問や初期段階のアイデアはGitHub Discussionsから投稿できます。具体的な不具合はIssuesに報告してください。

ライセンスと帰属表示

• オリジナルのドキュメントとスタンダードのデータ： CC0 1.0 Universal
• ソフトウェアとコード例： MIT License
• サードパーティの素材： 元のライセンス条件を維持し、THIRD_PARTY_LICENSES.mdに記載しています

Human Standardsは、人間工学、認知心理学、HCI、UX、アクセシビリティの分野にわたる研究成果を基盤としています。ライブラリ全体に出典を記載しており、幅広い参考資料は学術研究の参考資料およびスタンダードとガイドラインからご覧いただけます。

AstroとStarlightを使用して構築されています。AK Lodhiがメンテナンスしています。