为什么值得关注

它独特地将设计启发式转化为可组合、跨平台的 AI 技能，同时严格区分人类判断与自动决策，并在 Windows、Linux 和 macOS 上进行了结构验证。

适合谁使用

应用结构化设计方法的软件开发者和架构师
寻求可重复设计指导的 AI/LLM 智能体开发者
采用契约驱动和领域驱动设计的工程团队
需要基于可验证证据评估设计决策的技术负责人

典型使用场景

在实现前通过问题框架明确模糊的需求
审计领域模型以发现缺失的概念、状态或约束
将自然语言需求转化为可测试的前置/后置条件和契约
设计具有显式权衡和恢复策略的架构质量策略

项目优势

基于已发表的设计原则，而非虚构的最佳实践
跨平台（Linux、Windows、macOS）的结构验证，附带版本化测试夹具
清晰区分事实证据、解释和人类拥有的决策
可组合的技能，仅为每项任务应用所需的最小范围

使用前须知

当前实验阶段（v0.9.0）未通过行为发布验证，仅部分完成了结构验证
原生 macOS 夹具运行器失败，阻碍了完整的平台对等性
需要特定环境设置（Codex CLI 配合 .agents/skills），尚未准备好用于生产

README 快速开始

mino-drive-inspired-design-skills

本リポジトリは、ミノ駆動氏の公開資料を基に、設計判断の原則をAI Skillとして再構成する非公式プロジェクトです。ミノ駆動氏および所属組織による監修・承認・推奨を受けたものではありません。

目指すのは人物の口調や結論の模倣ではありません。問題、目的、文脈、要件、契約、モデル、品質、公開境界を確認し、根拠のある判断と検証可能な成果物を繰り返し作れるようにすることです。公開資料から直接抽出した原則、反復可能なSkillにするためsuiteが追加したschema・gate・workflow、versioningやvalidator等のrepository policyは区別して記載します。

現在の状態

Status: Experimental / Preview
Suite version: 0.9.0
Structural validation: fail on the native macOS fixture runner; pass on executed Linux and PowerShell-over-WSL layers
macOS structural support: implemented; native macOS /bin/bash executed / fail (run 29397674053, exit 2)
Targeted behavioral evidence: not executed
Behavioral release: not ready

ここでいうbehavioral release（行動再現性を確認した安定版判定）は、権限を持つevaluation ownerがfrozenにしたversioned caseと隔離oracleをfresh contextで繰り返し実行し、代表case・negative case・回帰・required platformのRelease gateを満たした状態です。Experimental / Previewとして配布可能であることと、stable releaseとして承認済みであることを分けます。権限を持つmaintainerが全Evidenceを確認するまでstable releaseとは扱いません。

プロダクト価値（利用者・事業が得る成果）と品質portfolio（優先する品質、制約、意図的に最適化しない品質の組合せ）の最終判断も、AIではなく権限を持つ人間が所有します。

native macOS Evidenceは、head e47aaafb74a27cf2cc7d4bc9c64f74d1933f10dbのworkflow run 29397674053、job Native macOS /bin/bash（job ID 87294760529）で取得済みです。環境はmacOS 15.7.7、image macos-15-arm64 version 20260706.0213.1、RUNNER_ARCH=ARM64でした。validate-suite.shはpassしましたが、fixture runnerはsolver-nested-metadataのportable rewriteで失敗し、jobはexit 2でした。

macOSはBash構造validator、fixture runner、text-format検査を対応範囲に含めます。共用scriptは標準/bin/bash 3.2で実行できるsubsetへ制限しています。上記failureを修正したheadでnative macOS jobがgreenになるまで、platform parityやreleaseをpassにしません。

クイックスタート

Skill routingの適用

このsuiteは技術非依存の設計原則を扱います。プログラミング言語、framework、tool固有のSkillを併用する場合は、主成果物に最も合うmino Skillを基本workflowとし、必要な技術差分だけを追加します。現在のrouting規則は、maintainerが責任を持って採用・保守しています。

Skill compositionを利用側のAGENTS.mdへ記載する例:

# Skill Composition

When a request matches multiple Skills:

- Use the Skill that best matches the primary outcome as the basic workflow.
- Add only relevant language-, framework-, or tool-specific Skills to supplement that workflow.
- Let the basic Skill control scope, changes, validation, and the final response; specialized Skills provide their domain-specific guidance.
- Preserve every applicable Skill's exclusions, hard gates, and safety constraints.
- Follow the user's explicitly named Skills and do

项目描述

ミノ駆動氏のWebに掲載されている資料から作成した開発スキル

inspired-mino-design-skills