From 70b9df480c1294fcb0d7b7fa06062e92a28f5efa Mon Sep 17 00:00:00 2001
From: yumoqing <yumoqing@gmail.com>
Date: Fri, 21 Aug 2026 18:41:09 +0800
Subject: [PATCH] =?UTF-8?q?fix(skill):=20=E7=9B=AE=E5=BD=95=E5=B1=82=20ess?=
 =?UTF-8?q?ential=20=E5=9F=BA=E7=A1=80=E8=A7=84=E8=8C=83=E5=BF=85=E6=98=BE?=
 =?UTF-8?q?=E7=A4=BA=E2=80=94=E2=80=94project-directory-spec=20=E6=A0=87?=
 =?UTF-8?q?=E8=AE=B0=20essential:true=EF=BC=8C=E7=9B=AE=E5=BD=95=E5=B1=82?=
 =?UTF-8?q?=E6=8E=92=E5=BA=8F=20essential=20=E4=BC=98=E5=85=88=EF=BC=8C?=
 =?UTF-8?q?=E9=81=BF=E5=85=8D=20global=20scope=20=E4=BD=8E=E4=BC=98?=
 =?UTF-8?q?=E5=85=88=E7=BA=A7=E8=A2=AB=E6=88=AA=E6=96=AD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 pipeline_core/skill_loader.py                      | 5 ++++-
 skills_library/all/project-directory-spec/SKILL.md | 1 +
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/pipeline_core/skill_loader.py b/pipeline_core/skill_loader.py
index 6a51481..d8124d6 100644
--- a/pipeline_core/skill_loader.py
+++ b/pipeline_core/skill_loader.py
@@ -66,6 +66,7 @@ class Skill:
     version: str = "1.0.0"
     capability: str = ""             # 配套能力名（如 task_capability / communication）
     tools: List[str] = field(default_factory=list)   # 配套工具名列表
+    essential: bool = False          # 基础规范：所有角色目录层必显示（如 project-directory-spec）
 
     @classmethod
     def from_file(cls, filepath: str, scope: str = "global",
@@ -77,6 +78,7 @@ class Skill:
         version = "1.0.0"
         capability = ""
         tools = []
+        essential = False
 
         try:
             with open(filepath, "r", encoding="utf-8") as f:
@@ -93,6 +95,7 @@ class Skill:
             scope = fm.get("scope", scope)
             capability = fm.get("capability", "") or ""
             tools = fm.get("tools", []) or []
+            essential = str(fm.get("essential", "")).lower() in ("true", "1", "yes")
 
         if not description:
             for line in content.split("\n"):
@@ -105,7 +108,7 @@ class Skill:
             name=name, path=filepath, description=description,
             content=content, scope=scope, scope_id=scope_id,
             trigger_keywords=trigger_keywords, version=version,
-            capability=capability, tools=tools,
+            capability=capability, tools=tools, essential=essential,
         )
 
     def to_prompt_block(self) -> str:
diff --git a/skills_library/all/project-directory-spec/SKILL.md b/skills_library/all/project-directory-spec/SKILL.md
index d989585..e4ae837 100644
--- a/skills_library/all/project-directory-spec/SKILL.md
+++ b/skills_library/all/project-directory-spec/SKILL.md
@@ -1,6 +1,7 @@
 ---
 name: project-directory-spec
 description: 项目目录规范——项目工作空间目录结构与各目录作用（README.md 项目说明 + repos/ 下按 项目工程文档(_pc)/应用(_app)/独立模块 三类独立仓库组织）。所有 SDLC 角色产出与检查前必读，路径以此为准。
+essential: true
 ---
 
 # 项目目录规范