create-yss-spec 2.1.15 → 2.2.1

package/template/wiki/raw/yss-skill-registry.yaml

@@ -1,510 +0,0 @@
-schema_version: 1
-registry_id: yss.skill-routing
-status: shadow
-description: >-
-  技能分层、别名、默认可发现性和 Agent 运行时入口的 shadow 路由注册表。
-  本文件不替代 skills-lock.json 的来源、hash 与投影完整性职责；Router 与生命周期编排器在 status=shadow 时不得消费本表做运行时裁剪。
-canonical_content_root: .agents/skills
-runtime_policy:
-  consumed_by_router: false
-  consumed_by_lifecycle: false
-  discovery_enforced: false
-agent_runtime_roots:
-  claude: .claude/skills
-  codex: .codex/skills
-  cursor: .cursor/skills
-  hermes: .hermes/skills
-  pi: .pi/skills
-  qoder: .qoder/skills
-  trae: .trae/skills
-skills:
-  - id: alibaba-java-code-style
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
-  - id: ask-matt
-    layer: compatibility
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [lifecycle]
-  - id: code-review
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [quality]
-  - id: codebase-design
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [quality]
-  - id: competitive-intelligence
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [discovery]
-  - id: cross-repo-implementation-routing
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [lifecycle]
-  - id: diagnosing-bugs
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [quality]
-  - id: dispatching-parallel-agents
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [lifecycle]
-  - id: domain-modeling
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [discovery]
-  - id: grill-me
-    layer: compatibility
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [discovery]
-  - id: grill-with-docs
-    layer: compatibility
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [discovery]
-  - id: grilling
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [discovery]
-  - id: handoff
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [lifecycle]
-  - id: high-fidelity-html-prototype
-    layer: compatibility
-    maturity: deprecated
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [prototype]
-    replaced_by: yss-prototype-stage
-  - id: implement
-    layer: compatibility
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [lifecycle]
-  - id: implementation-repo-onboarding
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [lifecycle]
-  - id: improve-codebase-architecture
-    layer: compatibility
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [quality]
-  - id: llm-wiki
-    layer: core
-    maturity: verified
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [quality]
-  - id: lombok
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
-  - id: loop-me
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [setup]
-  - id: maintaining-skills
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [template-maintenance]
-  - id: mapstruct
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
-  - id: migrate-to-shoehorn
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [setup]
-  - id: prototype
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [prototype]
-  - id: prototype-review
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [prototype]
-  - id: research
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [discovery]
-  - id: resolving-merge-conflicts
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [quality]
-  - id: scaffold-exercises
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [setup]
-  - id: setup-matt-pocock-skills
-    layer: compatibility
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [setup]
-  - id: setup-pre-commit
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [setup]
-  - id: setup-ts-deep-modules
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [setup]
-  - id: tdd
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [quality]
-  - id: teach
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [writing]
-  - id: to-questionnaire
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [discovery]
-  - id: to-spec
-    layer: compatibility
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [lifecycle]
-  - id: to-tickets
-    layer: compatibility
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [lifecycle]
-  - id: triage
-    layer: compatibility
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [lifecycle]
-  - id: using-git-worktrees
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [setup]
-  - id: wait-what
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [setup]
-  - id: wayfinder
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [lifecycle]
-  - id: writing-beats
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [writing]
-  - id: writing-for-agents
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [writing]
-  - id: writing-fragments
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [writing]
-  - id: writing-shape
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [writing]
-  - id: yss-antd-design
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [prototype]
-  - id: yss-api-integration
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: [api-integration]
-    impacts: [frontend, api]
-  - id: yss-audit-log
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
-  - id: yss-application
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
-  - id: yss-cache
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
-  - id: yss-components
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [frontend]
-  - id: yss-ddd-scaffold-generator
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
-  - id: yss-design-system
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [prototype, frontend]
-  - id: yss-distributed-id
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
-  - id: yss-domain
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
-  - id: yss-dto
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend, api]
-  - id: yss-excel-mvc
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
-  - id: yss-exception
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
-  - id: yss-formily
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [frontend]
-  - id: yss-formily-schema-generator
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [frontend]
-  - id: yss-frontend-scaffold-generator
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [frontend]
-  - id: yss-hook
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [frontend]
-  - id: yss-microapp-commit
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: [microapp-commit]
-    impacts: [frontend]
-  - id: yss-mybatis
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
-  - id: yss-openapi-draft-review
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [api]
-  - id: yss-openapi-governance
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [api]
-  - id: yss-page-module-development
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [frontend]
-  - id: yss-product-lifecycle
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [lifecycle]
-  - id: yss-prototype-stage
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [prototype]
-  - id: yss-repository
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
-  - id: yss-resilience4j
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
-  - id: yss-router
-    layer: core
-    maturity: supported
-    instance_default_discoverable: true
-    aliases: []
-    impacts: [lifecycle, backend, frontend]
-  - id: yss-security-algorithm
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
-  - id: yss-source-index
-    layer: maintainer-only
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [template-maintenance]
-  - id: yss-ui
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [frontend]
-  - id: yss-up-springboot3
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
-  - id: yss-use-table-height
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [frontend]
-  - id: yss-use-tree-height
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [frontend]
-  - id: yss-userinfo
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
-  - id: yss-validation
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend]
-  - id: yss-web-controller
-    layer: specialist
-    maturity: supported
-    instance_default_discoverable: false
-    aliases: []
-    impacts: [backend, api]
-platform_skills:
-  - id: data-analytics
-    root: .codex/skills
-    layer: maintainer-only
-    instance_default_discoverable: false
-  - id: product-design
-    root: .codex/skills
-    layer: specialist
-    instance_default_discoverable: false

