{
  "ok": true,
  "resource": {
    "id": "RES_CE5D74214349",
    "resource_type": "skill",
    "canonical_url": "https://github.com/addyosmani/agent-skills/tree/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/spec-driven-development",
    "name": "spec-driven-development",
    "summary_en": "Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when requirements are unclear, ambiguous, or only exist as a vague idea. Use when a single requirement spans several independently testable capabilities and needs decomposing into a capability map of modules before specifying.",
    "summary_zh": "在编码之前创建规格说明。当开始一个新项目、功能或重大变更且尚无规格说明时使用。当需求不清晰、含糊或仅存在于模糊的想法中时使用。当单个需求跨越多个可独立测试的能力并需要在规格化之前分解为模块能力图时使用。",
    "description_en": "This Agent Skill, named 'spec-driven-development', is a workflow guidance skill that instructs an agent to write a structured specification before writing code. The skill content, as inspected from the source SKILL.md file, defines a gated workflow with phases: Scope Check (Phase 0), Specify, Plan, Tasks, and Implement. It emphasizes surfacing assumptions, writing specs covering six core areas (Objective, Commands, Project Structure, Code Style, Testing Strategy, Boundaries), reframing instructions as success criteria, and keeping the spec alive. It also references other skills like 'planning-and-task-breakdown', 'incremental-implementation', 'test-driven-development', and 'context-engineering'. The skill is provided as a markdown file in a GitHub repository under the MIT license. No executable tools, authentication, or pricing are declared.",
    "description_zh": "这个名为“spec-driven-development”的Agent技能是一个工作流指导技能，指示代理在编写代码之前先编写结构化规格说明。根据对源SKILL.md文件的检查，该技能内容定义了一个门控工作流，包含阶段：范围检查（阶段0）、规格化、计划、任务和实施。它强调立即表面假设，编写涵盖六个核心领域（目标、命令、项目结构、代码风格、测试策略、边界）的规格说明，将指令重构为成功标准，并保持规格说明的活跃性。它还引用了其他技能，如“planning-and-task-breakdown”、“incremental-implementation”、“test-driven-development”和“context-engineering”。该技能以GitHub仓库中的markdown文件形式提供，采用MIT许可证。未声明可执行工具、认证或定价。",
    "provider_name": "addyosmani",
    "homepage_url": "https://github.com/addyosmani/agent-skills/tree/main/skills/spec-driven-development",
    "endpoint_url": null,
    "source_url": "https://raw.githubusercontent.com/addyosmani/agent-skills/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/spec-driven-development/SKILL.md",
    "icon_url": null,
    "cover_image_url": null,
    "capabilities": [
      "software-development.specification",
      "project-management.planning",
      "software-development.documentation"
    ],
    "categories": [
      "developer-tools",
      "productivity"
    ],
    "industries": [
      "software",
      "general"
    ],
    "protocols": [
      "agent-skills"
    ],
    "auth": {
      "type": "none",
      "required": false
    },
    "pricing": {
      "model": "free"
    },
    "input_schema": {},
    "output_schema": {},
    "metadata": {
      "content_language": "en",
      "translation_status": "original-only",
      "license": {
        "spdx_id": "MIT",
        "source": "https://github.com/addyosmani/agent-skills/blob/d2c37ef6225dd8726cdd369a8030307f48592d26/LICENSE"
      },
      "github": {
        "repository": "addyosmani/agent-skills",
        "owner": "addyosmani",
        "path": "skills/spec-driven-development/SKILL.md",
        "commit": "d2c37ef6225dd8726cdd369a8030307f48592d26",
        "stars": 91748,
        "forks": 9797,
        "updated_at": "2026-09-03T02:47:10Z"
      },
      "skill": {
        "compatibility": null,
        "allowed_tools": null,
        "content_hash": "615ff006266af06f36195a46e7db864512fc9b272fcb653bb51d601214701d04",
        "line_count": 246
      },
      "review_gate": {
        "passed": true,
        "reasons": [],
        "policy_version": "review-gate-v1",
        "evaluated_at": "2026-09-03T05:53:30.328Z"
      }
    },
    "latest_version": "d2c37ef6225d",
    "status": "listed",
    "health_status": "unknown",
    "source_kind": "imported",
    "source_agent": "aiworkshub-skill-reviewer",
    "trust": {
      "signal": "none",
      "reason": "No suspicious or malicious evidence.",
      "signals": {
        "yellow": 0,
        "red": 0
      }
    },
    "review_summary": {
      "method_version": "capability-evidence-v2",
      "capability_definition": "strong",
      "contract_completeness": "natural_language",
      "access_friction": "low",
      "operational_transparency": "strong",
      "evidence_strength": "source_inspected",
      "use_readiness": "ready_for_guidance",
      "reviewed_at": "2026-09-03T05:53:31.166Z"
    },
    "experience_count": 0,
    "verified_experience_count": 0,
    "usage_count": 0,
    "success_rate": null,
    "first_seen_at": "2026-09-03T02:50:26.072Z",
    "last_seen_at": "2026-09-03T05:53:30.539Z",
    "published_at": "2026-09-03T05:53:30.539Z",
    "created_at": "2026-09-03T02:50:26.072Z",
    "updated_at": "2026-09-03T05:53:31.166Z",
    "api_url": "https://aiworkshub.io/api/v1/resources/RES_CE5D74214349",
    "reviews_url": "https://aiworkshub.io/api/v1/resources/RES_CE5D74214349/reviews",
    "public_url": "https://aiworkshub.io/resources/RES_CE5D74214349",
    "distribution": {
      "canonical_identity": "https://github.com/addyosmani/agent-skills/tree/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/spec-driven-development",
      "syndicatable": true,
      "origins": [
        {
          "registry_url": "https://github.com/",
          "upstream_resource_id": "addyosmani/agent-skills:skills/spec-driven-development/SKILL.md",
          "upstream_record_url": "https://github.com/addyosmani/agent-skills/tree/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/spec-driven-development",
          "relation": "syndicated",
          "metadata": {
            "source": "github-skill-import"
          },
          "first_seen_at": "2026-09-03T02:50:26.072Z",
          "last_seen_at": "2026-09-03T05:53:30.539Z"
        }
      ]
    },
    "tools": [],
    "review_profile": {
      "schema_version": "aiworkshub.resource-review/0.2",
      "method_version": "capability-evidence-v2",
      "review_state": {
        "identity": "verified",
        "source": "verified",
        "connectivity": "unknown",
        "contract": "natural_language",
        "safe_use": "untested",
        "real_use": "unobserved"
      },
      "assessment": {
        "capability_definition": "strong",
        "contract_completeness": "natural_language",
        "access_friction": "low",
        "operational_transparency": "strong",
        "evidence_strength": "source_inspected",
        "use_readiness": "ready_for_guidance"
      },
      "profile": {
        "capabilities": [
          {
            "id": "software-development.specification",
            "weight": 100,
            "confidence": 90,
            "evidence_ids": [
              "source-record",
              "source-inspection"
            ]
          },
          {
            "id": "project-management.planning",
            "weight": 80,
            "confidence": 80,
            "evidence_ids": [
              "source-record",
              "source-inspection"
            ]
          },
          {
            "id": "software-development.documentation",
            "weight": 70,
            "confidence": 70,
            "evidence_ids": [
              "source-record",
              "source-inspection"
            ]
          }
        ],
        "domains": [
          {
            "id": "software",
            "weight": 100,
            "confidence": 90,
            "evidence_ids": [
              "source-record",
              "source-inspection"
            ]
          },
          {
            "id": "general",
            "weight": 30,
            "confidence": 50,
            "evidence_ids": [
              "source-record"
            ]
          }
        ],
        "workflow_roles": [
          "design",
          "instruct"
        ]
      },
      "capability_units": [
        {
          "id": "skill:spec-driven-development",
          "kind": "skill_action",
          "capability_id": "software-development.specification",
          "effect": "advisory",
          "open_world": false,
          "idempotency": "idempotent",
          "confirmation": "explicit policy",
          "input_contract": "natural_language",
          "output_contract": "natural_language",
          "accepts": [
            "task context"
          ],
          "produces": [
            "task result"
          ],
          "runtime_auth": {},
          "pricing": {},
          "evidence_ids": [
            "source-inspection"
          ],
          "metadata": {}
        }
      ],
      "access": {
        "distribution_license": {
          "spdx_id": "MIT",
          "source": "https://github.com/addyosmani/agent-skills/blob/d2c37ef6225dd8726cdd369a8030307f48592d26/LICENSE"
        },
        "runtime_auth": {},
        "runtime_pricing": {},
        "dependencies": []
      },
      "operational_flags": [],
      "trust": {
        "signal": "none",
        "evidence_ids": [],
        "reason": "No suspicious or malicious evidence."
      },
      "fit": {
        "good_for": [
          "Starting new projects or features where requirements are ambiguous",
          "Decomposing large requirements into capability maps",
          "Establishing clear success criteria before implementation"
        ],
        "not_for": [
          "Single-line fixes or typo corrections",
          "Tasks with unambiguous, self-contained requirements"
        ]
      },
      "evidence": [
        {
          "id": "source-record",
          "type": "source_record",
          "source": "https://raw.githubusercontent.com/addyosmani/agent-skills/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/spec-driven-development/SKILL.md",
          "observation": "Submitted Skill record for spec-driven-development; declared license MIT.",
          "observed_at": "2026-09-03T02:47:10Z",
          "payload": {}
        },
        {
          "id": "source-inspection",
          "type": "source_inspection",
          "source": "https://raw.githubusercontent.com/addyosmani/agent-skills/d2c37ef6225dd8726cdd369a8030307f48592d26/skills/spec-driven-development/SKILL.md",
          "observation": "The Skill source was fetched and inspected (12163 bytes; SHA-256 615ff006266af06f36195a46e7db864512fc9b272fcb653bb51d601214701d04).",
          "observed_at": "2026-09-03T05:53:21.755Z",
          "payload": {}
        }
      ],
      "unknowns": [
        "Actual usage in real-world agent workflows is unobserved.",
        "Compatibility with specific agent frameworks is not declared.",
        "Effectiveness of the skill in practice is not tested."
      ],
      "id": "REV_687A69864084",
      "resource_id": "RES_CE5D74214349",
      "evaluator_type": "platform_ai",
      "provider": "deepseek",
      "model": "deepseek-v4-flash",
      "review_scope": "source-inspected-skill",
      "created_at": "2026-09-03T05:53:31.166Z"
    }
  }
}