@pm_zhousl/xinyun-ai-init 2.0.0 → 3.0.0

package/init/xinyun-ai-init/README.md

@@ -1,162 +1,44 @@
-# xinyun-ai-init 初始化包
+# xinyun-ai-init v3 Skill Runtime
 
-当前规则版本：`2.0.0`，执行模型为 `shared-project-multi-conversation-runtime`。
+v3 将初始化包收敛为一套可以直接调用的 Skills、确定性路由器和最小项目控制面。新逻辑不创建固定角色、角色会话、team 目录或旧版本兼容运行时。
 
-本目录是 `@pm_zhousl/xinyun-ai-init` 释放到目标项目的规则和模板基线。CLI 只创建或覆盖 `xinyun-ai-init/`，不会创建 `xinyun-ai/`，也不会修改业务代码。
-
-## 当前执行模型
-
-v2 使用 `shared-project-multi-conversation-runtime`：
-
-- 每个目标项目维护一个共享 `projectContextId`。
-- 一个或多个宿主对话通过独立 `conversationBindingId` 接入同一项目上下文。
-- 每次用户交互先比较对话流 head 与本对话游标；没有变化时静默继续，有变化时只读取增量。
-- 每个对话只写自己的不可变事件流，避免多个对话追加同一个 JSON 文件造成覆盖。
-- 新安装不创建固定角色或角色专属会话；Skills 仍按任务事实执行。
-
-## 新对话重新接管同一项目
-
-每次新建对话都按“重新接管同一个项目”处理，不依赖上一段聊天上下文。宿主 AI 进入项目根目录后，先读取 `AGENTS.md`，再按目标项目 `xinyun-ai/index/control-plane-index.json` 中的 `authoritativeBootstrapOrder` 读取控制面文件，核对项目身份、当前任务、任务索引、任务图、项目快照和最近交接。
-
-接管结果写入目标项目自己的 `xinyun-ai/index/re-takeover-record.json`，并更新项目索引中的理解状态。快照源文件哈希未变化时采用增量理解；发生变化、缺少文件或控制面冲突时，记录差异并进入 `partial`、`stale` 或 `blocked`。
-
-`contextStatus=context-ready` 只表示新对话已经可以可靠继续分析项目；不代表可以写入。写入仍必须通过增量同步、任务租约、七类宿主交互、任务控制面一致性、权限和用户确认门禁。新对话的 thread ID 只能作为 `host-thread` 引用，不能当作 `providerSessionId`。
-
-完整规则见 `rules/v2.0.0-shared-project-conversations.md`。
-
-## 初始化授权
-
-用户发送一句话入口后，视为已授权宿主 AI 根据当前项目事实创建或补齐最小 `xinyun-ai/` 和极简 `AGENTS.md`。该授权只覆盖 AI 控制面，不包含业务代码、配置、数据库、依赖、构建脚本、测试逻辑、API、UI、业务流程、Git 写入或 npm 发布。
-
-## 首次读取
-
-1. `version.json`
-2. `rules/v2.0.0-shared-project-conversations.md`
-3. `templates/AGENTS.template.md`
-4. `templates/core-rules.template.md`
-5. `templates/manifest.template.json`
-6. `templates/project-index.template.json`
-7. `templates/task-index.template.json`
-8. `templates/task-graph.template.json`
-9. `templates/session-binding.template.json`
-10. `templates/skills-registry.template.json`
-
-先识别项目根、工作区、仓库范围和现有 AI 沉淀，再判断是全新初始化还是 v1 项目升级。
-
-## 新项目最小控制面
-
-根据目标项目事实创建：
+## 快速接入
 
 ```text
-AGENTS.md
-xinyun-ai/
-  README.md
-  manifest.json
-  project-identity.json
-  project-context.json
-  project-status.json
-  preflight-report.json
-  onboarding-report.json
-  current-task.md
-  init-result.json
-  takeover-gate.json
-  rules/core-rules.md
-  index/project-index.json
-  index/control-plane-index.json
-  conversations/registry.json
-  conversations/bindings/
-  tasks/task-index.json
-  tasks/task-graph.json
-  tasks/.transactions/
-  tasks/.idempotency/
-  skills/registry.json
-  skills/assignments.json
-  skills/routes/
-  skills/usage-records/
-  coordination/project-facts.json
-  coordination/change-ledger.json
-  coordination/conflict-records/
-  coordination/streams/
-  coordination/cursors/
-  coordination/sync-checks/
-  coordination/leases/
-  handoffs/
-  migrations/shared-project-conversations/
+npx --yes @pm_zhousl/xinyun-ai-init@latest --force --offline
 ```
 