package/template/wiki/wiki/Agent/345/205/245/345/217/243/350/247/204/345/210/231.md

@@ -1,21 +0,0 @@
-# Agent入口规则
-
-`AGENTS.md` 只保存 Agent 必须首先遵守的仓库身份路由、硬门禁和禁止事项。每个任务开始时先读根目录 `yss-project.yaml`：`template-source` 走模板维护，`project-instance` 按产品研发生命周期分诊；文件缺失或模式非法时停止路由并做迁移检查，不根据目录、Git 远程或占位符猜测身份。细则见 [[仓库身份与路由]]。
-
-单一事实来源不得在说明文档里重复定义：领域与流程词汇以 `CONTEXT.md` 为准；Agent 入口以 `AGENTS.md` 为准；主阶段、门禁、产物、工作单元、证据和稳定 ID 以 `docs/process/lifecycle-registry.yaml` 为准（`docs/process/lifecycle-artifact-map.md` 只是派生阅读视图）；影响面触发与 `not-applicable` 以 `docs/process/harness-process-tailoring.md` 为准（见 [[影响面分诊与流程裁剪]]）；技能清单、来源、版本、哈希和投影目标以 `skills-lock.json` 为准。`docs/agents/yss-skill-registry.yaml` 当前 `status: shadow`，不作为 Router / 生命周期运行时入口。
-
-落地文档正文统一使用简体中文；英文专有名词、路径、schema、命令与协议 metadata 保持原样。业务术语必须已有 PascalCase `英文标识`；代码类型 / 字段与契约 property 使用该词干按 `CONTEXT.md` 文首规则变形；改中文术语或英文标识都先回写 `CONTEXT.md`。新流程统一使用 Spec、Ticket、`to-spec`、`to-tickets`。功能父 Ticket 汇总阶段证据；Spec 初稿、产品设计、原型、OpenAPI Draft 和待冻结资产使用 `ready-for-human`；只有通过必要门禁、阻塞边已清除并具备直接实现条件的垂直切片 Ticket 才能使用 `ready-for-agent`（见 [[Ticket与流程状态]]）。
-
-进入实现前先读 `docs/process/implementation-repo-integration.md` 并登记实现仓库，再由 `yss-router` 编译最小 skill 集合与当前实现合同（见 [[YSS路由与合同编译]]）。当前仓库默认是研发管理仓库，运行时代码优先在独立实现仓库；只有用户明确选择时才用 `apps/backend/<project>/` 或 `apps/frontend/<project>/`。`app/backend/`、`app/frontend/` 禁止作为工程输出（见 [[实现仓库与跨仓库契约]]）。前端测试、type-check 与构建优先 `pnpm`；后端校验、测试与编译优先项目根 `./mvnw`；不要默认 `npm` / `yarn` 或裸 `mvn`。根目录 `CLAUDE.md` 只引用 `AGENTS.md`，不是第二套入口规则。
-
-专项任务必须走指定入口：技术事实、标准、第三方 API 或框架行为影响决策时用 `research` 或等价一手资料记录；竞品与市场口碑用 `competitive-intelligence`；UI 设计、原型、组件或主题先 `yss-design-system` 再 `yss-prototype-stage`；Bug 先 `diagnosing-bugs` 再 `tdd`；冲突用 `resolving-merge-conflicts`；架构治理用 `improve-codebase-architecture` / `codebase-design`；跨线程、跨仓库或上下文过长用 `handoff`。本地知识库 init / refresh / rebuild，或要把研究结果落成持久 wiki，必须使用 `llm-wiki`（落成持久 wiki 用 `ingest`；已映射 live 源变了用 `refresh`；见 [[LLM Wiki]]）。一次性一手资料笔记走 `research`，持久 wiki 走 `llm-wiki` 的 `ingest`，不把 ingest 理解成替代权威源。
-
-实现者不能承担命中的独立审查；任何「完成 / 可合并 / 可发布」结论必须基于 fresh verification，不接受「之前跑过」或实现者自述（见 [[Fresh验证与独立审查]]）。业务行为默认按 `tdd` 使用已确认的公开 seam 逐切片实现；YSS 专项规范见 [[YSS工程技能体系]]，通用工程流程见 [[Matt技能体系]]。
-
-## 来源
-
-- `AGENTS.md`
-- `CONTEXT.md`
-- `yss-project.yaml`
-- `docs/adr/0002-yss-project-repository-mode.md`
-- `README.md`

