本文へ移動
cccskills
無料GitHub で公開

codex-spec-driven-development

Use for prototype, MVP, fullstack feature, from-scratch feature, or multi-domain work that needs a SPEC.md before planning or implementation. Do not use for tiny one-file edits.

インストール方法を見る

含まれるファイル(5)

  • SKILL.md2.3 KB
  • agents/openai.yaml311 B
  • references/spec.schema.json954 B
  • scripts/check_spec.py9.6 KB
  • scripts/init_spec.py13.3 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

TL;DR

Use before $prototype, MVP, fullstack, or high-ambiguity feature work. Write .codex/specs/<slug>/SPEC.md first, then plan, delegate, implement, and validate against acceptance criteria.

Activation

  1. Activate on $spec, $prototype, "spec-driven", "MVP", "fullstack prototype", "from scratch", or "build whole app".
  2. Activate when a task spans frontend + backend, data, QA, or deployment concerns.
  3. Activate when requirements are ambiguous enough that coding first would create rework.

Hard Rules

  • Do not implement prototype/fullstack work before a spec exists.
  • Specs must include requirements, non-goals, acceptance criteria, FE/BE/data/QA impact, and validation plan.
  • Specs must include Schema-Version: 1.0, AC IDs such as AC-001, and a traceability table mapping changed files to AC IDs and validation commands.
  • Keep specs project-local under .codex/specs/; do not always load every spec.
  • Use check_spec.py after code changes when .codex/specs/ exists.
  • Treat spec checks as advisory in quality gate unless the user makes spec compliance mandatory.

Commands

python "<SKILLS_ROOT>/codex-spec-driven-development/scripts/init_spec.py" --project-root <path> --title "<title>"
python "<SKILLS_ROOT>/codex-spec-driven-development/scripts/check_spec.py" --project-root <path> --changed-files <csv>

Output Contract

  • init_spec.py returns JSON with status, spec_path, and slug.
  • check_spec.py returns JSON with schema_version, overall, matched_specs, matched_acceptance_criteria, unmapped_files, and suggested_actions.

Prototype Flow

  1. Run $hook to detect domains and readiness.
  2. Run $init-profile if profile is missing.
  3. Run $genome and $init-docs if context/docs are missing.
  4. Run $spec to lock requirements and acceptance criteria.
  5. Run $plan, then $sdd or inline execution.
  6. Run $check-full and update role docs/handoff.

Reference Files

  • references/spec.schema.json: required spec markdown contract and traceability fields.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Use when implementation is complete, all tests pass, and you need to decide how to integrate the work — guides completion of development work by presenting structured options for merge, PR, or cleanup

日本語の概要は準備中です。原文の説明を表示しています。

Bang-isme/CodexAI---Skills102026年10月5日 更新

Use when a project has 50+ files, missing context, or explicit $codex-genome request; generates multi-layer project context to reduce hallucination.

日本語の概要は準備中です。原文の説明を表示しています。

Bang-isme/CodexAI---Skills102026年10月5日 更新

Use for DESIGN.md visual identity contracts; author, scaffold, lint, diff, and export design contracts with the upstream spec and CLI.

日本語の概要は準備中です。原文の説明を表示しています。

Bang-isme/CodexAI---Skills102026年10月5日 更新

Use when the task involves reading, creating, or editing `.docx` documents, especially when formatting or layout fidelity matters; prefer `python-docx` plus the bundled `scripts/render_docx.py` for visual checks.

日本語の概要は準備中です。原文の説明を表示しています。

Bang-isme/CodexAI---Skills102026年10月5日 更新

Use when code changes may require documentation updates; maps git diff to candidate docs without auto-editing documentation.

日本語の概要は準備中です。原文の説明を表示しています。

Bang-isme/CodexAI---Skills102026年10月5日 更新

Use for documents, reports, memos, guides, academic papers, or formal text that needs clear structure, reliable tone, formatting, and diagrams.

日本語の概要は準備中です。原文の説明を表示しています。

Bang-isme/CodexAI---Skills102026年10月5日 更新

Bang-isme のスキルをすべて見る

このスキルの問題を報告する