feat: auto-load OpenSpec specs into compile/recompile/review prompts

When openspec/ directory exists, forge prompt commands automatically
inject OpenSpec behavioral requirements as additional context:
- Reads openspec/project.md (global context)
- Reads all openspec/specs/*/spec.md (capability specs)
- Injected as "Behavioral Requirements (OpenSpec)" section
- No dependency on OpenSpec package — just reads markdown files

Author: xycld

packages/cli/resolve.ts

@@ -2,7 +2,13 @@
 
 import { readFile } from "node:fs/promises";
 import path from "node:path";
-import { readGraphDocs, readNodeDocs, readNodeRefs, readGraphRefs } from "../core/index.js";
+import {
+  readGraphDocs,
+  readNodeDocs,
+  readNodeRefs,
+  readGraphRefs,
+  readOpenSpecContext,
+} from "../core/index.js";
 import type {
   CheckInput,
   CompileTask,
@@ -27,6 +33,7 @@ export function createResolver(root: string): ContextResolver {
         l1Files?: FileContent[];
         docs?: string;
         refs?: RefFile[];
+        openspec?: string;
       } = {};
 
       for (const ref of task.context) {
@@ -66,6 +73,9 @@ export function createResolver(root: string): ContextResolver {
           ctx.docs = (await readGraphDocs(root, l4Ref.id)) ?? undefined;
           ctx.refs = await readGraphRefs(root, l4Ref.id);
         }
+
+        // Auto-load OpenSpec behavioral requirements if openspec/ exists
+        ctx.openspec = (await readOpenSpecContext(root)) ?? undefined;
       }
 
       return ctx;

packages/core/index.ts

@@ -46,6 +46,7 @@ export {
   readL2Docs,
   readNodeRefs,
   readGraphRefs,
+  readOpenSpecContext,
 } from "./store.js";
 export type { CheckIssue, CheckReport, CheckInput, IssueSeverity } from "./check.js";
 export { check } from "./check.js";

packages/core/skill.ts

@@ -21,6 +21,7 @@ export interface ResolvedContext {
   readonly l1Files?: readonly FileContent[];
   readonly docs?: string;
   readonly refs?: readonly RefFile[];
+  readonly openspec?: string;
 }
 
 /** L1 源文件内容 */

packages/core/store.ts

@@ -186,6 +186,49 @@ async function readRefsDir(root: string, relDir: string): Promise<RefFile[]> {
   return refs;
 }
 
+// ── OpenSpec integration ──
+
+/** Read OpenSpec context if openspec/ exists. Returns null if not present. */
+export async function readOpenSpecContext(root: string): Promise<string | null> {
+  const openspecDir = path.join(root, "openspec");
+  try {
+    await readdir(openspecDir);
+  } catch {
+    return null;
+  }
+
+  const parts: string[] = [];
+
+  // Read project.md (global context)
+  try {
+    const projectMd = await readFile(path.join(openspecDir, "project.md"), "utf8");
+    parts.push("### Project Context\n\n" + projectMd);
+  } catch {
+    // no project.md
+  }
+
+  // Read all specs/*/spec.md (behavioral requirements)
+  const specsDir = path.join(openspecDir, "specs");
+  let capabilities: string[];
+  try {
+    capabilities = await readdir(specsDir);
+  } catch {
+    capabilities = [];
+  }
+
+  for (const cap of capabilities.toSorted()) {
+    try {
+      const specPath = path.join(specsDir, cap, "spec.md");
+      const content = await readFile(specPath, "utf8");
+      parts.push(`### ${cap}\n\n${content}`);
+    } catch {
+      // skip non-directories or missing spec.md
+    }
+  }
+
+  return parts.length > 0 ? parts.join("\n\n---\n\n") : null;
+}
+
 // ── Docs ──
 
 /** 读取节点的模块化文档 nodes/<nodeId>/docs.md，不存在返回 null */

packages/skills/prompt-builder.ts

@@ -192,6 +192,11 @@ function buildCompileInput(input: SkillInput): string[] {
     parts.push("", "### Reference Materials", "", formatRefs(resolved.refs));
   }
 
+  // OpenSpec 行为需求
+  if (resolved.openspec !== undefined) {
+    parts.push("", "### Behavioral Requirements (OpenSpec)", "", resolved.openspec);
+  }
+
   return parts;
 }
 
@@ -230,6 +235,11 @@ function buildRecompileInput(input: SkillInput): string[] {
     parts.push("", "### Reference Materials", "", formatRefs(resolved.refs));
   }
 
+  // OpenSpec 行为需求
+  if (resolved.openspec !== undefined) {
+    parts.push("", "### Behavioral Requirements (OpenSpec)", "", resolved.openspec);
+  }
+
   return parts;
 }
 
@@ -268,6 +278,11 @@ function buildReviewInput(input: SkillInput): string[] {
     parts.push("", "### Reference Materials", "", formatRefs(resolved.refs));
   }
 
+  // OpenSpec 行为需求
+  if (resolved.openspec !== undefined) {
+    parts.push("", "### Behavioral Requirements (OpenSpec)", "", resolved.openspec);
+  }
+
   return parts;
 }