create-yss-spec 2.2.10 → 3.0.0

package/template/scripts/lib/skill-registry.mjs

@@ -58,6 +58,19 @@ function requireStringArray(value, field, { nonEmpty = false } = {}) {
   }
 }
 
+function effectiveInvocationContract(registry, skill) {
+  const contract = registry.invocation_contract;
+  return {
+    ...contract.default,
+    ...contract.layer_defaults[skill.layer],
+    ...(contract.overrides[skill.id] ?? {})
+  };
+}
+
+function sameStringSet(left, right) {
+  return JSON.stringify([...new Set(left)].sort()) === JSON.stringify([...new Set(right)].sort());
+}
+
 function validateInvocationContract(registry, skill) {
   const contract = registry.invocation_contract;
   requireObject(contract, "invocation_contract");
@@ -102,11 +115,7 @@ function validateInvocationContract(registry, skill) {
   const overrideIds = Object.keys(contract.overrides);
   const knownIds = new Set(registry.skills.map((item) => item?.id).filter(Boolean));
   for (const skillId of overrideIds) if (!knownIds.has(skillId)) fail(`invocation_contract.overrides 引用了未登记技能: ${skillId}`);
-  const effective = {
-    ...contract.default,
-    ...contract.layer_defaults[skill.layer],
-    ...(contract.overrides[skill.id] ?? {})
-  };
+  const effective = effectiveInvocationContract(registry, skill);
   effective.trigger_conditions = [...new Set([...(effective.trigger_conditions ?? []), ...skill.impacts.map((impact) => `impact:${impact}`)])];
   if (!INVOCATION_MODES.has(effective.invocation_mode)) fail(`${skill.id}.invocation_mode 无效`);
   requireStringArray(effective.trigger_conditions, `${skill.id}.trigger_conditions`, { nonEmpty: true });
@@ -317,6 +326,23 @@ export function validateSkillRegistry(registry, { lock, routerContract, lifecycl
     }
   }
 
+  const registeredDependency = (name) => ids.has(name)
+    || aliases.has(name)
+    || externalIds.has(name)
+    || platformAliases.has(name)
+    || [...platformIds].some((key) => key.endsWith(`:${name}`));
+  for (const skill of skills) {
+    const effective = effectiveInvocationContract(registry, skill);
+    const required = effective.required_dependencies ?? [];
+    const optional = effective.optional_dependencies ?? [];
+    for (const dependency of [...required, ...optional]) {
+      if (!registeredDependency(dependency)) fail(`${skill.id} 的调用契约依赖引用了未登记技能: ${dependency}`);
+      if (dependency === skill.id) fail(`${skill.id} 的调用契约不得依赖自身`);
+    }
+    const overlap = required.filter((dependency) => optional.includes(dependency));
+    if (overlap.length) fail(`${skill.id} 的必需依赖与可选依赖重复: ${overlap.join(", ")}`);
+  }
+
   if (lock) {
     const shared = Object.keys(lock.skills?.shared ?? {}).sort();
     const registered = [...ids].sort();
@@ -367,6 +393,24 @@ export function validateSkillRegistry(registry, { lock, routerContract, lifecycl
         for (const name of names ?? []) if (!ids.has(name) && !aliases.has(name) && !externalIds.has(name)) fail(`Router 依赖引用了未登记技能: ${name}`);
       }
     }
+    for (const skillId of Object.keys(registry.invocation_contract.overrides)) {
+      const closure = routerContract.dependency_closure?.[skillId];
+      if (!closure) fail(`Router dependency_closure 缺少注册表覆写技能: ${skillId}`);
+      const skill = skills.find((item) => item.id === skillId);
+      const effective = effectiveInvocationContract(registry, skill);
+      const required = effective.required_dependencies ?? [];
+      const optional = effective.optional_dependencies ?? [];
+      const always = closure.always ?? [];
+      const conditional = Object.entries(closure)
+        .filter(([condition]) => condition !== "always")
+        .flatMap(([, names]) => names ?? []);
+      if (!sameStringSet(required, always)) {
+        fail(`${skillId} 的静态必需依赖与 Router always 不一致`);
+      }
+      if (!sameStringSet(optional, conditional)) {
+        fail(`${skillId} 的可选依赖与 Router 条件依赖不一致`);
+      }
+    }
   }
 
   if (lifecycleContract || existsSync(LIFECYCLE_CONTRACT)) {

package/template/scripts/lib/skill-supply-chain.mjs

@@ -1,5 +1,5 @@
 import { createHash } from "node:crypto";
-import { cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
+import { cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
 import { spawnSync } from "node:child_process";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -9,7 +9,7 @@ const SOURCE_ROOT = path.join(ROOT, ".agents/skills");
 const LOCK_PATH = path.join(ROOT, "skills-lock.json");
 const YSS_UI_MANIFEST_PATH = path.join(SOURCE_ROOT, ".yss-skills-manifest.json");
 export const PROJECTION_ROOTS = [".claude/skills", ".codex/skills", ".cursor/skills", ".hermes/skills", ".pi/skills", ".qoder/skills", ".trae/skills"];
-export const OBSOLETE = new Set(["to-" + "prd", "to-" + "issues", "design-an-interface", "qa", "request-refactor-plan", "ubiquitous-language", "edit-article", "obsidian-vault", "writing-great-skills", "code-review-process", "yss-domain-modeling", "yss-dir", "yss-duckdb", "yss-file", "yss-filerunner", "yss-db2mybatis", "yss-mail", "yss-mapper-dynamic", "yss-quality", "yss-sql-condition", "yss-sql-tpl", "yss-valuation", "yss-variable", "yss-openapi", "web-design-engineer", "web-video-presentation", "wireframe-prototype", "wizard", "git-guardrails-claude-code", "claude-handoff", "batch-grill-me", "product-design-prototype", "yss-dictionary", "yss-jdbc", "yss-log", "yss-taskflow", "yss-backend-scaffold-application", "yss-backend-scaffold-domain", "yss-backend-scaffold-infrastructure", "yss-backend-scaffold-web"]);
+export const OBSOLETE = new Set(["to-" + "prd", "to-" + "issues", "design-an-interface", "qa", "request-refactor-plan", "ubiquitous-language", "edit-article", "obsidian-vault", "writing-great-skills", "code-review-process", "yss-domain-modeling", "yss-dir", "yss-duckdb", "yss-file", "yss-filerunner", "yss-db2mybatis", "yss-mail", "yss-mapper-dynamic", "yss-quality", "yss-sql-condition", "yss-sql-tpl", "yss-valuation", "yss-variable", "yss-openapi", "web-design-engineer", "web-video-presentation", "wireframe-prototype", "wizard", "git-guardrails-claude-code", "claude-handoff", "batch-grill-me", "product-design-prototype", "research", "yss-dictionary", "yss-jdbc", "yss-log", "yss-taskflow", "yss-backend-scaffold-application", "yss-backend-scaffold-domain", "yss-backend-scaffold-infrastructure", "yss-backend-scaffold-web"]);
 export function obsoleteCanonicalResidues(names, obsolete = OBSOLETE) {
   return names.filter((name) => obsolete.has(name)).sort();
 }
@@ -147,6 +147,7 @@ export function syncSkills({ check = false } = {}) {
     for (const name of OBSOLETE) {
       const target = path.join(projection, name);
       if (check) { if (existsSync(target) || lstatSafe(target)?.isSymbolicLink()) drift.push(`obsolete projection: ${relative(target)}`); }
+      else if (lstatSafe(target)?.isSymbolicLink()) unlinkSync(target);
       else rmSync(target, { recursive: true, force: true });
     }
   }

package/template/scripts/verify-yss-dto-openapi-profile

@@ -37,6 +37,12 @@ function checkArrayData(field, label, direction) {
   ensure(Array.isArray(field.empty_value) && field.empty_value.length === 0, `${label}.empty_value 必须为 []`);
 }
 
+function checkFactory(factory, label, expectedArguments) {
+  ensure(factory && typeof factory === "object", `${label} 必须是对象`);
+  ensure(/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(factory.method ?? ""), `${label}.method 必须是 Java identifier`);
+  ensure(JSON.stringify(factory.arguments) === JSON.stringify(expectedArguments), `${label}.arguments 必须按顺序为 [${expectedArguments.join(", ")}]`);
+}
+
 try {
   const document = parseDocument(readFileSync(profilePath, "utf8"), { maxAliasCount: 0 });
   ensure(document && document.errors.length === 0, `wire profile YAML 无法解析: ${document?.errors?.map((error) => error.message).join("; ")}`);
@@ -69,6 +75,8 @@ try {
   for (const name of ["SingleResult", "MultiResult", "PageResult"]) {
     ensure(profile.wrappers[name].java_type.startsWith(`com.yss.cloud.dto.result.${name}<T>`), `${name} 必须来自 canonical result package`);
   }
+  checkFactory(profile.wrappers.SingleResult?.java_factory, "SingleResult.java_factory", ["data"]);
+  checkFactory(profile.wrappers.PageResult?.java_factory, "PageResult.java_factory", ["data", "totalCount", "pageSize", "pageIndex"]);
   const singleData = profile.wrappers.SingleResult?.data;
   ensure(singleData?.direction === "response", "SingleResult.data 必须为 response");
   ensure(singleData?.wire_shape === "endpoint-schema-or-null", "SingleResult.data 必须绑定 endpoint schema 或 null");

package/template/skills-lock.json

@@ -63,7 +63,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/ask-matt/SKILL.md",
-        "effectiveHash": "8a8818ec83e3e795619aadb262b48a4a6016bb534a32c3bd6e16030f70578922",
+        "effectiveHash": "485b2180230d2696990d7379deb7efe4660c8d5196877acb103254457fa1cdf9",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "0261a2abbd43cc5bb391878106cda2eb7c4eabdde9ba5701b51d831f6e98f658",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -689,25 +689,6 @@
           ".trae/skills"
         ]
       },
-      "research": {
-        "source": "mattpocock/skills",
-        "sourceType": "github",
-        "skillPath": "skills/engineering/research/SKILL.md",
-        "effectiveHash": "fb6fc6446ea4dc9db6e7863b89b77a0b4b0f1beca4a08c23d0d319fe96cd08c8",
-        "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
-        "upstreamHash": "75b7f9bbd7ccff6755a006f8b25d319a46ecbf6bd4b4c3323965ed9cb65e78ff",
-        "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
-        "targets": [
-          ".agents/skills",
-          ".claude/skills",
-          ".codex/skills",
-          ".cursor/skills",
-          ".hermes/skills",
-          ".pi/skills",
-          ".qoder/skills",
-          ".trae/skills"
-        ]
-      },
       "resolving-merge-conflicts": {
         "source": "mattpocock/skills",
         "sourceType": "github",
@@ -992,7 +973,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/wayfinder/SKILL.md",
-        "effectiveHash": "c9c5a3a2a26c9dcba33dbe2d16f6e8f0a426349e2c960e32de00b09da6a2faa0",
+        "effectiveHash": "f182c70ac8e345535519baa60626f9377ff1bbf101b682e3760f807d55298be1",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "93d2a866764b048ad641e82e27e7a1940fc370e7933470bffeb937fa1fb3922b",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -1204,7 +1185,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-ddd-scaffold-generator/SKILL.md",
-        "effectiveHash": "428be1965841945799d89ff0f347b0fa9740a688c166201832235566f436e7b0",
+        "effectiveHash": "a4e0fe42a2f113c6eaf55394bce32185dbe183ff11012b065a01331807cf93fb",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1252,7 +1233,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-domain/SKILL.md",
-        "effectiveHash": "ad101d88c7a1e2fc8c68d7e925bea4b6b24c1eec7f95f826fe0cfa6fdd1e59e3",
+        "effectiveHash": "ed3dfb550330e9a5435ef7eb8e2e01e6addcf8f7092ae68cc7ebbef6c413909d",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1268,7 +1249,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-dto/SKILL.md",
-        "effectiveHash": "b6b3df7cf1486cf63cab64a6f4b93fe24273cb58db85baa5adc628a5d55ebe07",
+        "effectiveHash": "4588bfd6417b7c7554fe93254614f2b0edb27f0ca7278fe280e40f7aedfeb726",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1466,7 +1447,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-product-lifecycle/SKILL.md",
-        "effectiveHash": "f69d056b6b82102cf95e3cca1dc7d597882fc89dbd536834ab89f7a02f73626f",
+        "effectiveHash": "62d2272f52cd54e51f04110903f09333cfe99021d56bdbbdd35fdcbb48b8c99a",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1498,7 +1479,26 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-repository/SKILL.md",
-        "effectiveHash": "b6c61be8756a3efa47a8ce4471474d2dead867f1eee316fd1442be6054a1ba48",
+        "effectiveHash": "6eb525dacb4b06508292d24c06bd6a78e141518d3ceb256e92ceec95865187b9",
+        "targets": [
+          ".agents/skills",
+          ".claude/skills",
+          ".codex/skills",
+          ".cursor/skills",
+          ".hermes/skills",
+          ".pi/skills",
+          ".qoder/skills",
+          ".trae/skills"
+        ]
+      },
+      "yss-research": {
+        "source": "mattpocock/skills",
+        "sourceType": "github",
+        "skillPath": "skills/engineering/research/SKILL.md",
+        "effectiveHash": "a0c69c6cff59bdb6d36b03d24cceb29698e76cd6aae88919bf864284737c3aaa",
+        "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
+        "upstreamHash": "75b7f9bbd7ccff6755a006f8b25d319a46ecbf6bd4b4c3323965ed9cb65e78ff",
+        "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1530,7 +1530,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-router/SKILL.md",
-        "effectiveHash": "995bd87158f50cd652379ae63e845a77d509e8e76266fad05ce6e19deb956566",
+        "effectiveHash": "e16cdf64b44e0738dbd6430ec3fc4e11de43a44c34dbd9806a5d79e7f7df2beb",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1578,7 +1578,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-stage-decision/SKILL.md",
-        "effectiveHash": "ee846c58ba39f4ce76d94db609f7690f3e79518af54478d7b97780febc8eade3",
+        "effectiveHash": "35484ecbc72f71b3ed4a8e445d3e1bcc3a4663fc86a1e8710b56546f2258225d",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1731,7 +1731,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-web-controller/SKILL.md",
-        "effectiveHash": "c574797baa09375c2d6d5fe3f38c04d8e0c509a7f68b4e49c60daa38d7819728",
+        "effectiveHash": "899c7ed2255cdf740be41d58048b8693c8b8bd0b298b8c6f3ee6772296b81c5b",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1795,7 +1795,7 @@
           "source": "project",
           "sourceType": "local",
           "skillPath": ".codex/skills/product-design/SKILL.md",
-          "effectiveHash": "68c51e896cbdcd9e3ddd0b88b97bd0064edf37e0eb1437291acb1e3d9ee48c0c",
+          "effectiveHash": "11dc7bbc9ac78ad0dc22d1a01efcdb958417aec81e79bea86c148684a744a90e",
           "targets": [
             ".codex/skills"
           ]

package/template.snapshot.json

@@ -3,8 +3,8 @@
   "templateName": "yss-spec-project-template",
   "templateSource": "github:iloveZzz/yss-spec-project-template",
   "templateRepository": "https://github.com/iloveZzz/yss-spec-project-template.git",
-  "requestedRef": "c2308bb36a1f835343af5de1ee9ec2666f9d18cb",
-  "templateCommit": "c2308bb36a1f835343af5de1ee9ec2666f9d18cb",
+  "requestedRef": "ec54212e2a3c3ab2f2496dc27c3979b6f2ecba03",
+  "templateCommit": "ec54212e2a3c3ab2f2496dc27c3979b6f2ecba03",
   "manifestHash": "1efcdfb92db0c48fcb951a0d87e7c4a7c8b1f14161d8c5f8eb441e70b2440537",
   "encodedPaths": {
     ".codex/skills/data-analytics/.gitignore": ".codex/skills/data-analytics/__yss_dotfile__.gitignore",
@@ -12,6 +12,6 @@
     ".codex/skills/product-design/templates/prototype/.npmrc": ".codex/skills/product-design/templates/prototype/__yss_dotfile__.npmrc",
     ".gitignore": "__yss_dotfile__.gitignore"
   },
-  "snapshotHash": "74c85841a696dda55eb30a17988739adc20bf166fc6db9846e4cb757513faa65",
-  "generatedAt": "2026-09-03T10:19:42.278Z"
+  "snapshotHash": "b230de7c4f709cfe9b3f5139de9a83878c443774ff9f23d34c8faa872672812f",
+  "generatedAt": "2026-09-03T16:56:40.983Z"
 }

package/template/.agents/skills/research/SKILL.md

@@ -1,12 +0,0 @@
----
-name: research
-description: Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent.
----
-
-Spin up a **background agent** to do the research, so you keep working while it reads.
-
-Its job:
-
-1. Investigate the question against **primary sources** — official docs, source code, specs, first-party APIs — not a secondary write-up of them. Follow every claim back to the source that owns it.
-2. Write the findings to a single Markdown file, citing each claim's source.
-3. Save it where the repo already keeps such notes; match the existing convention, and if there is none, put it somewhere sensible and say where.

package/template/.agents/skills/research/agents/openai.yaml

@@ -1,3 +0,0 @@
-interface:
-  display_name: "Research"
-  short_description: "Research from high-trust sources"

package/template/.claude/skills/research/SKILL.md

@@ -1,12 +0,0 @@
----
-name: research
-description: Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent.
----
-
-Spin up a **background agent** to do the research, so you keep working while it reads.
-
-Its job:
-
-1. Investigate the question against **primary sources** — official docs, source code, specs, first-party APIs — not a secondary write-up of them. Follow every claim back to the source that owns it.
-2. Write the findings to a single Markdown file, citing each claim's source.
-3. Save it where the repo already keeps such notes; match the existing convention, and if there is none, put it somewhere sensible and say where.

package/template/.claude/skills/research/agents/openai.yaml

@@ -1,3 +0,0 @@
-interface:
-  display_name: "Research"
-  short_description: "Research from high-trust sources"

package/template/.codex/skills/research/SKILL.md

@@ -1,12 +0,0 @@
----
-name: research
-description: Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent.
----
-
-Spin up a **background agent** to do the research, so you keep working while it reads.
-
-Its job:
-
-1. Investigate the question against **primary sources** — official docs, source code, specs, first-party APIs — not a secondary write-up of them. Follow every claim back to the source that owns it.
-2. Write the findings to a single Markdown file, citing each claim's source.
-3. Save it where the repo already keeps such notes; match the existing convention, and if there is none, put it somewhere sensible and say where.

package/template/.codex/skills/research/agents/openai.yaml

@@ -1,3 +0,0 @@
-interface:
-  display_name: "Research"
-  short_description: "Research from high-trust sources"

package/template/.cursor/skills/research/SKILL.md

@@ -1,12 +0,0 @@
----
-name: research
-description: Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent.
----
-
-Spin up a **background agent** to do the research, so you keep working while it reads.
-
-Its job:
-
-1. Investigate the question against **primary sources** — official docs, source code, specs, first-party APIs — not a secondary write-up of them. Follow every claim back to the source that owns it.
-2. Write the findings to a single Markdown file, citing each claim's source.
-3. Save it where the repo already keeps such notes; match the existing convention, and if there is none, put it somewhere sensible and say where.

package/template/.cursor/skills/research/agents/openai.yaml

@@ -1,3 +0,0 @@
-interface:
-  display_name: "Research"
-  short_description: "Research from high-trust sources"

package/template/.hermes/skills/research/SKILL.md

@@ -1,12 +0,0 @@
----
-name: research
-description: Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent.
----
-
-Spin up a **background agent** to do the research, so you keep working while it reads.
-
-Its job:
-
-1. Investigate the question against **primary sources** — official docs, source code, specs, first-party APIs — not a secondary write-up of them. Follow every claim back to the source that owns it.
-2. Write the findings to a single Markdown file, citing each claim's source.
-3. Save it where the repo already keeps such notes; match the existing convention, and if there is none, put it somewhere sensible and say where.

package/template/.hermes/skills/research/agents/openai.yaml

@@ -1,3 +0,0 @@
-interface:
-  display_name: "Research"
-  short_description: "Research from high-trust sources"

package/template/.pi/skills/research/SKILL.md

@@ -1,12 +0,0 @@
----
-name: research
-description: Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent.
----
-
-Spin up a **background agent** to do the research, so you keep working while it reads.
-
-Its job:
-
-1. Investigate the question against **primary sources** — official docs, source code, specs, first-party APIs — not a secondary write-up of them. Follow every claim back to the source that owns it.
-2. Write the findings to a single Markdown file, citing each claim's source.
-3. Save it where the repo already keeps such notes; match the existing convention, and if there is none, put it somewhere sensible and say where.

package/template/.pi/skills/research/agents/openai.yaml

@@ -1,3 +0,0 @@
-interface:
-  display_name: "Research"
-  short_description: "Research from high-trust sources"

package/template/.qoder/skills/research/SKILL.md

@@ -1,12 +0,0 @@
----
-name: research
-description: Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent.
----
-
-Spin up a **background agent** to do the research, so you keep working while it reads.
-
-Its job:
-
-1. Investigate the question against **primary sources** — official docs, source code, specs, first-party APIs — not a secondary write-up of them. Follow every claim back to the source that owns it.
-2. Write the findings to a single Markdown file, citing each claim's source.
-3. Save it where the repo already keeps such notes; match the existing convention, and if there is none, put it somewhere sensible and say where.

package/template/.qoder/skills/research/agents/openai.yaml

@@ -1,3 +0,0 @@
-interface:
-  display_name: "Research"
-  short_description: "Research from high-trust sources"

package/template/.trae/skills/research/SKILL.md

@@ -1,12 +0,0 @@
----
-name: research
-description: Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic researched, docs or API facts gathered, or reading legwork delegated to a background agent.
----
-
-Spin up a **background agent** to do the research, so you keep working while it reads.
-
-Its job:
-
-1. Investigate the question against **primary sources** — official docs, source code, specs, first-party APIs — not a secondary write-up of them. Follow every claim back to the source that owns it.
-2. Write the findings to a single Markdown file, citing each claim's source.
-3. Save it where the repo already keeps such notes; match the existing convention, and if there is none, put it somewhere sensible and say where.

package/template/.trae/skills/research/agents/openai.yaml

@@ -1,3 +0,0 @@
-interface:
-  display_name: "Research"
-  short_description: "Research from high-trust sources"