-不得从 npm 研发主项目复制任务、会话、历史或项目事实。所有值都必须从当前目标项目重新发现和验证。
-
-## 任务先登记
-
-普通咨询默认不创建正式任务。出现以下任一条件时必须先登记任务：
-
-- 需要持续跟踪或后续恢复。
-- 需要修改任何文件。
-- 需要用户确认或独立授权。
-- 需要跨阶段执行多个 Skills。
-- 需要记录依赖、阻塞、交接或交付证据。
+CLI 只管理当前项目的 `xinyun-ai-init/`，不修改业务代码。初始化完成后，宿主 AI 读取本文件和 `rules/v3-skill-runtime.md`，再调用：
 
-正式任务必须在一个事务中准备、校验并原子更新：
-
-1. `xinyun-ai/tasks/<taskId>.md`
-2. `xinyun-ai/tasks/task-index.json`
-3. `xinyun-ai/tasks/task-graph.json`
-4. `xinyun-ai/current-task.md`
-
-四份状态不一致时进入 `blocked`，不得选择 Skill 或修改业务文件。重复请求按项目身份、请求指纹、父任务和任务类型生成幂等键并复用原任务。
-
-## Skill 路由
-
-Skill 只按任务类型、技术栈、端、语言、运行时、平台、框架、风险、依赖、权限和项目显式绑定选择。不得使用固定角色身份参与路由。
-
-一个任务可以选择多个 Skills。每个执行阶段创建独立 `skillRunId`，写入 `xinyun-ai/skills/usage-records/`，并在任务节点登记执行顺序、输入/输出证据、工具、降级原因和未验证范围。
-
-缺少 Skill、依赖、权限或可信来源时只能 fallback、blocked 或 manual-required；不自动安装，不伪造完成。
-
-## 项目上下文与对话绑定
-
-`projectContextId` 是项目共享上下文标识；每个宿主对话登记独立 `conversationBindingId` 和 `sessionRefType/sessionRef`。普通线程 ID 只能作为 `host-thread` 引用，不能当作 `providerSessionId`。
-
-ready 前必须取得并核验以下七类证据：
-
-1. create-or-reuse
-2. send
-3. receive
-4. query-status
-5. recover
-6. close
-7. control-file-read-write
-
-同时必须证明对话属于当前项目根、工作区、仓库范围和 cwd。跨对话共享还必须验证事件写入、head 比较、增量消费、游标恢复和冲突阻断。证据缺失、冲突或不可验证时保持 `partial`、`blocked` 或 `manual-required`。
-
-## 修改和发布授权
-
-代码、配置、数据库、依赖、构建脚本、测试逻辑、API、UI 或业务流程修改前，必须先输出改动计划并等待用户明确确认。
+```text
+node xinyun-ai-init/runtime/route-skill.js --facts <task-facts.json>
+```
 
-数据库连接/SQL、Git 写入和 npm 发布分别使用独立授权。任务创建、Skill 选择、测试通过或开发确认都不能推导 npm 发布授权。
+路由器返回稳定的 Skill 顺序、输入事实、权限门禁和未满足条件。实际工具调用仍由宿主 AI 在确认门禁后完成。
 
-## v1 项目升级
+## 内置 Skills
 
-目标项目存在 `team/`、`role-execution/`、角色会话绑定或角色 Skill 分配时：
+`skills/registry.json` 内置以下 Skills：项目接管、需求分析、技术设计、实现、验证、安全审查、发布审查和交接同步。每个 Skill 都有触发条件、输入、输出、权限、工具和证据格式。
 
-1. 使用 `multi-conversation-migration.template.json` 创建迁移事务和 before hash。
-2. 建立旧材料清单，不删除或覆盖旧文件。
-3. 将活动角色任务转换为普通任务节点，保留原任务 ID、状态、依赖、证据和时间。
-4. 原角色只写入 `legacyRoleId`，不得参与新路由。
-5. 旧角色材料登记为 `legacy/read-only`。
-6. 无法可靠转换时进入 `manual-required`，不得猜测。
-7. 校验任务文件、索引、图、项目上下文、对话注册表和 Skill 记录后写 after hash 并提交。
+## 运行规则
 