package/template/wiki/wiki/CLAUDE.md

@@ -1,28 +0,0 @@
-# CLAUDE.md — Wiki schema
-
-本文档是本 wiki 的 schema（结构契约）。正文语言遵循宿主项目的文档语言规则；英文专有名词、类名、枚举值、表名与 API 路径保持原样。
-
-本 wiki 收录本仓库模板源流程知识。权威事实以 live 文件为准。
-
-## 三层结构
-
-- **`raw/`** — 不可变原始源。从 live 文档拷贝，或从 live 源提取且标明出处的派生摘要。只读，不靠改 raw 来「修正」事实。
-- **文章（`wiki/*.md`）** — LLM 生成的知识文章。文件名（不含 `.md`）即文章 ID，必须全局唯一。使用 `[[wikilink]]` 互引。
-- **`index.md`** — 内容目录。`##` 节标题定义分类；节下列出该分类下的 `[[wikilink]]`。
-
-## 文章写作约定
-
-- 首行为 `# H1`，H1 文本等于文章 ID，随后紧跟首段摘要。
-- 正文使用 `[[目标文章名]]`；目标必须是本 wiki 内存在的文章文件名（不含 `.md`）。
-- 论断必须能追溯到 `raw/` 或 live 代码路径。文末使用 `## 来源`。
-- 分类归属由 `index.md` 决定。
-- 可选 frontmatter：`human-owned: true` 时 refresh / rebuild 不得重写正文。
-- 仅当多个来源冲突，或 live 与旧 raw 不一致时写可选 `## Status`（`Disputed` / `Outdated`）。单一 live 正确则不写。`human-owned` 页不写 Status。
-
-## 基础设施文件
-
-`index.md`、`log.md`、`CLAUDE.md`、`AGENTS.md`、`soul.md`、`concept-table.md` 为基础设施文件，不视为文章。
-
-## 操作日志
-
-`log.md` 只追加。格式：`## [YYYY-MM-DD] OPERATION | 描述`（CREATE / UPDATE / LINK / FIX / REFRESH / REBUILD / RETIRE / LINT / INGEST）。

package/template/wiki/wiki/Fresh/351/252/214/350/257/201/344/270/216/347/213/254/347/253/213/345/256/241/346/237/245.md

