create-yss-spec 3.3.3 → 3.3.6

package/template/docs/templates/spec-template.md

@@ -7,17 +7,19 @@ owner: ai
 
 # 产品研发规格：<功能名称>
 
+填写前读取[中文写作规范](../process/document-writing.md)和 [Spec 对照](examples/lifecycle-writing-examples.md#2-spec让规则可以转成验收)。保留原规则、例外和不确定性；输入缺失时记录待确认项。
+
 ## 功能父 Ticket
 
 <Local：`docs/.scratch/<feature>/parent-ticket.md`；GitHub / GitLab：Issue URL / 编号>
 
 ## 问题陈述
 
-（从用户视角描述要解决的问题。）
+（说明哪个角色在什么场景遇到什么问题，给出来源及其限制。）
 
 ## 解决方案
 
-（从用户视角描述解决方案。）
+（说明本次改变的用户行为和范围，区分已确认规则与候选方案。）
 
 ## 用户故事
 
@@ -25,12 +27,16 @@ owner: ai
 
 ## 功能需求
 
+需求写明主体、触发条件和可观察结果；关联验收标准。不要用“完善、友好、高效”代替规则。
+
 | ID | 需求 | 优先级 | 备注 |
 |---|---|---|---|
 | FR-001 | | P0/P1/P2 | |
 
 ## 非功能需求
 
+命中时填写工作负载或适用条件、目标值及单位、验证方式与依据；尚未确认的目标保留为未决项，不补造性能承诺。
+
 | 类别 | 需求 | 目标 |
 |---|---|---|
 | 性能 | | |
@@ -38,6 +44,8 @@ owner: ai
 
 ## 验收标准
 
+关联需求 ID，按实际影响覆盖成功、拒绝、边界和恢复。保留“全部”“仅当”等限定；测试数据不能反向扩展业务规则。
+
 ```gherkin
 假如 <上下文>
 当 <操作>
@@ -47,7 +55,8 @@ owner: ai
 ## 产品总体设计 / 功能架构
 
 - 功能域与模块边界：
-- MVP / 非目标：
+- MVP：
+- 非目标：见本文“非目标范围”，此处不重复维护。
 - UI 影响：是 / 否
 - 产品总体设计：`docs/.scratch/<feature>/design/<feature>-product-overview-design.md`
 
@@ -99,4 +108,8 @@ owner: ai
 
 ## 非目标范围
 
+明确本次不交付什么及依据；与上游范围保持一致。
+
 ## 风险
+
+记录已知风险和未决项的影响、责任人、解决时点及接收方；尚未明确原因时保留现象和验证方法。

package/template/docs/templates/vertical-slice-ticket-template.md

@@ -4,7 +4,7 @@ status: ready-for-human
 
 # 垂直切片 Ticket：<标题>
 
-Status: ready-for-human
+填写前读取[中文写作规范](../process/document-writing.md)和 [Ticket 对照](examples/lifecycle-writing-examples.md#3-ticket把交付行为与实现就绪区分清楚)。状态只在 frontmatter 维护，正文记录依据。
 
 ## 父级
 
@@ -14,6 +14,8 @@ Status: ready-for-human
 
 描述本 Ticket 要交付的窄而完整的端到端行为。它必须贯穿所有受影响层，是可独立验证的垂直切片，不能只是某一层的横向任务。
 
+先用一句话写出用户操作及交付结果，再引用对应 Spec 规则、版本和本切片边界；不要重写冻结需求或填入未经确认的范围。
+
 ## 覆盖的用户故事
 
 - <用户故事 ID 或文本>
@@ -31,6 +33,8 @@ Status: ready-for-human
 
 ## 验收标准
 
+每项写条件、操作和可观察结果，关联上游规则；保留必要例外。测试未执行前保持未勾选。
+
 - [ ] 标准 1
 - [ ] 标准 2
 - [ ] 标准 3
@@ -92,7 +96,7 @@ Status: ready-for-human
 
 ## 阻塞关系
 
-- 无，可立即开始
+列出实际依赖、未决项、责任人和解除条件；尚未核验时写“待核验”。只有确认没有阻塞时才写“无”，无依赖不等于已通过实现就绪核验。
 
 ## 重路由状态
 
@@ -116,9 +120,9 @@ Status: ready-for-human
 
 ## 状态
 
-`ready-for-agent`
+状态依据：<当前版本合同、批准和就绪核验记录引用，以及尚未关闭的阻塞>。
 
-> 仅当阻塞关系为“无”且必要门禁已通过时填写 `ready-for-agent`；否则写明被哪个 Ticket 阻塞。
+> 默认 frontmatter 为 `ready-for-human`。仅在生命周期确认合同已批准且当前、阻塞已清除、全部适用门禁及就绪条件通过后更新为 `ready-for-agent`；本节不另维护第二个状态值。
 
 ## AI / 人工审查点
 

package/template/scripts/lib/profile-skill-sync.mjs

@@ -0,0 +1,336 @@
+import { createHash } from "node:crypto";
+import {
+  existsSync,
+  lstatSync,
+  mkdtempSync,
+  mkdirSync,
+  readFileSync,
+  readdirSync,
+  rmSync,
+  writeFileSync,
+} from "node:fs";
+import { spawnSync } from "node:child_process";
+import { tmpdir } from "node:os";
+import path from "node:path";
+
+function fail(message) {
+  throw new TypeError(message);
+}
+
+function safe(root, relative, label = "path") {
+  if (typeof relative !== "string" || !relative || path.isAbsolute(relative)) fail(`${label} 必须是仓库相对路径`);
+  const resolvedRoot = path.resolve(root);
+  const resolved = path.resolve(resolvedRoot, relative);
+  if (resolved === resolvedRoot || !resolved.startsWith(`${resolvedRoot}${path.sep}`)) fail(`${label} 越界: ${relative}`);
+  return resolved;
+}
+
+function files(directory, prefix = "") {
+  if (!existsSync(directory)) return new Map();
+  const info = lstatSync(directory);
+  if (!info.isDirectory()) fail(`技能源必须是目录: ${directory}`);
+  const result = new Map();
+  for (const entry of readdirSync(directory, { withFileTypes: true })) {
+    if (entry.isSymbolicLink()) fail(`跨仓同步不接受符号链接: ${path.join(directory, entry.name)}`);
+    const absolute = path.join(directory, entry.name);
+    const relative = prefix ? `${prefix}/${entry.name}` : entry.name;
+    if (entry.isDirectory()) {
+      for (const item of files(absolute, relative)) result.set(...item);
+    } else if (entry.isFile()) result.set(relative, readFileSync(absolute));
+  }
+  return result;
+}
+
+function digest(value) {
+  return createHash("sha256").update(value).digest("hex");
+}
+
+function sameTree(left, right) {
+  if (left.size !== right.size) return false;
+  for (const [name, content] of left) if (!right.get(name)?.equals(content)) return false;
+  return true;
+}
+
+function treeDigest(tree) {
+  const hash = createHash("sha256");
+  for (const [name, content] of [...tree.entries()].sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0)) {
+    hash.update(name);
+    hash.update("\0");
+    hash.update(content);
+    hash.update("\0");
+  }
+  return hash.digest("hex");
+}
+
+function patchedSource(root, profile, item) {
+  const source = safe(root, item.source ?? `.agents/skills/${item.id}`, "source");
+  const patchFile = safe(root, item.patch, "patch");
+  const sourceFiles = files(source);
+  const actualBaseline = treeDigest(sourceFiles);
+  if (actualBaseline !== item.source_tree_sha256) {
+    fail(`${profile}/${item.id} 适配基线冲突: 上游树预期 ${item.source_tree_sha256}，实际 ${actualBaseline}`);
+  }
+  const temporary = mkdtempSync(path.join(tmpdir(), "profile-skill-patch-"));
+  try {
+    for (const [name, content] of sourceFiles) {
+      const target = safe(temporary, name, "patch source file");
+      mkdirSync(path.dirname(target), { recursive: true });
+      writeFileSync(target, content);
+    }
+    const applied = spawnSync("git", ["apply", "--binary", "--whitespace=nowarn", patchFile], {
+      cwd: temporary,
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "pipe"],
+    });
+    if (applied.status !== 0) fail(`${profile}/${item.id} 补丁无法重放: ${applied.stderr.trim()}`);
+    return files(temporary);
+  } finally {
+    rmSync(temporary, { recursive: true, force: true });
+  }
+}
+
+function gitDirty(profileRoot, relativePaths) {
+  if (!relativePaths.length) return new Set();
+  const result = spawnSync("git", ["-C", profileRoot, "status", "--porcelain=v1", "--untracked-files=all", "--", ...relativePaths], {
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "pipe"],
+  });
+  if (result.status !== 0) fail(`无法读取目标工作树状态: ${result.stderr.trim()}`);
+  return new Set(result.stdout.split("\n").filter(Boolean).map((line) => line.slice(3).replace(/^"|"$/g, "")));
+}
+
+function dirtyMatch(dirty, relative) {
+  return [...dirty].some((entry) => entry === relative || entry.startsWith(`${relative}/`) || relative.startsWith(`${entry}/`));
+}
+
+function transformedSource(root, profile, item) {
+  const source = safe(root, item.source ?? `.agents/skills/${item.id}`, "source");
+  const sourceFiles = files(source);
+  const desired = item.files?.length
+    ? new Map(item.files.map((name) => {
+      if (!sourceFiles.has(name)) fail(`${profile}/${item.id} 适配源文件不存在: ${name}`);
+      return [name, sourceFiles.get(name)];
+    }))
+    : sourceFiles;
+  for (const replacement of item.replacements ?? []) {
+    const current = desired.get(replacement.file);
+    if (!current) fail(`${profile}/${item.id} 适配文件不存在: ${replacement.file}`);
+    const before = current.toString("utf8");
+    const count = before.split(replacement.from).length - 1;
+    const expected = replacement.count ?? 1;
+    if (count !== expected) fail(`${profile}/${item.id} 适配基线冲突: ${replacement.file} 中预期 ${expected} 处片段，实际 ${count} 处`);
+    desired.set(replacement.file, Buffer.from(before.split(replacement.from).join(replacement.to)));
+  }
+  return desired;
+}
+
+function compareTree(profile, id, targetRelative, current, desired, classification, changes) {
+  const names = new Set([...current.keys(), ...desired.keys()]);
+  for (const name of [...names].sort()) {
+    const before = current.get(name);
+    const after = desired.get(name);
+    if (before && after && before.equals(after)) continue;
+    changes.push({
+      profile,
+      skill: id,
+      classification,
+      status: before ? (after ? "updated" : "retired") : "added",
+      path: `${targetRelative}/${name}`,
+      before_sha256: before ? digest(before) : null,
+      after_sha256: after ? digest(after) : null,
+      content: after ?? null,
+    });
+  }
+}
+
+export function loadProfileSyncConfig(root, configPath = ".template-source/profile-skill-sync.json") {
+  const absolute = safe(root, configPath, "config");
+  const config = JSON.parse(readFileSync(absolute, "utf8"));
+  if (config.schema_version !== 1 || !config.profiles || typeof config.profiles !== "object") fail("profile skill sync 配置必须是 schema v1");
+  return config;
+}
+
+export function planProfileSkillSync({ root, config, selectedProfiles, dirtyProvider = gitDirty }) {
+  const names = selectedProfiles?.length ? selectedProfiles : Object.keys(config.profiles);
+  const canonicalRoot = safe(root, config.canonical_root ?? ".agents/skills", "canonical_root");
+  const changes = [];
+  const classifications = [];
+  const issues = [];
+  for (const profile of names) {
+    const definition = config.profiles[profile];
+    if (!definition) fail(`未知 profile: ${profile}`);
+    const profileRoot = safe(root, definition.target, `${profile}.target`);
+    if (!existsSync(path.join(profileRoot, "yss-project.yaml"))) issues.push({ profile, status: "missing_dependency", path: `${definition.target}/yss-project.yaml` });
+    const classified = new Map();
+    for (const [classification, items] of [
+      ["exact", (definition.exact ?? []).map(({ id }) => id)],
+      ["adapted", (definition.adapted ?? []).map(({ id }) => id)],
+      ["retired", definition.retired ?? []],
+      ["local-only", definition.local_only ?? []],
+      ["excluded", definition.excluded ?? []],
+      ["upstream", definition.upstream ?? []],
+    ]) {
+      for (const id of items) {
+        if (classified.has(id)) fail(`${profile}/${id} 同时声明为 ${classified.get(id)} 和 ${classification}，违反单向来源规则`);
+        classified.set(id, classification);
+      }
+    }
+    if (definition.upstream_manifest) {
+      const manifestPath = safe(root, definition.upstream_manifest, "upstream manifest");
+      if (!existsSync(manifestPath)) issues.push({ profile, status: "missing_dependency", path: definition.upstream_manifest });
+      else {
+        const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+        const declared = [...(definition.upstream ?? [])].sort();
+        const manifestIds = (manifest.skills ?? []).map(({ canonical }) => canonical).sort();
+        if (JSON.stringify(declared) !== JSON.stringify(manifestIds) || manifest.source_root !== ".agents/skills") {
+          issues.push({ profile, status: "adaptation_conflict", path: definition.upstream_manifest, message: "上游清单与 profile 单向来源声明不一致" });
+        }
+      }
+    }
+
+    for (const item of definition.exact ?? []) {
+      const sourceRelative = item.source ?? `.agents/skills/${item.id}`;
+      const targetRelative = item.target ?? `.agents/skills/${item.id}`;
+      const source = safe(root, sourceRelative, "source");
+      if (!existsSync(source)) {
+        issues.push({ profile, skill: item.id, status: "missing_dependency", path: sourceRelative });
+        continue;
+      }
+      compareTree(profile, item.id, targetRelative, files(safe(profileRoot, targetRelative, "target")), files(source), "exact", changes);
+      classifications.push({ profile, skill: item.id, classification: "exact" });
+    }
+
+    for (const item of definition.adapted ?? []) {
+      classifications.push({ profile, skill: item.id, classification: "adapted" });
+      if (item.strategy === "profile-owned") {
+        const targetRelative = item.target ?? `.agents/skills/${item.id}`;
+        const skillFile = safe(profileRoot, `${targetRelative}/SKILL.md`, "adapted target");
+        if (!existsSync(skillFile)) issues.push({ profile, skill: item.id, status: "missing_dependency", path: `${definition.target}/${targetRelative}/SKILL.md` });
+        else {
+          const content = readFileSync(skillFile, "utf8");
+          for (const marker of item.required_markers ?? []) if (!content.includes(marker)) issues.push({ profile, skill: item.id, status: "adaptation_conflict", path: `${definition.target}/${targetRelative}/SKILL.md`, marker });
+        }
+        continue;
+      }
+      const targetRelative = item.target ?? `.agents/skills/${item.id}`;
+      let desired;
+      try {
+        const sourceRelative = item.source ?? `.agents/skills/${item.id}`;
+        if (!existsSync(safe(root, sourceRelative, "source"))) {
+          issues.push({ profile, skill: item.id, status: "missing_dependency", path: sourceRelative });
+          continue;
+        }
+        if (item.strategy === "replace") desired = transformedSource(root, profile, item);
+        else if (item.strategy === "patch") {
+          if (!item.patch || !existsSync(safe(root, item.patch, "patch"))) {
+            issues.push({ profile, skill: item.id, status: "missing_dependency", path: item.patch ?? "patch" });
+            continue;
+          }
+          desired = patchedSource(root, profile, item);
+        } else fail(`${profile}/${item.id} 未知适配策略`);
+      } catch (error) {
+        issues.push({ profile, skill: item.id, status: "adaptation_conflict", message: error.message });
+        continue;
+      }
+      const targetFiles = files(safe(profileRoot, targetRelative, "target"));
+      const current = item.files?.length ? new Map(item.files.filter((name) => targetFiles.has(name)).map((name) => [name, targetFiles.get(name)])) : targetFiles;
+      compareTree(profile, item.id, targetRelative, current, desired, "adapted", changes);
+    }
+
+    for (const item of definition.assets ?? []) {
+      const source = safe(root, item.source, "asset source");
+      const target = safe(profileRoot, item.target ?? item.source, "asset target");
+      if (!existsSync(source)) {
+        issues.push({ profile, status: "missing_dependency", path: item.source });
+        continue;
+      }
+      const before = existsSync(target) ? readFileSync(target) : null;
+      const after = readFileSync(source);
+      if (!before?.equals(after)) changes.push({ profile, classification: "exact", status: before ? "updated" : "added", path: item.target ?? item.source, before_sha256: before ? digest(before) : null, after_sha256: digest(after), content: after });
+    }
+
+    for (const id of definition.retired ?? []) {
+      classifications.push({ profile, skill: id, classification: "retired" });
+      const targetRelative = `.agents/skills/${id}`;
+      const current = files(safe(profileRoot, targetRelative, "retired target"));
+      for (const [name, content] of current) changes.push({ profile, skill: id, classification: "retired", status: "retired", path: `${targetRelative}/${name}`, before_sha256: digest(content), after_sha256: null, content: null });
+    }
+    for (const id of definition.local_only ?? []) classifications.push({ profile, skill: id, classification: "local-only" });
+    for (const id of definition.excluded ?? []) classifications.push({ profile, skill: id, classification: "excluded" });
+    for (const id of definition.upstream ?? []) classifications.push({ profile, skill: id, classification: "upstream" });
+
+    const targetSkillRoot = safe(profileRoot, ".agents/skills", "profile skill root");
+    if (existsSync(targetSkillRoot)) {
+      for (const entry of readdirSync(targetSkillRoot, { withFileTypes: true })) {
+        if (!entry.isDirectory() || classified.has(entry.name)) continue;
+        const sourceSkill = path.join(canonicalRoot, entry.name);
+        if (!existsSync(sourceSkill) || !lstatSync(sourceSkill).isDirectory()) continue;
+        if (!sameTree(files(sourceSkill), files(path.join(targetSkillRoot, entry.name)))) {
+          issues.push({
+            profile,
+            skill: entry.name,
+            status: "unregistered_difference",
+            path: `${definition.target}/.agents/skills/${entry.name}`,
+            message: "同名 Skill 内容不同但未登记同步分类",
+          });
+        }
+      }
+    }
+
+    const changedPaths = [...new Set(changes.filter((item) => item.profile === profile).map((item) => item.path))];
+    const dirty = dirtyProvider(profileRoot, changedPaths);
+    for (const change of changes.filter((item) => item.profile === profile && dirtyMatch(dirty, item.path))) {
+      issues.push({ profile, skill: change.skill, status: "adaptation_conflict", path: `${definition.target}/${change.path}`, message: "目标含未提交改动" });
+    }
+  }
+  return { schema_version: 1, profiles: names, changes, classifications, issues };
+}
+
+export function applyProfileSkillSync({ root, config, plan, write = writeFileSync, remove = rmSync }) {
+  if (plan.issues.length) fail(`同步预检失败，共 ${plan.issues.length} 项问题`);
+  const snapshots = new Map();
+  const touched = [];
+  try {
+    for (const change of plan.changes) {
+      const profileRoot = safe(root, config.profiles[change.profile].target, "profile target");
+      const target = safe(profileRoot, change.path, "change target");
+      const current = existsSync(target) ? readFileSync(target) : null;
+      const currentHash = current ? digest(current) : null;
+      if (currentHash !== change.before_sha256) fail(`目标在预览后发生变化: ${change.profile}/${change.path}`);
+      snapshots.set(target, current);
+      touched.push(target);
+      if (change.content === null) remove(target, { force: true });
+      else {
+        mkdirSync(path.dirname(target), { recursive: true });
+        write(target, change.content);
+      }
+    }
+    for (const profile of plan.profiles) {
+      const profileRoot = safe(root, config.profiles[profile].target, "profile target");
+      for (const id of config.profiles[profile].retired ?? []) {
+        const retiredRoot = safe(profileRoot, `.agents/skills/${id}`, "retired skill");
+        if (!existsSync(retiredRoot)) continue;
+        if (!lstatSync(retiredRoot).isDirectory()) fail(`退役 Skill 目标不是目录: ${retiredRoot}`);
+        if (files(retiredRoot).size) fail(`退役 Skill 在预览后出现未纳管文件: ${retiredRoot}`);
+        remove(retiredRoot, { recursive: true, force: true });
+      }
+    }
+  } catch (error) {
+    for (const target of touched.reverse()) {
+      const before = snapshots.get(target);
+      if (before === null) remove(target, { force: true });
+      else {
+        mkdirSync(path.dirname(target), { recursive: true });
+        writeFileSync(target, before);
+      }
+    }
+    throw error;
+  }
+  return { ...plan, applied: plan.changes.length };
+}
+
+export function reportProfileSkillSync(plan) {
+  const counts = {};
+  for (const item of [...plan.changes, ...plan.issues]) counts[item.status] = (counts[item.status] ?? 0) + 1;
+  return { ...plan, changes: plan.changes.map(({ content, ...item }) => item), counts };
+}

package/template/scripts/sync-profile-skills

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { applyProfileSkillSync, loadProfileSyncConfig, planProfileSkillSync, reportProfileSkillSync } from "./lib/profile-skill-sync.mjs";
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+try {
+  const args = process.argv.slice(2);
+  const modes = ["--check", "--dry-run", "--apply"].filter((item) => args.includes(item));
+  if (modes.length > 1) throw new TypeError("--check、--dry-run、--apply 只能选择一个");
+  const profileArgs = [];
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (["--check", "--dry-run", "--apply", "--json"].includes(arg)) continue;
+    if (arg === "--profile") {
+      const value = args[index + 1];
+      if (!value || value.startsWith("--")) throw new TypeError("--profile 缺少值");
+      profileArgs.push(value);
+      index += 1;
+      continue;
+    }
+    if (arg.startsWith("--profile=")) profileArgs.push(arg.slice(10));
+    else throw new TypeError(`未知参数: ${arg}`);
+  }
+  const json = args.includes("--json");
+  const selectedProfiles = profileArgs.some((item) => item === "all") ? [] : profileArgs.flatMap((item) => item.split(",").filter(Boolean));
+  const config = loadProfileSyncConfig(root);
+  const plan = planProfileSkillSync({ root, config, selectedProfiles });
+  const result = args.includes("--apply") ? applyProfileSkillSync({ root, config, plan }) : plan;
+  const report = reportProfileSkillSync(result);
+  if (json) process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+  else {
+    process.stdout.write(`profile skills: ${report.profiles.join(", ")}\n`);
+    for (const [status, count] of Object.entries(report.counts)) process.stdout.write(`${status}: ${count}\n`);
+    for (const item of report.changes) process.stdout.write(`${item.profile}: ${item.status}: ${item.path}\n`);
+    for (const item of report.issues) process.stderr.write(`${item.profile}: ${item.status}: ${item.path ?? item.skill ?? item.message}\n`);
+  }
+  if (args.includes("--check") && (plan.changes.length || plan.issues.length)) process.exitCode = 1;
+  if (args.includes("--apply") && plan.issues.length) process.exitCode = 1;
+} catch (error) {
+  process.stderr.write(`${error.message}\n`);
+  process.exitCode = 1;
+}

package/template/skills-lock.json

@@ -18,7 +18,10 @@
       "revision": "c4d958f18cc947cb91cbe1bd48783fa4601cc18f"
     },
     "iloveZzz/yss-harness-design-agent": {
-      "revision": "3a358684c5684ada433dca4fd97ee187050ca6d8"
+      "revision": "41fb25425928153791f7d92a85eb717f4eb2d546"
+    },
+    "ayghri/i-have-adhd": {
+      "revision": "7b9069b39972e269e61bd95c2f66ebb90cac6a02"
     }
   },
   "skills": {
@@ -54,7 +57,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/code-review/SKILL.md",
-        "effectiveHash": "660ca39ab37b65099940b2e6a197089291e2fb74494ec93bbeb8e2fde6559465",
+        "effectiveHash": "9113c8cad19ee2b44120b7f324cac7246e63272cf50a28c4cae1a4d61a9b5290",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "12daafb9c4f77deb3c3303dc2e6f8a3c2a0ff7928fc004af959ba18b8bd38068",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -294,6 +297,21 @@
           ".pi/skills"
         ]
       },
+      "i-have-adhd": {
+        "source": "ayghri/i-have-adhd",
+        "sourceType": "git",
+        "skillPath": "skills/i-have-adhd/SKILL.md",
+        "effectiveHash": "efabaa2a67780462997fdebadee3a9731a16368d158c79c9df5ae50e0983debf",
+        "sourceRevision": "7b9069b39972e269e61bd95c2f66ebb90cac6a02",
+        "upstreamHash": "4c88635cbcb4765b63528d608d27589596840708e89607fda9c9fa5726c11f7e",
+        "adaptationRef": ".agents/skills/i-have-adhd/references/yss-adaptation.md",
+        "targets": [
+          ".agents/skills",
+          ".codex/skills",
+          ".cursor/skills",
+          ".pi/skills"
+        ]
+      },
       "implement": {
         "source": "mattpocock/skills",
         "sourceType": "github",
@@ -462,9 +480,9 @@
         "source": "iloveZzz/yss-harness-design-agent",
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/prototype-review/SKILL.md",
-        "effectiveHash": "d795e8a04a3473f606d98f70faafb8334673f085c9bf0816aa8c433f4be579ff",
-        "sourceRevision": "3a358684c5684ada433dca4fd97ee187050ca6d8",
-        "upstreamHash": "2e77b3093a758bb692fb3bda453c5c020d0523f875975e17e2731365f67432e1",
+        "effectiveHash": "df6f131bef0f52a96d307d98ab42d74888a9b72c5508911b5622913b334e8eab",
+        "sourceRevision": "41fb25425928153791f7d92a85eb717f4eb2d546",
+        "upstreamHash": "9206df8b6c555c1af1351e425c5ec99ec2a40263c6861607f1418b9c520873ab",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
           ".agents/skills",
@@ -683,7 +701,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-antd-design/SKILL.md",
         "effectiveHash": "92739eb34352fd70fbb52f4d9d6c6ac09aa02bc0155a4bd812a98cd5f933ff70",
-        "sourceRevision": "3a358684c5684ada433dca4fd97ee187050ca6d8",
+        "sourceRevision": "41fb25425928153791f7d92a85eb717f4eb2d546",
         "upstreamHash": "08ce99d45586d5ea19e25fdd9e9a6ede16e66f18992b70b87e0cd23f92343b16",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -698,7 +716,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-antdv-next-design/SKILL.md",
         "effectiveHash": "c7c07c5dc3716f578904559473d43d92878aa25a6a45c8827e288f0242d42b75",
-        "sourceRevision": "3a358684c5684ada433dca4fd97ee187050ca6d8",
+        "sourceRevision": "41fb25425928153791f7d92a85eb717f4eb2d546",
         "upstreamHash": "2942ed52dd58a38e51f09eb11254809334aeaed08f21cd081f09f35e6647a68c",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -788,7 +806,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-design-system/SKILL.md",
         "effectiveHash": "e69597b8b6a5ce4de5bd40f67630443b8176202f6b028b2ce146a2a1d062816f",
-        "sourceRevision": "3a358684c5684ada433dca4fd97ee187050ca6d8",
+        "sourceRevision": "41fb25425928153791f7d92a85eb717f4eb2d546",
         "upstreamHash": "90aaf06b2514353152464a4d032076fa9d5ef56272d8ad526f5544f3c22a2b00",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -913,7 +931,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-implementation-contract-compiler/SKILL.md",
-        "effectiveHash": "e88d2bf7138c48e4ac4e01555a4f0a3fc2d2d1faef3bd78bd098d9fa2bf418f3",
+        "effectiveHash": "cfa69127e633d485a6691d9e70737fd050401bee7e598971c42bf5d6825c0391",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -997,7 +1015,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-openapi-governance/SKILL.md",
-        "effectiveHash": "b6938f1eede04f21cce32a870e365684e83c64775b07293af9dbd64a17e9cee4",
+        "effectiveHash": "e33980c3964c4749ef900c7c27ee683ad4e5ff285e9adf234bc82687304dee30",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -1009,7 +1027,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-product-lifecycle/SKILL.md",
-        "effectiveHash": "5285de45bf23391837d891eb8513a2cb5cadac3a99fedffcda9dfa2fbbffff00",
+        "effectiveHash": "9bebb957fdd80cfe812605cec25cdb2d2c2ba229db2547f870efb00e2175b2a9",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -1021,9 +1039,9 @@
         "source": "iloveZzz/yss-harness-design-agent",
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-prototype-stage/SKILL.md",
-        "effectiveHash": "a30d795c53d6f42ae5654e812fcdd9781949333f9c2e1572b65c058761b44417",
-        "sourceRevision": "3a358684c5684ada433dca4fd97ee187050ca6d8",
-        "upstreamHash": "e8f2f3a507da6bf7be0582e4a4dd9659381da8e291755070698a1f51a4e33808",
+        "effectiveHash": "c87c7c38c9598c04f28cfa759fd6c1c12b2937b49e92f8171992d8346cb179e0",
+        "sourceRevision": "41fb25425928153791f7d92a85eb717f4eb2d546",
+        "upstreamHash": "aa78ef758ad3c515e94fb6b87d4e519f39a38e53bb3c82413d707f7d0f96f58b",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
           ".agents/skills",
@@ -1048,7 +1066,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/research/SKILL.md",
-        "effectiveHash": "0d8f94e6379ad56897a7821b4803a3ba72910e617aab730e47db719e6eb02807",
+        "effectiveHash": "bf209209dd5bd458a5a61a2468a3cecc9b2f41ca655503b21d67613584c2bdb1",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "75b7f9bbd7ccff6755a006f8b25d319a46ecbf6bd4b4c3323965ed9cb65e78ff",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -1099,9 +1117,9 @@
         "source": "iloveZzz/yss-harness-design-agent",
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-stage-decision/SKILL.md",
-        "effectiveHash": "159ec9269b8680826986009345f9067566e727a15380b887f16f6e1fd9672d00",
-        "sourceRevision": "3a358684c5684ada433dca4fd97ee187050ca6d8",
-        "upstreamHash": "2ec63f66aaf799d693cec0f0b5d71b8c4917e4e2822e0ddd519bc9b711fa3c95",
+        "effectiveHash": "a9d209ca8cf16bb8d0f9f6ea05cfedf6fb25928216f3872bc5a1ca5ac698d34a",
+        "sourceRevision": "41fb25425928153791f7d92a85eb717f4eb2d546",
+        "upstreamHash": "b9fe9d8f5009db0289123155f1662d8d21b34e26928d6728545da7f0c0bb0de1",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
           ".agents/skills",
@@ -1126,7 +1144,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-technical-design/SKILL.md",
-        "effectiveHash": "a4226303571483b115ef7134f9615440ce8b7d39f209be39e1bc16152e080a9f",
+        "effectiveHash": "06e7cdbf6441be90a19ec705388c1e164daefed5ace237c7e6595cf0c0f81e1f",
         "targets": [
           ".agents/skills",
           ".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": "46b29114de53cf4d8d92123006b211d7b3a5a142",
-  "templateCommit": "46b29114de53cf4d8d92123006b211d7b3a5a142",
+  "requestedRef": "99061076f951d9fdf2f54eaa24d1edf745aefa65",
+  "templateCommit": "99061076f951d9fdf2f54eaa24d1edf745aefa65",
   "manifestHash": "d194bb318a47c9c53b04292e97805c563ef7b296c2ca9b507cca498be7f52afe",
   "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": "6fe2b0f7444fdf19d3d23eca1c334195c551de01349d79ff0a1e468a3bb973f0",
-  "generatedAt": "2026-09-10T10:12:58.943Z"
+  "snapshotHash": "7e8bec077d452f2270c479e622009536ae12495f21936b3f36a0298f0085d7aa",
+  "generatedAt": "2026-09-10T17:59:33.887Z"
 }