-重复升级必须复用同一迁移事务。中断时按事务阶段恢复；发现新任务仍写入角色目录时必须阻断。
+1. 每次用户交互先读取目标项目自己的 `xinyun-ai/` 控制面。
+2. 正式任务先登记，再调用路由器。
+3. 路由只使用任务事实、技术栈、框架、风险、依赖和权限，不使用角色字段。
+4. 修改前必须输出计划并等待用户确认。
+5. Skill 运行、验证和交付结果写回目标项目自己的 `xinyun-ai/`。
+6. 没有新事件时静默继续；有新事件时只读取增量事件和受影响事实。
 
-v1.5-v1.16 的版本化规则、旧角色模板和历史行为证据仍随包保留，只用于迁移识别和兼容验证，不适用于新安装或新任务。
+## v2 或更早项目升级
 
-## CodeGraph
+升级时由宿主 AI 先执行：
 
-结构性问题优先使用目标项目已有的健康 CodeGraph。缺少 `.codegraph/` 且命令可用时，可按项目入口授权执行一次 `codegraph init -i`；不得自动安装工具或修改业务环境。状态未知或失败时记录未验证范围并按任务风险降级或阻断。
+```text
+node xinyun-ai-init/runtime/migrate-v3.js --project-root <project-root>
+```
 
-## 完成条件
+脚本默认只生成合并和清理预览。确认后加 `--apply`，仅处理已知的角色、team、旧会话和重复兼容目录；项目事实、任务结果和必要证据先合并为 v3 摘要。旧运行逻辑不会继续参与新路由。
 
-初始化或升级只有在项目身份、共享项目上下文、至少一个有效对话绑定、增量同步、七类宿主证据、任务控制面一致性、Skill 注册、必要 CodeGraph 检查、敏感扫描、写回和恢复证据满足时才能标记 `ready`。
+## npm 发布
 
-交付必须说明：当前模式、实际创建/更新文件、项目概览、项目上下文、活动对话和同步状态、任务和 Skill 记录、CodeGraph、授权状态、旧材料迁移、测试结果、阻塞、未验证范围和下一动作。
+维护者发布固定使用 `npm run publish:token`，只在安全提示中输入一次 token，不要求 `npm login`、环境变量或第二会话验证。npm 发布仍需目标版本的单独授权。

package/init/xinyun-ai-init/rules/v3-skill-runtime.md

@@ -0,0 +1,45 @@
+# v3 Skill Runtime 规则
+
+## 核心模型
+
+- 一个项目维护一个共享 `projectContextId`，对话使用独立 `conversationBindingId`。
+- Skill 是可调用能力包，不是角色。任何 `roleId`、角色名称或角色优先级都不得参与路由。
+- npm 包只提供 Skill 契约、路由器、模板和验证器；宿主 AI 负责实际工具调用。
+- 旧角色、team、角色会话和 v1 运行规则已经从 v3 运行模型移除。
+
+## 调用顺序
+
+1. 检查项目根目录和当前 `xinyun-ai/` 控制面。
+2. 执行交互增量同步，比较活动流 head 与当前游标。
+3. 需要持续跟踪或执行时，先登记任务。
+4. 将任务事实写入临时 facts 文件并调用 `runtime/route-skill.js`。
+5. 检查路由返回的权限、依赖、冲突和确认门禁。
+6. 计划经用户确认后，按返回顺序调用 Skill。
+7. 每次 Skill 运行记录 `skillRunId`、输入、输出、工具、证据和未验证范围。
+8. 验证后写回任务、项目事实、事件流和交付记录。
+
+## 路由规则
+
+- 路由输入：任务类型、端、语言、运行时、平台、框架、风险、依赖和权限。
+- 选择顺序由 registry 中的稳定 `order` 决定，不依赖目录扫描顺序。
+- 依赖或权限不足时返回 `blocked`；事实不足时返回 `fallback`。
+- 测试在当前对话执行时标记为 `self-check`，不能伪造独立审查。
+
+## 快速路径
+
+- 默认只读取项目身份、当前任务、控制面索引、项目上下文、任务图和核心规则。
+- 不执行 CodeGraph、全量业务扫描、数据库连接、Git 写入、依赖安装或 npm 发布。
+- 框架、迁移和专项材料只有在路由结果明确需要时才加载。
+
+## 升级清理
+
+- v3 升级先生成合并摘要和清理预览。
+- 只有 `--apply` 且清单哈希未变化时才删除已知旧目录。
+- 只合并项目身份、任务、决策、验证和未完成事项；不把旧角色字段带入活动 Skill 路由。
+- 清理失败、哈希冲突或无法识别的文件保持 `blocked`，不得强制删除。
+
+## 安全和授权
+
+- 不记录 token、密码、私钥、连接串或未经脱敏的项目内容。
+- 业务文件、配置、数据库、API、UI、依赖和构建流程修改必须先确认。
+- npm 发布必须由用户针对目标版本单独授权。