@@ -1,19 +0,0 @@
-# Fresh验证与独立审查
-
-Fresh Verification 指完成前重新执行的验证证据，包括测试命令、契约校验、关键路径检查或人工审查结论。任何「完成 / 可合并 / 可发布」结论必须基于本轮 fresh verification，不接受「之前跑过」或实现者自述。注册表已废弃 `work-unit.fresh-verification` 与 `work-unit.independent-review`；当前对应证据是 `evidence.fresh-verification`。
-
-实现者不能承担命中的独立审查。模板维护按 L1 / L2 / L3 分别使用 `self-check` / 人工 checkpoint、`focused-independent`、`formal-independent`（见 [[模板维护流程]] 与 [[影响面分诊与流程裁剪]]）。强度由 `docs/process/maintenance-intensity.yaml` 计算，未给出 trigger 时使用该策略的 `default_level`（当前为 L2）。L1 至少一项与变更直接相关的实际检查；L2 需要修改前可失败的最小反例以及本轮 fresh verification；L3 需要完整 RED、GREEN、REFACTOR、压力场景与本轮 fresh verification。模板发布、代码切片和高风险变更仍必须由其他 Agent 或人工独立审查。
-
-`project-instance` 的独立代码审查工作单元是 `work-unit.code-review`：输入不可变候选快照、Spec、Ticket、合同和执行结果；输出 Standards、Spec、UI fidelity 三轴 Review 与 fresh verification；findings 已处理后须重新捕获候选并全量复审。旧文「代码审查双轴」已过期，不得再按标准符合性 / Spec 符合性两轴描述（见 [[Matt技能体系]]）。UI 影响切片的前端实现还原验证由独立 Reviewer 通过 UI fidelity 轴（见 [[产品设计影响与原型]]）。
-
-测试质量基线是模板推荐值：Domain / Application `>= 90%`、API `>= 80%`、前端组件 `>= 75%`、已明确的关键流程 `100% E2E`。只有项目实例在测试策略中明确采纳或覆盖后才构成 CI 门禁；未定义关键流程清单时，不得声称其 E2E 覆盖率达到 100%。YSS Skill Execution Result 必须由 Router、生命周期编排器和独立 Reviewer 复核，实现者自报 `implemented` 不构成最终通过（见 [[切片实现合同]] 与 [[YSS路由与合同编译]]）。
-
-`gate.release-ready` 位于 `stage.verification-release-retrospective`，触发于合并、发布或阶段完成，证据为 `evidence.fresh-verification` 与 `evidence.checkpoint-and-rollback`（见 [[条件强制门禁]]）。Git checkpoint 只包含本轮明确范围，须列出验证命令、Ticket 状态和下一步；获得用户授权后才提交或推送（见 [[Ticket与流程状态]]）。
-
-## 来源
-
-- `AGENTS.md`
-- `CONTEXT.md`
-- `docs/process/harness-process-tailoring.md`
-- `docs/process/maintenance-intensity.yaml`
-- `docs/process/lifecycle-registry.yaml`

package/template/wiki/wiki/LLM Wiki.md

