create-yss-spec 2.1.11 → 2.1.14

package/template/wiki/raw/vertical-slice-ticket-template.md

@@ -1,8 +1,14 @@
+---
+status: ready-for-human
+---
+
 # 垂直切片 Ticket：<标题>
 
+Status: ready-for-human
+
 ## 父级
 
-<Spec / 功能父 Ticket 链接>
+<Spec：`docs/.scratch/<feature>/spec.md`；功能父 Ticket：`docs/.scratch/<feature>/parent-ticket.md` 或远程 Issue URL>
 
 ## 要构建什么
 
@@ -15,7 +21,7 @@
 ## OpenAPI 影响
 
 - [ ] 无
-- [ ] 基于冻结 OpenAPI：`docs/api/specs/<feature>.yaml`
+- [ ] 基于冻结 OpenAPI：`docs/.scratch/<feature>/api/<feature>.yaml`
 
 受影响端点：
 
@@ -57,7 +63,7 @@
 |---|---|---|---|---|---|---|---|---|---|
 |  |  |  |  | behavior-tdd / controlled-generation |  |  |  |  | pending / running / blocked / completed / stale |
 
-`controlled-generation` 仅允许机械脚手架、样板、冻结客户端或配置，并记录 exception reason、生成器输入和生成后行为测试；业务规则、状态机、事务、权限、错误映射、复杂查询和用户可见交互必须使用 `behavior-tdd`。
+`controlled-generation` 仅允许机械脚手架、样板、冻结客户端或配置，并记录 exception reason、生成器输入和生成后行为测试；业务规则、状态机、事务、权限、错误映射、复杂查询和用户可见交互必须使用 `behavior-tdd`。只有需求明确包含权限业务行为时才把它写入工作单元，不另设安全 / 权限姿态。
 
 ## YSS 技能与后端实现合同
 
@@ -65,10 +71,10 @@
 
 | 影响面 | 必需 skill | 需要 / 不需要的理由 | 预期证据 |
 |---|---|---|---|
-| Domain / 领域行为 | `yss-domain` / `yss-backend-scaffold-domain` |  |  |
-| Application / 用例编排 | `yss-backend-scaffold-application` |  |  |
-| Infrastructure / Repository | `yss-repository` / `yss-mybatis` / `yss-backend-scaffold-infrastructure` |  |  |
-| Web Adapter / DTO | `yss-web-controller` / `yss-dto` / `yss-backend-scaffold-web` |  |  |
+| Domain / 领域行为 | `yss-domain` |  |  |
+| Application / 用例编排 | `yss-application` |  |  |
+| Infrastructure / Repository | `yss-repository` / `yss-mybatis` |  |  |
+| Web Adapter / DTO | `yss-web-controller` / `yss-dto` |  |  |
 | POJO / 对象转换 | `lombok` / `mapstruct` |  |  |
 | Java 规范 | `alibaba-java-code-style` |  |  |
 
@@ -92,7 +98,7 @@
 | 字段 | 内容 |
 |---|---|
 | reroute_status | current / incremental-review / full-reroute-required / lifecycle-return / stale |
-| trigger | 新 API/schema / 权限 / 状态机 / 数据模型 / 写路径 / 仓库 / skill / seam / 风险 / 交付顺序 / other |
+| trigger | 新 API/schema / 状态机 / 数据模型 / 写路径 / 仓库 / skill / seam / 风险 / 交付顺序 / other |
 | affected_work_units |  |
 | new_impacts |  |
 | stale_contract_version |  |
@@ -123,4 +129,4 @@
 - [ ] 已回勾当前 `contract_id` / `contract_version`、全部工作单元和对应 `YSS Skill Execution Result`
 - [ ] 实际 changed files 均在合同允许路径内，预期证据齐全，验证结果包含执行时间
 - [ ] `new_impacts`、`drift`、`violation` 和重路由状态均有明确结论，合同未处于 `stale`