package/init/xinyun-ai-init/runtime/migrate-v3.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const crypto = require("crypto");
+const path = require("path");
+
+const args = new Set(process.argv.slice(2));
+const rootIndex = process.argv.indexOf("--project-root");
+const projectRoot = rootIndex >= 0 ? path.resolve(process.argv[rootIndex + 1]) : process.cwd();
+const apply = args.has("--apply");
+const controlRoot = path.join(projectRoot, "xinyun-ai");
+const migrationRoot = path.join(controlRoot, "migrations", "v3-skill-runtime");
+const knownLegacy = [
+  "team",
+  path.join("tasks", "role-execution"),
+  path.join("sessions", "roles"),
+  "sessions/provider-session-bindings.json"
+];
+
+function hash(value) {
+  return crypto.createHash("sha256").update(value).digest("hex");
+}
+
+function inventoryPath(relative) {
+  const normalized = relative.replace(/\\/g, "/");
+  const full = path.join(controlRoot, normalized);
+  if (!fs.existsSync(full)) return { relative: normalized, exists: false, files: [] };
+  const stat = fs.statSync(full);
+  if (stat.isFile()) return { relative: normalized, exists: true, files: [normalized] };
+  const files = [];
+  function walk(dir) {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      const fullEntry = path.join(dir, entry.name);
+      const rel = path.relative(controlRoot, fullEntry).replace(/\\/g, "/");
+      if (entry.isDirectory()) walk(fullEntry);
+      else files.push(rel);
+    }
+  }
+  walk(full);
+  return { relative: normalized, exists: true, files };
+}
+
+function redact(value) {
+  if (typeof value === "string") {
+    return value
+      .replace(/(token|password|secret|authorization|privateKey)\s*[:=]\s*[^\s,}]+/gi, "$1=[REDACTED]")
+      .replace(/Bearer\s+[A-Za-z0-9._-]+/gi, "Bearer [REDACTED]");
+  }
+  if (Array.isArray(value)) return value.map(redact);
+  if (value && typeof value === "object") return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, redact(item)]));
+  return value;
+}
+
+function collectFacts() {
+  const relativePaths = [
+    "project-identity.json",
+    "project-context.json",
+    "current-task.md",
+    "tasks/task-index.json",
+    "tasks/task-graph.json",
+    "coordination/project-facts.json",
+    "coordination/change-ledger.json"
+  ];
+  const facts = {};
+  for (const relative of relativePaths) {
+    const full = path.join(controlRoot, relative);
+    if (!fs.existsSync(full)) continue;
+    const text = fs.readFileSync(full, "utf8");
+    try {
+      facts[relative] = redact(JSON.parse(text));
+    } catch (error) {
+      facts[relative] = redact(text);
+    }
+  }
+  return facts;
+}
+
+const legacyInventory = knownLegacy.map(inventoryPath);
+const summary = {
+  schemaVersion: 1,
+  migrationVersion: "3.0.0",
+  mode: apply ? "apply" : "preview",
+  projectRootHash: hash(path.resolve(projectRoot)),
+  legacyInventory,
+  mergeSources: ["project-identity.json", "project-context.json", "current-task.md", "tasks/", "coordination/"],
+  mergeTarget: "xinyun-ai/migrations/v3-skill-runtime/merged-facts.json",
+  deleteTargets: legacyInventory.filter((item) => item.exists).map((item) => item.relative),
+  status: "preview",
+  generatedAt: new Date().toISOString()
+};
+
+if (!fs.existsSync(controlRoot)) {
+  summary.status = "blocked";
+  summary.blockedReason = "missing-xinyun-ai-control-plane";
+} else if (apply) {
+  fs.mkdirSync(migrationRoot, { recursive: true });
+  const mergedFacts = {
+    schemaVersion: 1,
+    sourcePaths: summary.mergeSources,
+    facts: collectFacts(),
+    preservedAsFacts: true,
+    legacyRuntimeRemoved: true,
+    generatedAt: summary.generatedAt
+  };
+  fs.writeFileSync(path.join(migrationRoot, "merged-facts.json"), `${JSON.stringify(mergedFacts, null, 2)}\n`, "utf8");
+  for (const item of legacyInventory.filter((entry) => entry.exists)) {
+    fs.rmSync(path.join(controlRoot, item.relative), { recursive: true, force: true });
+  }
+  summary.status = "applied";
+}
+
+fs.mkdirSync(migrationRoot, { recursive: true });
+fs.writeFileSync(path.join(migrationRoot, "migration-summary.json"), `${JSON.stringify(summary, null, 2)}\n`, "utf8");
+process.stdout.write(`${JSON.stringify(summary, null, 2)}\n`);
+if (summary.status === "blocked") process.exitCode = 1;

