v4.9.6: harden agentskill frontmatter compatibility

Author: franklinxkk

CHANGELOG.md

@@ -4,10 +4,10 @@ All notable changes to AI Delivery Spec are summarized here.
 
 ## v4.9.6 - 2026-06-27
 
-- Shortened `SKILL.md` YAML frontmatter `description` for agentskill.sh
-  directory compatibility while keeping trigger exclusions (no code-only
-  debugging, copy rewriting, or idea exploration with no delivery intent).
-- Updated README badge to v4.9.6.
+- Further simplified `SKILL.md` frontmatter `description` for agentskill.sh:
+  single-line, short, no folded YAML, no colon-space sequence, and no slash-heavy
+  parser edge cases.
+- Updated README badge and release metadata to v4.9.6.
 
 ## v4.9.5 - 2026-06-27
 

SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ai-delivery-spec
-description: Spec-driven delivery framework for product teams. Generates PRD, prototype, FRR, AC-YAML, WBS, and risk register. Supports Traditional, AI Native, and AI Coding work paths. Not for code-only syntax/debugging, copy rewriting, or idea exploration with no delivery intent.
+description: Create PRDs, prototypes, tests, AI runtime specs, and coding agent handoffs for product delivery. Excludes code debugging and copy rewriting.
 ---
 
 # AI Delivery Spec — Production Elastic Delivery Standard (v4.9.6)

agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "AI Delivery Spec"
-  version: "4.9.5"
+  version: "4.9.6"
   short_description: "Product-side SDD framework for PRD, prototype, acceptance, and coding-agent handoff."
   default_prompt: >
     Use $ai-delivery-spec / ai-delivery-spec. First run 0D triage

docs/awesome-submission-targets.md

@@ -146,7 +146,7 @@ CRM系统
 
 - [x] README first screen explains the problem in English.
 - [x] Apache-2.0 license is present.
-- [x] Latest release tag exists (`v4.9.5` after this release is pushed).
+- [x] Latest release tag exists (`v4.9.6` after this release is pushed).
 - [x] Changelog has a dated release section, not only `Unreleased`.
 - [x] Examples exist for CRM, traffic safety, education IT, and medical/hospital IT.
 - [x] Agent install paths are documented for clone, Skills CLI, and Claude Code.
@@ -212,7 +212,7 @@ Target-specific variants:
 | laolaoshiren/claude-code-skills-zh | 产品 / 需求 / 研发协同 | submitted / keep updated |
 | hesreallyhim/awesome-claude-code | Skills / Project Management | submit when repo TOC stabilizes |
 | VoltAgent/awesome-agent-skills | Agent Skills | submit after star threshold |
-| awesome-product-management | PRD / Product Ops | submit after v4.9.5 release |
-| awesome-ai-agents | Agent Governance / SDD | submit after v4.9.5 release |
+| awesome-product-management | PRD / Product Ops | submit after v4.9.6 release |
+| awesome-ai-agents | Agent Governance / SDD | submit after v4.9.6 release |
 | awesome-llmops | AI Runtime / Evaluation / Governance | submit only if AI runtime audience fits |
 | Product Hunt | Developer Tools / Productivity | launch after demo video and screenshots |

references/templates/ai-coding-prd-template.md

@@ -1,4 +1,4 @@
-# AI-Coding Full PRD Template (v4.9.5 Profile)
+# AI-Coding Full PRD Template (v4.9.6 Profile)
 
 Use this profile only when the user explicitly wants a coding agent, full AI
 implementation, machine-readable contracts, test stubs, or an implementation

references/templates/human-first-prd-template.md

@@ -1,4 +1,4 @@
-# Human-First Full PRD Template (v4.9.5 Profile)
+# Human-First Full PRD Template (v4.9.6 Profile)
 
 Use this profile when the PRD will be reviewed, developed, tested, outsourced,
 accepted, or archived by human teams. The document must be readable before it

scripts/validate_skill_consistency.py

@@ -194,14 +194,11 @@ def main() -> int:
         word_count = len(description.split())
         if word_count > 60:
             fail(f"description has {word_count} words; maximum is 60", failures)
-        for exclusion in (
-            "code-only",
-            "syntax/debugging",
-            "copy rewriting",
-            "idea exploration with no delivery intent",
-        ):
-            if exclusion not in description:
-                fail(f"description missing exclusion: {exclusion}", failures)
+        description_lower = description.lower()
+        if "code" not in description_lower or "debug" not in description_lower:
+            fail("description missing code/debug exclusion", failures)
+        if "copy rewriting" not in description_lower:
+            fail("description missing copy rewriting exclusion", failures)
 
     version_match = re.search(
         r"Production Elastic Delivery Standard \(v([0-9]+\.[0-9]+\.[0-9]+)\)",