@@ -1,30 +0,0 @@
-# LLM Wiki
-
-LLM Wiki 是由 `raw/`、`wiki/` 与 `.wiki-manifest.json` 组成的本地持久知识库，其中 raw 含 live 拷贝与 derived 摘录。它是中间表示（IR），live 源才是事实；一次性笔记不在本技能范围，也不替代权威源。`ingest` 只把用户点名的外源或已落盘研究笔记编进 IR，不改 live 权威文件。
-
-三层布局：`raw/` 保存不可变拷贝与标明 live 输入的 derived 摘录，不得靠改 raw「修正」事实；`wiki/` 保存 LLM 文章以及 `index.md`、`log.md`、`CLAUDE.md`、可选 `concept-table.md`；`.wiki-manifest.json` 是编译图，与 `raw/`、`wiki/` 并列，不是文章也不是 raw 源。文章 ID 等于文件名去掉 `.md`。`index.md`、`log.md`、`CLAUDE.md`、`AGENTS.md`、`soul.md`、`concept-table.md` 是基础设施文件，不视为文章。本模板 wiki 的入口分类见 [[模板总览]]。
-
-模式为 `init`、`refresh`、`rebuild`、`lint`、`ingest`。已有 `wiki/index.md` 禁止 `init` 覆盖，应询问 refresh 还是 rebuild。`refresh` 只改漂移命中的文章，且 `human-owned` 不改；无映射新文件必须先四态 triage（`New` / `Update` / `Disputed` / `No material`），`No material` 只追加 log。`rebuild` 让 raw 对齐 live，保留稳定 ID 与 human-owned，全量重写 LLM 页。`ingest` 只接受用户点名的外源或已落盘 research 笔记，确认前零文章字节变化；已映射 live 源变了走 `refresh`，禁止 query 顺手 ingest。查询不是模式：有 wiki 就从 wiki 回答，先展示 `inventory.mjs status` 源状态表，再匹配 index；过窄时用 H1/首段兜底，最多打开 8 页并回读 live。
-
-`lint` 完成条件是结构脚本 exit 0，且已跑 `advise.mjs` 并报告条数。advise 报告单向链、无专页专名、未引用 raw 与字面证据 suspects，不改结构失败合同，也不自动建页或改数字。`inventory.mjs status` 是 `drift` 的稳定别名，exit 0 表示报告有效，不得把非空 `changed` 当成脚本失败。
-
-多源冲突或 live 与旧 raw 不一致时，文章可写可选 `## Status`（`Disputed` / `Outdated`），保留双方引用；单一 live 正确则不写。`human-owned` 页只修 wikilink，不写 Status。缺 Status 不是 lint 失败。可选 `concept-table.md` 用三列（概念、关系、文章 ID）作基础设施，rebuild 可重写，不改成 `wiki/entities/`。
-
-本 wiki 的 manifest 使用 `schemaVersion` `1`、`profile` `documents`。编译图还允许 `mixed`（文档 + 代码）与 `code`；source `kind` 为 `document`、`derived` 或 `code-surface`。Agent 填写 `id`、`kind`、`livePath`、`rawPath`、`role`、`articles`；脚本填充 `sha256`、`compiledAt`、`gitCommit`。文章以 `# H1`、摘要段、正文和 `## 来源` 写成，站内只用双方括号包裹的文章 ID 互引。
-
-`llm-wiki` 已写入锁文件 `shared` 分组（`source: project`），并在 `yss-skill-registry.yaml` 中登记为 `layer: core`、`maturity: verified`、`instance_default_discoverable: true`、`impacts: [quality]`。该注册表仍是 `status: shadow`，不得据此裁剪 Router / 生命周期发现面。`llm-wiki` 不在 `yss-public-skills.json`；公开发布面只放 `yss-*` 工程技能（见 [[技能投影与锁定]] 与 [[YSS工程技能体系]]）。强制入口见 [[Agent入口规则]]。权威源修订后应 refresh / rebuild，复盘见 [[复盘与权威资产修订]]；技能变更强度走 [[模板维护流程]]。
-
-## 来源
-
-- `.agents/skills/llm-wiki/SKILL.md`
-- `.agents/skills/llm-wiki/references/schema.md`
-- `.agents/skills/llm-wiki/references/compile.md`
-- `.agents/skills/llm-wiki/references/query.md`
-- `.agents/skills/llm-wiki/references/lint.md`
-- `.agents/skills/llm-wiki/references/ingest.md`
-- `AGENTS.md`
-- `CONTEXT.md`
-- `skills-lock.json`
-- `docs/agents/yss-skill-registry.yaml`
-- `wiki/.wiki-manifest.json`
-- `yss-public-skills.json`

package/template/wiki/wiki/Matt/346/212/200/350/203/275/344/275/223/347/263/273.md

