create-yss-spec 2.1.15 → 2.2.0

package/template/wiki/raw/triage-labels.md

@@ -1,15 +0,0 @@
-# Triage 标签
-
-本文定义 Agent 分诊时使用的五种标准角色，以及它们在当前 Ticket tracker 中对应的标签。
-
-| 标准角色 | Tracker 标签 | 含义 |
-| --- | --- | --- |
-| `needs-triage` | `needs-triage` | 等待维护者评估 Ticket |
-| `needs-info` | `needs-info` | 等待报告者补充信息 |
-| `ready-for-agent` | `ready-for-agent` | 必要门禁已通过、阻塞边已清除，可由 Agent 直接实现的垂直切片 Ticket |
-| `ready-for-human` | `ready-for-human` | Spec、设计、契约草案或其他资产需要人工审查、判断或特权访问 |
-| `wontfix` | `wontfix` | 不会处理 |
-
-当 skill 提及某个标准角色时，使用表中对应的 Tracker 标签。
-
-Local Markdown 主 tracker 不调用远程标签：在 Ticket 文件顶部使用同名 `Status:` 值记录标准角色。Wayfinder 的 `claimed` / `resolved` 仅是临时工作状态，不属于本表五态；进入交付 Ticket 前必须转换为标准 `Status:`。

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