-- [ ] 如领域或架构决策变化，已更新 `CONTEXT.md` / ADR
+- [ ] 如领域或架构决策变化，已更新 `CONTEXT.md` / ADR；新增业务术语含 PascalCase `英文标识`，代码与契约字段能追溯到该词干

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

@@ -0,0 +1,510 @@
+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,9 +1,21 @@
-# Agent 入口规则
+# Agent入口规则
 
-`AGENTS.md` 是 Agent 启动任务时必须首先遵守的全局路由、硬门禁和禁止事项。其核心要求是：每个任务开始时先读取根目录 `yss-project.yaml`，依据 `repository_mode` 判定仓库身份（见 [[仓库身份与路由]]），再选择模板维护流程或产品研发生命周期。
+`AGENTS.md` 只保存 Agent 必须首先遵守的仓库身份路由、硬门禁和禁止事项。每个任务开始时先读根目录 `yss-project.yaml`：`template-source` 走模板维护，`project-instance` 按产品研发生命周期分诊；文件缺失或模式非法时停止路由并做迁移检查，不根据目录、Git 远程或占位符猜测身份。细则见 [[仓库身份与路由]]。
 
-入口规则确立了单一事实来源表：领域与流程词汇以 `CONTEXT.md` 为准，Agent 入口规则以 `AGENTS.md` 自身为准，主阶段、门禁、产物与退出标准以生命周期映射为准，影响面触发与 `not-applicable` 以裁剪指南为准（见 [[影响面分诊与流程裁剪]]），技能清单以 `skills-lock.json` 为准。README 与用户指南只引用或解释上述事实，不重复定义规则。
+单一事实来源不得在说明文档里重复定义：领域与流程词汇以 `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 / 生命周期运行时入口。
 
-标准文档语言约定：所有面向业务、产品、架构、实施、审查、发布和复盘的落地文档正文统一使用简体中文；英文专有名词、代码标识、API 路径、schema、类名、方法名、枚举值、错误码、命令、文件名与协议 metadata 保持原样。
+落地文档正文统一使用简体中文；英文专有名词、路径、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与流程状态]]）。
 
-专项任务有强制入口：技术事实用 `research`、竞品事实用 `competitive-intelligence`、UI 设计用 `yss-design-system`、Bug 用 `diagnosing-bugs` 加 `tdd`、合并冲突用 `resolving-merge-conflicts`、架构治理用 `codebase-design`、跨线程跨仓库交接用 `handoff`（见 [[Matt技能体系]] 与 [[YSS工程技能体系]]）。业务行为默认按 `tdd` 使用已确认的公开 seam 逐切片实现。
+进入实现前先读 `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,24 +1,28 @@
-# CLAUDE.md — YSS Spec Project Template Wiki 规范
+# CLAUDE.md — Wiki schema
 
-本文档是本 wiki 的 schema（结构契约），描述 Karpathy 模式三层知识库的组织约定。wiki 内所有内容以简体中文撰写，英文专有名词与代码标识保持原样。
+本文档是本 wiki 的 schema（结构契约）。正文语言遵循宿主项目的文档语言规则；英文专有名词、类名、枚举值、表名与 API 路径保持原样。
+
+本 wiki 收录本仓库模板源流程知识。权威事实以 live 文件为准。
 
 ## 三层结构
 
-- **`raw/`** — 不可变原始源文档。从模板仓库复制的权威资产（AGENTS.md、CONTEXT.md、README.md、ADR、契约等）。只读，不修改。
-- **文章（`*.md`，wiki 根目录）** — LLM 生成的知识文章。每篇对应模板的一个核心主题，使用 `[[wikilink]]` 互相引用。文件名即文章 ID（不含扩展名），必须全局唯一。
-- **`index.md`** — 内容目录。`##` 节标题定义分类（topic），节下列出该分类下的文章 `[[wikilink]]`。
+- **`raw/`** — 不可变原始源。从 live 文档拷贝，或从 live 源提取且标明出处的派生摘要。只读，不靠改 raw 来「修正」事实。
+- **文章（`wiki/*.md`）** — LLM 生成的知识文章。文件名（不含 `.md`）即文章 ID，必须全局唯一。使用 `[[wikilink]]` 互引。
+- **`index.md`** — 内容目录。`##` 节标题定义分类；节下列出该分类下的 `[[wikilink]]`。
 
 ## 文章写作约定
 