@@ -1,21 +0,0 @@
-# Matt技能体系
-
-Matt Engineering Skills 是来自 `mattpocock/skills` 的轻量工程流程技能集合，用于澄清、Spec、Ticket、实现、TDD、诊断、审查和架构治理，不替代 [[YSS工程技能体系]]。
-
-当前锁定 revision 以 `skills-lock.json` 的 `sources` 为准：`mattpocock/skills` 的 `revision` 为 `0ab1b63a410a03d3627979a109c8695de27af954`。不要抄 README 里可能过期的 hash。上游技能基线不等于项目当前生效内容；YSS 适配必须同时保留上游内容哈希、有效内容哈希和适配依据（见 [[技能投影与锁定]]）。
-
-`grill-with-docs` 与 `to-spec` 只是用户显式兼容入口；新功能或较大变更的默认路径是 `yss-product-lifecycle` 的原生 Discovery / 需求分析工作单元，[[Spec基线]] 与产品设计影响的完整判定以生命周期注册表和裁剪规则为准（见 [[产品研发生命周期]]）。用户显式 `to-tickets` 同样只是兼容入口；正式化由生命周期原生 Ticket 工作单元完成，禁止只按 Adapter / Application / Domain / Infrastructure 横向拆分（见 [[垂直切片Ticket]]）。
-
-[[Agent入口规则]] 规定的强制入口包括：技术事实、标准、第三方 API 或框架行为走 `research`；竞品、市场或用户口碑走 `competitive-intelligence`；Bug、测试失败或性能回退先用 `diagnosing-bugs` 再建 `tdd`；merge / rebase 冲突走 `resolving-merge-conflicts`；架构治理、难测模块或深模块设计走 `improve-codebase-architecture` / `codebase-design`；跨线程、跨仓库、上下文过长或原型结论回流走 `handoff`。
-
-业务行为默认按 `tdd` 使用已确认的公开 seam 逐切片实现。一次性生成、纯配置或流程文档不适用代码 TDD 时，必须记录例外理由和可执行验证方式。一次性一手资料走 `research`；要把研究结果落成持久 wiki 则走 [[LLM Wiki]]。`ask-matt` 的关联入口包括 `to-questionnaire`、`wait-what`、`writing-for-agents` 和 `PHASE-BOUNDARIES.md`，这些支持文件随共享 skill 目录一起计算 `effectiveHash`，不得单独投影或维护。
-
-过时技能不会保留兼容别名。已退休、personal 或由 YSS 有意排除的条目不再进入 `.agents/skills`、共享投影根或 `skills-lock.json`；其中 `wizard` 是最新上游仍存在但 YSS 当前有意排除的人工步骤技能，不应描述为上游已退休。
-
-## 来源
-
-- `CONTEXT.md`
-- `AGENTS.md`
-- `skills-lock.json`
-- `docs/agents/skills-maintenance.md`
-- `wiki/raw/skills-lock-names.md`

package/template/wiki/wiki/OpenAPI/345/245/221/347/272/246.md

@@ -1,20 +0,0 @@
-# OpenAPI契约
-
-API 契约变更先形成 OpenAPI 3.1 Draft，经必要的工程基线、系统 / 数据架构和设计审查后 Freeze，再进入实现。Draft 是 review-only：Freeze 前不得作为前后端稳定实现契约，也不得用来生成客户端或固化契约测试。
-
-Draft 属于待冻结资产，状态为 `ready-for-human`，见 [[Ticket与流程状态]]。Spec 模板把 OpenAPI 影响写成「无 / 需要 API 影响分析 / 需要 review-only OpenAPI Draft」，Draft 路径为 `docs/.scratch/<feature>/api/<feature>.yaml`。该 YAML 必须是唯一权威的单一 OAS 3.1 document；JSON 只能在 Freeze 后由受锁定工具派生。有 UI 且尚未完成用户确认时，不得进入 OpenAPI Draft 评审。
-
-`work-unit.technical-analysis` 消费冻结 [[Spec基线]]、适用的原型和 API / 数据 / 工程影响面，产出 OpenAPI、数据架构、工程基线、架构审查和 Slice 合同草案。命中契约必须冻结；无 API 影响要有可读记录。相关门禁按影响面强制，未命中记 `not-applicable`：`gate.openapi-draft-reviewed`、`gate.design-reviewed`、`gate.engineering-baseline-accepted`、`gate.architecture-reviewed`、`gate.openapi-frozen`，见 [[条件强制门禁]]。
-
-OpenAPI Freeze 是已通过评审、可作为前后端实现和契约测试输入的 OpenAPI 3.1 契约。Freeze 后变更必须回到 API 影响分析和设计审查，重新进入 Draft 循环，不能在实现中直接改契约冒充稳定来源。Router 也要求 API 变化回到生命周期 Draft / Review / Freeze，半成品 backend 不得充当 source of truth。
-
-OpenAPI Freeze 或无 API 影响记录完成后，由生命周期原生 Ticket 正式化工作单元拆成窄垂直切片；用户显式 `to-tickets` 只是兼容入口。切片实现必须消费冻结契约或明确的无 API 影响记录，见 [[垂直切片Ticket]] 与 [[切片实现合同]]。需要页面动作反推端点时，先完成 [[产品设计影响与原型]]，再进入本契约循环。整条链路挂在 [[产品研发生命周期]] 的 `stage.system-data-engineering`；YSS 响应包装与 DTO wire shape 的专项规则由 [[YSS工程技能体系]] 在 Freeze 后执行，不把 Draft 当生成输入。
-
-## 来源
-
-- `CONTEXT.md`
-- `AGENTS.md`
-- `docs/templates/spec-template.md`
-- `docs/process/lifecycle-registry.yaml`
-- `docs/api/templates/openapi-draft-review-checklist.md`
-- `.agents/skills/yss-router/SKILL.md`