@@ -1,132 +0,0 @@
----
-status: ready-for-human
----
-
-# 垂直切片 Ticket：<标题>
-
-Status: ready-for-human
-
-## 父级
-
-<Spec：`docs/.scratch/<feature>/spec.md`；功能父 Ticket：`docs/.scratch/<feature>/parent-ticket.md` 或远程 Issue URL>
-
-## 要构建什么
-
-描述本 Ticket 要交付的窄而完整的端到端行为。它必须贯穿所有受影响层，是可独立验证的垂直切片，不能只是某一层的横向任务。
-
-## 覆盖的用户故事
-
-- <用户故事 ID 或文本>
-
-## OpenAPI 影响
-
-- [ ] 无
-- [ ] 基于冻结 OpenAPI：`docs/.scratch/<feature>/api/<feature>.yaml`
-
-受影响端点：
-
-| 方法 | 路径 | 变更 |
-|---|---|---|
-| | | |
-
-## 验收标准
-
-- [ ] 标准 1
-- [ ] 标准 2
-- [ ] 标准 3
-
-## 测试 Seam
-
-- 主要公共接口：
-- 必需测试：
-  - [ ] 行为 / 领域测试
-  - [ ] API / 契约测试
-  - [ ] UI / 组件测试
-  - [ ] E2E 测试
-
-## Slice Implementation Contract
-
-| 字段 | 内容 |
-|---|---|
-| contract_id |  |
-| contract_version |  |
-| contract_ref |  |
-| Router 状态 | draft / blocked / ready-for-lifecycle-review |
-| 生命周期批准状态 | pending / approved / rejected |
-| Build Architecture Checklist |  |
-
-> Router 不得自行将合同批准或将本 Ticket 推进为 `ready-for-agent`。只有生命周期编排器核验并持久化当前版本合同、清除阻塞边后，才能推进状态。
-
-### 工作单元
-
-| work_unit_id | 验收行为 / 目标 | primary_skill | supporting_skills | tdd_mode | allowed_write_paths | expected_evidence | verification_commands | Execution Result 引用 | 状态 |
-|---|---|---|---|---|---|---|---|---|---|
-|  |  |  |  | behavior-tdd / controlled-generation |  |  |  |  | pending / running / blocked / completed / stale |
-
-`controlled-generation` 仅允许机械脚手架、样板、冻结客户端或配置，并记录 exception reason、生成器输入和生成后行为测试；业务规则、状态机、事务、权限、错误映射、复杂查询和用户可见交互必须使用 `behavior-tdd`。只有需求明确包含权限业务行为时才把它写入工作单元，不另设安全 / 权限姿态。
-
-## YSS 技能与后端实现合同
-
-> 涉及后端时必须填写；不涉及时写明 `not-applicable`。不得只写“符合 YSS”。
-
-| 影响面 | 必需 skill | 需要 / 不需要的理由 | 预期证据 |
-|---|---|---|---|
-| 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` |  |  |
-
-### 后端阻断规则
-
-- [ ] 未填写 `Backend Slice Implementation Contract` 时不得写后端业务代码。
-- [ ] `CMD` / `Query` / `VO` / `SingleResult` / `MultiResult` / `PageResult` 按 `yss-dto` 定义或复用；不私自新建 / 混用响应包装。
-- [ ] Controller 不用内部类或非约定包临时承载主要 DTO / VO；写操作参数继承 `CommandDTO`，读操作参数继承 `QueryDTO` 或 `PageQuery`，分页查询优先继承 `PageQuery`。
-- [ ] Controller 不手工分页主要业务集合，不穿透 Repository / Mapper / PO。
-- [ ] Application 只做用例编排、事务边界和跨聚合协调，核心领域规则放入 Domain。
-- [ ] 需要持久化的切片必须补 PO / Repository / Convertor / GatewayImpl；临时 `InMemory*Gateway` 必须标记 `seam-deferred`。
-- [ ] POJO 样板代码默认使用 Lombok；成片手写 getter/setter、constructor、builder、logger 必须说明例外原因、测试证据和 review 结论。
-- [ ] MapStruct / Convertor 强制优先；`BeanUtils.copyProperties`、反射式通用拷贝或重复手写 mapping 必须说明例外原因、测试证据和 review 结论。
-
-## 阻塞关系
-
-- 无，可立即开始
-
-## 重路由状态
-
-| 字段 | 内容 |
-|---|---|
-| reroute_status | current / incremental-review / full-reroute-required / lifecycle-return / stale |
-| trigger | 新 API/schema / 状态机 / 数据模型 / 写路径 / 仓库 / skill / seam / 风险 / 交付顺序 / other |
-| affected_work_units |  |
-| new_impacts |  |
-| stale_contract_version |  |
-| return_stage | Router / Architecture Re-check / 产品设计 / OpenAPI Draft-Review-Freeze / 系统或数据架构 / other |
-| recovery_conditions |  |
-
-出现 `drift`、`violation` 或非空 `new_impacts` 时暂停受影响工作单元，不得先完成代码再补合同；更新合同版本并通过生命周期审查后才能恢复。
-
-## 状态
-
-`ready-for-agent`
-
-> 仅当阻塞关系为“无”且必要门禁已通过时填写 `ready-for-agent`；否则写明被哪个 Ticket 阻塞。
-
-## AI / 人工审查点
-
-- [ ] 无高风险变更或需人工确认项
-- [ ] 原生 SQL：记录验证证据
-- [ ] 公共基础库 API：记录验证证据
-
-## 完成定义
-
-- [ ] 如有需要，已基于冻结 OpenAPI Spec 拆分切片
-- [ ] 实现完成
-- [ ] 已新增测试且测试通过
-- [ ] 已移除调试 / 原型代码
-- [ ] 已回勾 `Backend Slice Implementation Contract` 和 `Build Architecture Checklist`
-- [ ] 已回勾当前 `contract_id` / `contract_version`、全部工作单元和对应 `YSS Skill Execution Result`
-- [ ] 实际 changed files 均在合同允许路径内，预期证据齐全，验证结果包含执行时间
-- [ ] `new_impacts`、`drift`、`violation` 和重路由状态均有明确结论，合同未处于 `stale`
-- [ ] 如领域或架构决策变化，已更新 `CONTEXT.md` / ADR；新增业务术语含 PascalCase `英文标识`，代码与契约字段能追溯到该词干

package/template/wiki/raw/yss-project.yaml

@@ -1,2 +0,0 @@
-schema_version: 1
-repository_mode: template-source

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`