-- 首行为 `# H1` 标题，随后紧跟首段摘要（解析器会提取为 summary）。
-- 正文使用 `[[目标文章名]]` 引用其他文章；目标必须是 wiki 内存在的文章文件名（不含 `.md`）。
-- 引用真实事实：所有论断必须能追溯到 `raw/` 中的权威源文档或模板仓库资产。
-- 分类归属由 `index.md` 决定，文章内不需要声明分类。
+- 首行为 `# 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` 为基础设施文件，不视为文章。
+`index.md`、`log.md`、`CLAUDE.md`、`AGENTS.md`、`soul.md`、`concept-table.md` 为基础设施文件，不视为文章。
 
 ## 操作日志
 
-`log.md` 记录 wiki 的每次操作，格式：`## [YYYY-MM-DD] OPERATION | 描述`（OPERATION 使用 CREATE / UPDATE / LINK / FIX 等动词）。
+`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,9 +1,19 @@
-# Fresh Verification 与独立审查
+# Fresh验证与独立审查
 
-Fresh Verification 指完成前重新执行的验证证据，包括测试命令、契约校验、关键路径检查或人工审查结论，不等同于"之前跑过"或实现者自述。任何"完成 / 可合并 / 可发布"结论必须基于 fresh verification。
+Fresh Verification 指完成前重新执行的验证证据，包括测试命令、契约校验、关键路径检查或人工审查结论。任何「完成 / 可合并 / 可发布」结论必须基于本轮 fresh verification，不接受「之前跑过」或实现者自述。注册表已废弃 `work-unit.fresh-verification` 与 `work-unit.independent-review`；当前对应证据是 `evidence.fresh-verification`。
 
-独立审查规则：实现者不能审查自己的代码。模板发布、代码切片和高风险变更必须由其他 Agent 或人工独立审查；低风险文档变更可使用显式人工 checkpoint。代码审查按双轴进行——标准符合性（是否遵循仓库文档化编码标准）与 Spec 符合性（是否匹配发起 issue / spec 的要求），由 `code-review` 技能执行（见 [[Matt技能体系]]）。
+实现者不能承担命中的独立审查。模板维护按 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 或人工独立审查。
 
-测试质量基线：模板推荐值 Domain / Application ≥ 90%、API ≥ 80%、前端组件 ≥ 75%、已明确的关键流程 100% E2E；这些只是推荐值，项目实例必须在测试策略中明确采纳或覆盖后才构成 CI 门禁（见 [[影响面分诊与流程裁剪]]）。实现证据链：核心 YSS skills 返回的 YSS Skill Execution Result 必须被 Router、生命周期编排器和独立 Reviewer 复核，实现者自报 `implemented` 不构成最终通过（见 [[切片实现合同]] 与 [[YSS路由与合同编译]]）。
+`project-instance` 的独立代码审查工作单元是 `work-unit.code-review`：输入不可变候选快照、Spec、Ticket、合同和执行结果；输出 Standards、Spec、UI fidelity 三轴 Review 与 fresh verification；findings 已处理后须重新捕获候选并全量复审。旧文「代码审查双轴」已过期，不得再按标准符合性 / Spec 符合性两轴描述（见 [[Matt技能体系]]）。UI 影响切片的前端实现还原验证由独立 Reviewer 通过 UI fidelity 轴（见 [[产品设计影响与原型]]）。
 
-Git checkpoint 与阶段边界对齐，列出本轮覆盖阶段、变更产物和 Ticket 同步状态，排除无关脏文件；只有用户已授权时才按明确范围提交或推送。
+测试质量基线是模板推荐值：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`