package/init/xinyun-ai-init/runtime/route-skill.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const crypto = require("crypto");
+const path = require("path");
+
+const runtimeRoot = path.resolve(__dirname, "..");
+const registry = JSON.parse(fs.readFileSync(path.join(runtimeRoot, "skills", "registry.json"), "utf8"));
+const args = process.argv.slice(2);
+const factsIndex = args.indexOf("--facts");
+const factsPath = factsIndex >= 0 ? args[factsIndex + 1] : null;
+const facts = factsPath ? JSON.parse(fs.readFileSync(path.resolve(process.cwd(), factsPath), "utf8")) : {};
+
+const taskType = facts.taskType || "unknown";
+const riskTerms = new Set((facts.riskTerms || []).map((item) => String(item).toLowerCase()));
+const permissions = new Set(facts.permissionScope || []);
+const requiresConversationSync = Boolean(facts.requiresConversationSync);
+const taskFacts = { ...facts, taskType, riskTerms: [...riskTerms] };
+
+function triggerMatches(skill) {
+  const trigger = skill.triggers || {};
+  if (trigger.taskTypes && !trigger.taskTypes.includes(taskType)) return false;
+  if (trigger.riskTerms && !trigger.riskTerms.some((term) => riskTerms.has(term))) return false;
+  if (trigger.requiresPermission && !permissions.has(trigger.requiresPermission)) return false;
+  if (trigger.requiresConversationSync && !requiresConversationSync) return false;
+  return true;
+}
+
+function blockedReason(skill) {
+  const required = skill.permissions || [];
+  const missing = required.filter((permission) => !permissions.has(permission) && permission !== "control-plane-read");
+  return missing.length ? `missing-permission:${missing.join(",")}` : null;
+}
+
+const ordered = [...registry.skills].sort((left, right) => left.order - right.order || left.skillId.localeCompare(right.skillId));
+const selected = [];
+const rejected = [];
+const blocked = [];
+for (const skill of ordered) {
+  if (!triggerMatches(skill)) continue;
+  const reason = blockedReason(skill);
+  if (reason) {
+    blocked.push({ skillId: skill.skillId, reason });
+    continue;
+  }
+  selected.push({ skillId: skill.skillId, name: skill.name, order: skill.order, permissions: skill.permissions, tools: skill.tools, input: skill.input, output: skill.output, evidence: skill.evidence });
+}
+
+if (selected.length === 0) {
+  rejected.push({ reason: "no-matching-skill", taskType });
+}
+
+const route = {
+  schemaVersion: 3,
+  routeId: `route-${Date.now()}`,
+  taskFacts,
+  routeFingerprint: crypto.createHash("sha256").update(JSON.stringify({ taskFacts, registryVersion: registry.registryVersion })).digest("hex"),
+  candidateSkills: ordered.map((skill) => skill.skillId),
+  selected,
+  rejected,
+  fallback: selected.length ? [] : [{ skillId: "manual-required", reason: "no-matching-skill" }],
+  blocked,
+  selectionOrder: "stable-order-then-skill-id",
+  status: blocked.length && !selected.length ? "blocked" : selected.length ? "selected" : "fallback",
+  registryVersion: registry.registryVersion,
+  generatedAt: new Date().toISOString()
+};
+
+process.stdout.write(`${JSON.stringify(route, null, 2)}\n`);