package/template/wiki/wiki/SpecDelta.md

@@ -1,19 +0,0 @@
-# SpecDelta
-
-Spec Delta 只记录相对既有冻结 [[Spec基线]] 的 `ADDED / MODIFIED / REMOVED` 高风险行为差异，以及对应的验收场景和测试映射。它不是第二份完整 Spec，也不替代 OpenAPI 或架构资产。
-
-触发面很窄。全新产品、全新模块和低风险调整不生成 Spec Delta。生命周期产物 `artifact.spec-delta` 的触发条件是「已有冻结 Spec 的高风险行为变化」，归属 `stage.spec-architecture`。未命中时按 [[条件强制门禁]] 与 [[影响面分诊与流程裁剪]] 记录 `not-applicable` 及原因，不写空 Delta。明确改变认证或授权行为时，把差异当作普通行为写入本 Delta，不另开专项 Delta。
-
-模板 `docs/templates/spec-delta-template.md` 用三列差异表达行为，不引入 OpenSpec CLI 或额外状态机。`ADDED` 是新增用户可见行为、API 行为、状态、权限或数据约束；`MODIFIED` 是已有行为的输入、输出、状态流、权限、错误结构、兼容性或验收标准变化；`REMOVED` 是删除或废弃已有行为、字段、入口、权限、状态或兼容路径。变更摘要还要挂相关 OpenAPI Draft / Freeze、架构 / 设计审查和 Ticket / 切片。
-
-受影响范围按维度勾选：UI / 页面 / 交互状态，API / OpenAPI schema / 错误结构，权限 / 认证 / 授权，状态机 / 业务流程，数据模型 / Repository / 查询索引，外部系统 / 跨端协作，发布 / 回滚 / 运维，风险 / 人审点。UI 勾选不等于自动构成 [[产品设计影响与原型]]；只有主流程、导航、权限体验、异常 / 恢复、状态流转或 API 反推才需要页面流和原型校准。API 勾选后必须走 [[OpenAPI契约]] 的 Draft → 审查 → Freeze，Freeze 后变更仍要回到 API 影响分析和设计审查。
-
-验收场景（`SD-001` 起）映射到测试与 fresh verification：单元 / 契约 / E2E / 手工验证，并记录命令、证据路径和 `planned / passed / blocked`。这直接支撑后续 [[垂直切片Ticket]] 的验收与测试 seam，也进入 [[Fresh验证与独立审查]]。结论栏只回答是否允许进入 OpenAPI Freeze / no API impact、是否允许进入 `to-tickets`、必须带入垂直切片的约束，以及 Git checkpoint 状态；`to-tickets` 仍只是兼容入口。
-
-## 来源
-
-- `CONTEXT.md`
-- `AGENTS.md`
-- `docs/templates/spec-delta-template.md`
-- `docs/process/lifecycle-registry.yaml`
-- `docs/templates/spec-template.md`