package/init/xinyun-ai-init/runtime-manifest.json

@@ -0,0 +1,26 @@
+{
+  "schemaVersion": 1,
+  "runtimeVersion": "3.0.0",
+  "files": [
+    "README.md",
+    "version.json",
+    "rules/v3-skill-runtime.md",
+    "runtime/route-skill.js",
+    "runtime/migrate-v3.js",
+    "skills/registry.json",
+    "templates/AGENTS.template.md",
+    "templates/README.template.md",
+    "templates/core-rules.template.md",
+    "templates/manifest.template.json",
+    "templates/project-index.template.json",
+    "templates/project-context.template.json",
+    "templates/control-plane-index.template.json",
+    "templates/current-task.template.md",
+    "templates/task-index.template.json",
+    "templates/task-graph.template.json",
+    "templates/skills-registry.template.json",
+    "templates/skills-assignments.template.json",
+    "templates/skill-runtime-route.template.json",
+    "templates/skill-run-record.template.json"
+  ]
+}

package/init/xinyun-ai-init/skills/registry.json

@@ -0,0 +1,112 @@
+{
+  "schemaVersion": 3,
+  "executionModel": "bundled-skill-runtime",
+  "registryVersion": "3.0.0",
+  "selectionOrder": "stable-order-then-skill-id",
+  "skills": [
+    {
+      "skillId": "project-intake",
+      "name": "项目接管",
+      "order": 10,
+      "supportedTaskTypes": ["workspace-initialization", "project-takeover"],
+      "stacks": ["any"],
+      "triggers": {"taskTypes": ["workspace-initialization", "project-takeover"]},
+      "permissions": ["control-plane-read", "control-plane-write"],
+      "tools": ["filesystem-read", "filesystem-write"],
+      "input": ["projectRoot", "controlPlane"],
+      "output": ["projectIdentity", "projectContext", "takeoverEvidence"],
+      "evidence": ["sourceHashes", "controlPlaneChecks", "sensitiveScan"]
+    },
+    {
+      "skillId": "task-analysis",
+      "name": "需求分析",
+      "order": 20,
+      "supportedTaskTypes": ["requirement", "feature", "bugfix", "refactor", "product-major-version-development"],
+      "stacks": ["any"],
+      "triggers": {"taskTypes": ["requirement", "feature", "bugfix", "refactor", "product-major-version-development"]},
+      "permissions": ["control-plane-read"],
+      "tools": ["filesystem-read"],
+      "input": ["userRequest", "projectFacts"],
+      "output": ["requirements", "acceptanceCriteria", "openQuestions"],
+      "evidence": ["requirementsDocument", "scopeBoundary"]
+    },
+    {
+      "skillId": "technical-design",
+      "name": "技术设计",
+      "order": 30,
+      "supportedTaskTypes": ["feature", "bugfix", "refactor", "architecture", "product-major-version-development"],
+      "stacks": ["any"],
+      "triggers": {"taskTypes": ["feature", "bugfix", "refactor", "architecture", "product-major-version-development"]},
+      "permissions": ["control-plane-read"],
+      "tools": ["filesystem-read", "code-search"],
+      "input": ["requirements", "technicalLandscape"],
+      "output": ["changePlan", "impactScope", "riskRegister"],
+      "evidence": ["plannedFiles", "verificationPlan"]
+    },
+    {
+      "skillId": "implementation",
+      "name": "实现",
+      "order": 40,
+      "supportedTaskTypes": ["feature", "bugfix", "refactor", "implementation", "product-major-version-development"],
+      "stacks": ["any"],
+      "triggers": {"taskTypes": ["feature", "bugfix", "refactor", "implementation", "product-major-version-development"], "requiresPermission": "business-code-write"},
+      "permissions": ["business-code-write", "control-plane-write"],
+      "tools": ["filesystem-read", "filesystem-write", "shell-read"],
+      "input": ["confirmedPlan", "baselineHashes"],
+      "output": ["changedFiles", "implementationResult"],
+      "evidence": ["beforeAfterHashes", "changeLedger"]
+    },
+    {
+      "skillId": "verification",
+      "name": "验证",
+      "order": 50,
+      "supportedTaskTypes": ["verification", "feature", "bugfix", "refactor", "product-major-version-development"],
+      "stacks": ["any"],
+      "triggers": {"taskTypes": ["verification", "feature", "bugfix", "refactor", "product-major-version-development"]},
+      "permissions": ["control-plane-read", "shell-read"],
+      "tools": ["filesystem-read", "shell-read"],
+      "input": ["changedFiles", "verificationPlan"],
+      "output": ["testResults", "unverifiedScope"],
+      "evidence": ["commandResults", "sensitiveScan"]
+    },
+    {
+      "skillId": "security-review",
+      "name": "安全审查",
+      "order": 60,
+      "supportedTaskTypes": ["security", "release", "product-major-version-development"],
+      "stacks": ["any"],
+      "triggers": {"riskTerms": ["security", "token", "credential", "permission", "publish"]},
+      "permissions": ["control-plane-read", "shell-read"],
+      "tools": ["filesystem-read", "shell-read"],
+      "input": ["changedFiles", "releaseArtifacts"],
+      "output": ["securityFindings", "sensitiveScan"],
+      "evidence": ["negativeChecks", "redactionScan"]
+    },
+    {
+      "skillId": "release-review",
+      "name": "发布审查",
+      "order": 70,
+      "supportedTaskTypes": ["release", "publish"],
+      "stacks": ["npm"],
+      "triggers": {"taskTypes": ["release", "publish"]},
+      "permissions": ["release-review", "control-plane-read"],
+      "tools": ["filesystem-read", "shell-read"],
+      "input": ["packageVersion", "releaseEvidence"],
+      "output": ["releaseDecision", "releaseChecklist"],
+      "evidence": ["packageBoundary", "authorizationRecord"]
+    },
+    {
+      "skillId": "handoff-sync",
+      "name": "交接同步",
+      "order": 80,
+      "supportedTaskTypes": ["handoff", "sync", "project-takeover"],
+      "stacks": ["any"],
+      "triggers": {"taskTypes": ["handoff", "sync", "project-takeover"], "requiresConversationSync": true},
+      "permissions": ["control-plane-read", "control-plane-write"],
+      "tools": ["filesystem-read", "filesystem-write"],
+      "input": ["conversationRegistry", "streamHeads", "cursor"],
+      "output": ["syncResult", "handoffRecord"],
+      "evidence": ["headCursorComparison", "eventHashes"]
+    }
+  ]
+}

package/init/xinyun-ai-init/templates/AGENTS.template.md

@@ -1,30 +1,7 @@
-# AGENTS.md
+# AI 项目入口
 
-本项目使用 `xinyun-ai/` 管理 AI 协作规则和运行状态。
+当前项目使用 `xinyun-ai/` 管理事实、任务、对话同步和 Skill 运行记录。
 
-AI 接手时先读取：
+接手顺序：读取 `xinyun-ai/README.md`、`manifest.json`、`current-task.md`、`rules/core-rules.md`、`index/control-plane-index.json`、`project-context.json`、`conversations/registry.json`，再调用 `xinyun-ai-init/runtime/route-skill.js`。
 
-- `xinyun-ai/README.md`
-- `xinyun-ai/manifest.json`
-- `xinyun-ai/current-task.md`
-- `xinyun-ai/rules/core-rules.md`
-- `xinyun-ai/index/project-index.json`
-- `xinyun-ai/index/control-plane-index.json`
-- `xinyun-ai/index/bootstrap-snapshot.json`
-- `xinyun-ai/index/re-takeover-record.json`
-- `xinyun-ai/tasks/task-index.json`
-- `xinyun-ai/tasks/task-graph.json`
-- `xinyun-ai/project-context.json`
-- `xinyun-ai/conversations/registry.json`
-
-每次创建新对话时，先执行“重新接管同一个项目”流程：确认项目根目录、读取上述控制面文件、核对项目身份和快照哈希、读取最近交接，并输出已确认、推断、未发现和待验证范围。新对话不继承历史聊天事实，也不得把当前对话的 thread ID 当作 `providerSessionId`。
-
-理解项目和执行任务是两个门禁：`contextStatus=context-ready` 只表示可以继续分析；只有增量同步、任务租约、任务控制面、权限和宿主证据全部通过，才允许写入。快照未变化时使用增量接管，快照过期或控制面冲突时先进入 `partial` 或 `blocked`。
-
-当前执行模型为 `shared-project-multi-conversation-runtime`：每个项目一个共享上下文，允许一个或多个对话接入。每次收到用户消息先检查各对话流 head；只有发现新增事件才增量读取并刷新相关事实。没有变化时静默继续。
-
-每个对话只能写自己的事件流。修改前必须重新同步、取得任务租约并核对基线哈希；冲突时阻断，不静默覆盖。thread ID 只作为 `host-thread` 引用，不能当作 `providerSessionId`。
-
-正式任务必须先写入项目本地 `xinyun-ai/`。任何代码、配置、数据库、依赖、构建、测试、API、UI 或业务流程修改前，先输出改动计划并等待用户确认。数据库、Git 写入和发布授权分别确认。
-
-旧角色、角色任务和角色会话材料只作为 `legacy/read-only` 历史；不得删除，也不得继续参与新任务路由和 ready 判断。
+Skill 按任务事实调用，不创建固定角色或角色会话。修改代码、配置、数据库、依赖、API、UI 或业务流程前，必须先输出计划并等待用户确认。npm 发布必须单独授权。

package/init/xinyun-ai-init/templates/README.template.md

@@ -1,35 +1,7 @@
 # xinyun-ai 工作区
 
-本目录是当前目标项目的 AI 控制面。当前执行模型为 `shared-project-multi-conversation-runtime`。
+当前模型为 `bundled-skill-runtime`。项目只维护一个共享上下文，Skills 由 `xinyun-ai-init/skills/registry.json` 和路由器决定。
 
-## 工作方式
+新对话先读取控制面，再比较事件流 head 和游标。无变化时静默继续，有变化时只读取增量事件。动态事实写入目标项目自己的 `xinyun-ai/`。
 
-1. 一个项目维护一个共享上下文，允许一个或多个对话接入。
-2. 普通咨询可直接回答；正式工作先登记任务。
-3. 每次交互先做轻量增量同步，再按任务事实执行 Skills。
-4. 涉及修改时先出计划并等待确认。
-5. 任务结束后写回实际改动、影响、证据、测试和下一动作。
-
-## 入口
-
-- 规则：`xinyun-ai/rules/core-rules.md`
-- 新对话接管顺序：`xinyun-ai/index/control-plane-index.json`
-- 项目快照：`xinyun-ai/index/bootstrap-snapshot.json`
-- 重新接管记录：`xinyun-ai/index/re-takeover-record.json`
-- 当前任务：`xinyun-ai/current-task.md`
-- 项目索引：`xinyun-ai/index/project-index.json`
-- 任务索引：`xinyun-ai/tasks/task-index.json`
-- 任务图：`xinyun-ai/tasks/task-graph.json`
-- 项目上下文：`xinyun-ai/project-context.json`
-- 对话注册表：`xinyun-ai/conversations/registry.json`
-- 增量事件流：`xinyun-ai/coordination/streams/`
-- 同步游标：`xinyun-ai/coordination/cursors/`
-- Skill 注册：`xinyun-ai/skills/registry.json`
-
-## 新对话重新接管
-
-每次新对话进入项目时，先确认项目根目录，读取控制面顺序中的文件，核对项目身份、当前任务、项目快照和最近接管记录，再注册或复用自己的对话绑定。`contextStatus=context-ready` 只表示可以继续分析；写入还必须通过增量同步、任务租约、宿主交互、权限和用户确认门禁。
-
-新对话的 thread ID 只能作为 `host-thread` 候选，不能当作 `providerSessionId`。接管结果写回目标项目自己的 `xinyun-ai/`，不依赖上一段聊天上下文。
-
-旧版本角色材料位于原目录或迁移清单中，只读保留，不参与当前运行。
+路由命令：`node xinyun-ai-init/runtime/route-skill.js --facts <task-facts.json>`。