create-dwy 0.16.1 → 0.17.1

package/src/sync-global-skills.js

@@ -0,0 +1,167 @@
+/**
+ * 将已选 skill 额外拷到用户全局目录。
+ * 项目目录同步仍由各平台 sync 负责；本模块只处理 ~/.claude / ~/.grok 等 home 下目录。
+ * 只覆盖本次点名的 skill，不删除全局目录里其它个人 skill。
+ */
+
+import fs from 'fs-extra'
+import os from 'node:os'
+import path from 'path'
+import { copyFilter, logAction } from './sync.js'
+
+/** 项目目录：随所选平台落到 .claude/skills、.agents/skills 等 */
+export const SKILL_DEST_PROJECT = 'project'
+
+/** 默认同步位置：只写项目，不碰用户 home */
+export const DEFAULT_SKILL_DESTINATIONS = [SKILL_DEST_PROJECT]
+
+/**
+ * 全局 dest id → home 下相对路径。
+ * 路径跟各工具官方发现目录对齐；测试通过 homeDir 注入，避免写真实 $HOME。
+ */
+const GLOBAL_SKILL_DIR_SEGMENTS = {
+  claude: ['.claude', 'skills'],
+  grok: ['.grok', 'skills'],
+  agents: ['.agents', 'skills'],
+  cursor: ['.cursor', 'skills'],
+  opencode: ['.config', 'opencode', 'skills'],
+}
+
+export const GLOBAL_SKILL_DEST_IDS = Object.keys(GLOBAL_SKILL_DIR_SEGMENTS)
+
+/**
+ * 项目内 skill 目录（按已选平台）。Cursor 无 skills，不列入。
+ * 仅 Skills 模式用这张表写项目，避免走完整 sync 误改 rules/commands/hooks。
+ */
+export const PROJECT_SKILL_DIR_BY_PLATFORM = {
+  claude: ['.claude', 'skills'],
+  codex: ['.agents', 'skills'],
+  opencode: ['.opencode', 'skills'],
+}
+
+/**
+ * 解析某平台在项目内的 skills 目录。不支持的平台返回 null。
+ *
+ * @param {string} projectDir
+ * @param {string} platform
+ */
+export function resolveProjectSkillDir(projectDir, platform) {
+  const segments = PROJECT_SKILL_DIR_BY_PLATFORM[platform]
+  if (!segments) return null
+  return path.join(projectDir, ...segments)
+}
+
+const DEST_LABELS = {
+  project: '项目目录',
+  claude: 'Claude Code 全局',
+  grok: 'Grok 全局',
+  agents: 'Codex / 跨运行时全局',
+  cursor: 'Cursor 全局',
+  opencode: 'OpenCode 全局',
+}
+
+/**
+ * 规范化交互/缓存里的 skill 同步范围。
+ * 未知 dest、空 skill 名丢弃；无 destinations 时回退到仅项目。
+ *
+ * @param {{ destinations?: string[], globalSkills?: string[] } | null | undefined} raw
+ */
+export function normalizeSkillScope(raw) {
+  const allowed = new Set([SKILL_DEST_PROJECT, ...GLOBAL_SKILL_DEST_IDS])
+  const destinations = (raw?.destinations || [])
+    .filter(id => allowed.has(id))
+  const globalSkills = [...new Set((raw?.globalSkills || []).filter(name => typeof name === 'string' && name.trim()))]
+
+  return {
+    destinations: destinations.length > 0 ? destinations : [...DEFAULT_SKILL_DESTINATIONS],
+    globalSkills,
+  }
+}
+
+/**
+ * 解析全局 dest 的绝对目录。project 返回 null（由平台 sync 写项目）。
+ *
+ * @param {string} destId
+ * @param {string} [homeDir]
+ */
+export function resolveGlobalSkillDir(destId, homeDir = os.homedir()) {
+  const segments = GLOBAL_SKILL_DIR_SEGMENTS[destId]
+  if (!segments) return null
+  return path.join(homeDir, ...segments)
+}
+
+/**
+ * 最后一步 UI 的位置选项。project 放第一项，默认勾选。
+ *
+ * @param {string} [homeDir]
+ * @returns {Array<{ value: string, label: string, description: string }>}
+ */
+export function listSkillDestOptions(homeDir = os.homedir()) {
+  return [
+    {
+      value: SKILL_DEST_PROJECT,
+      label: DEST_LABELS.project,
+      description: '默认。随上面所选平台写入项目 .claude/skills、.agents/skills 等',
+    },
+    ...GLOBAL_SKILL_DEST_IDS.map(id => {
+      const dir = resolveGlobalSkillDir(id, homeDir)
+      return {
+        value: id,
+        label: DEST_LABELS[id],
+        description: dir,
+      }
+    }),
+  ]
+}
+
+/**
+ * 把 skill 目录拷到已选全局 dest。destIds 含 project 时跳过（项目侧已同步）。
+ * 只写传入的 skills，不清理目标根目录里其它条目。
+ *
+ * @param {{ skills: Array<{ name: string, sourcePath: string }>, destIds: string[], homeDir?: string }} opts
+ * @returns {Promise<number>} 写入次数（每个 dest × 每个 skill）
+ */
+export async function copySkillsToGlobalDirs({ skills, destIds, homeDir = os.homedir() }) {
+  let count = 0
+
+  for (const destId of destIds) {
+    const destRoot = resolveGlobalSkillDir(destId, homeDir)
+    if (!destRoot) continue
+
+    for (const skill of skills) {
+      const dest = path.join(destRoot, skill.name)
+      await fs.ensureDir(path.dirname(dest))
+      await fs.copy(skill.sourcePath, dest, { overwrite: true, filter: copyFilter })
+      logAction(`${DEST_LABELS[destId] || destId}/${skill.name}`)
+      count++
+    }
+  }
+
+  return count
+}
+
+/**
+ * 仅 Skills 模式：把 skill 拷到项目内已选平台的 skills 目录。
+ * 不写 rules / commands / hooks。
+ *
+ * @param {{ projectDir: string, platforms: string[], skills: Array<{ name: string, sourcePath: string }> }} opts
+ * @returns {Promise<number>}
+ */
+export async function copySkillsToProjectPlatforms({ projectDir, platforms, skills }) {
+  let count = 0
+
+  for (const platform of platforms) {
+    const destRoot = resolveProjectSkillDir(projectDir, platform)
+    if (!destRoot) continue
+
+    for (const skill of skills) {
+      const dest = path.join(destRoot, skill.name)
+      await fs.ensureDir(path.dirname(dest))
+      await fs.copy(skill.sourcePath, dest, { overwrite: true, filter: copyFilter })
+      logAction(`${path.relative(projectDir, destRoot)}/${skill.name}`)
+      count++
+    }
+  }
+
+  return count
+}

package/src/sync.js

@@ -257,25 +257,35 @@ async function promptSelection(items, label, defaultNames) {
 
 /**
  * 交互式选择：每步可回退到上一步，最后总览支持任意类别重选。
+ * categories 可缩成仅 Skills，未出现的类别返回空数组（调用方不得据此删除已有项）。
  * 返回 { skills, rules, commands, hooks } 或 null（取消）。
+ *
+ * @param {object} scans
+ * @param {object} existing
+ * @param {{ categories?: Array<{ key: string, label: string }> }} [opts]
  */
-export async function interactiveSelect(scans, existing) {
-  const sel = {}
+export async function interactiveSelect(scans, existing, { categories = CATEGORIES } = {}) {
+  const sel = {
+    skills: [],
+    rules: [],
+    commands: [],
+    hooks: [],
+  }
 
   // 第一轮：顺序遍历，每步给导航
   let i = 0
-  while (i < CATEGORIES.length) {
-    const { key, label } = CATEGORIES[i]
-    const defaultNames = sel[key]
+  while (i < categories.length) {
+    const { key, label } = categories[i]
+    const defaultNames = sel[key]?.length
       ? new Set(sel[key].map(x => x.name))
       : existing[key]
     sel[key] = await promptSelection(scans[key], label, defaultNames)
     if (sel[key] === null) return null
 
-    if (i === CATEGORIES.length - 1) break
+    if (i === categories.length - 1) break
 
-    const nextLabel = CATEGORIES[i + 1].label
-    const prevLabel = i > 0 ? CATEGORIES[i - 1].label : null
+    const nextLabel = categories[i + 1].label
+    const prevLabel = i > 0 ? categories[i - 1].label : null
     // 导航步可搜索单选（选项少，交互与多选一致）
     const nav = await searchableSelect({
       message: `${label} 已选 ${sel[key].length} 项。下一步：`,
@@ -294,14 +304,14 @@ export async function interactiveSelect(scans, existing) {
   // 第二轮：总览 + 任意重选
   while (true) {
     console.log(chalk.gray('\n选择汇总：'))
-    for (const { key, label } of CATEGORIES) {
+    for (const { key, label } of categories) {
       console.log(chalk.gray(`  ${label.padEnd(10)} ${sel[key].length} 项`))
     }
     const final = await searchableSelect({
       message: '确认提交还是重选？',
       options: [
         { label: '确认提交', value: 'confirm' },
-        ...CATEGORIES.map(c => ({ label: `重选 ${c.label}`, value: c.key })),
+        ...categories.map(c => ({ label: `重选 ${c.label}`, value: c.key })),
         { label: '取消同步', value: 'cancel' },
       ],
       initialValue: 'confirm',
@@ -309,7 +319,7 @@ export async function interactiveSelect(scans, existing) {
     })
     if (isCancel(final) || final === 'cancel') return null
     if (final === 'confirm') return sel
-    const cat = CATEGORIES.find(c => c.key === final)
+    const cat = categories.find(c => c.key === final)
     sel[final] = await promptSelection(scans[final], cat.label, new Set(sel[final].map(x => x.name)))
     if (sel[final] === null) return null
   }

package/templates/ai-tools/CHANGELOG.md

@@ -52,6 +52,140 @@
 
 ---
 
+## 0.10.0 — 2026-08-13
+
+### Added
+
+- `skills/自媒体/dwy-doubao-tts`：豆包声音复刻 2.0 口播配音
+  - 脚本随 skill 同步，不放 `~/.grok/skills`
+  - API Key / 音色 ID 只读用户全局 `~/.dwy/config.yaml` 的 `doubao_tts`，禁止写入仓库
+
+---
+
+## 0.9.0 — 2026-08-11
+
+### Changed
+
+- **0010 合并竞品 + 演讲地图**：删除分步 `uc-media-0010-topic` / `uc-media-0020-product`
+  - 新单一 skill `uc-media-0010-product`：竞品/差异化后 **AI 强制自动填写** 讲/不讲/内容柱/时长
+  - 主文档 `0010-product/产品卡-*.md`（§1 竞品 · §2 洞察 · §3 AI 地图）
+  - 内容轨：`主题 → 0010 → 0030 按地图扩事实 → 0040`（无 0020 步）
+  - flow / CONTRACT / 清单 v7 / 0005 / 0030 / 0040 / README 对齐
+
+---
+
+## 0.8.0 — 2026-08-11
+
+### Changed
+
+- **内容轨因果修正**：`主题 → 0010 竞品 → 0020 演讲地图 → 0030 按地图扩事实 → 0040 蒸馏`
+  - skill 重命名：`uc-media-0010-topic`（竞品）、`uc-media-0020-product`（产品卡/地图）
+  - 目录：`0010-topic/竞品-*.md`、`0020-product/产品卡-*.md`
+  - 0030/0040/0005/flow/CONTRACT/README 全量对齐；清单 version 6
+  - 兼容：旧先产品后竞品、旧路径映射表
+
+---
+
+## 0.7.0 — 2026-08-11
+
+### Changed
+
+- **流程优化（P0/P1）**
+  - `uc-media-0005-ideation`：候选强制 `seed_links`；人选带入 0020
+  - `uc-media-0020-topic`：先消化 seed 再补检；「不做」回写池 `rejected`；正文称竞品包
+  - `uc-media-flow` / `CONTRACT`：fast 下 **0050 确认后连跑 0060→0070**；硬停收敛；风格 skill 挂载表
+  - `uc-media-0050-design`：可选跨集 `design-defaults.md`，本集只写增量
+  - `media-platform-packaging`：登记为可选 **0090 packaging**
+  - 执行清单 **version 5**；README 总览流程图
+
+---
+
+## 0.6.0 — 2026-08-11
+
+### Added
+
+- `skills/自媒体/uc-media-0005-ideation/`：选题发现 skill
+  - 硬依赖频道档案；多 agent（B站 / YouTube / 短视频 / 可选社区）搜集受众兴趣主题
+  - 跨集真源 `.dwy/uc-media/topic-backlog.md`；可选本集快照 `0005-ideation/选题池-*.md`
+  - **人选定**后进 0010；禁止自动代选；支持「刷新选题」force
+  - 模板：`topic-backlog.template.md` · `选题池.template.md`
+
+### Changed
+
+- `skills/自媒体/uc-media-flow/CONTRACT.md` · `SKILL.md` · `执行清单.template.md`（version 4）：接入 stage `ideation`、PATHS `topic_backlog`、硬停「0005 人选」
+- `skills/自媒体/uc-media-0010-product/`：无主题优先导向 0005；主题可来自选题池 `picked`
+- `skills/自媒体/uc-media-0020-topic/`：明确为单题竞品，选题发现归 0005
+- `skills/自媒体/README.md`：登记 0005 与 `topic-backlog.md`
+
+---
+
+## 0.5.0 — 2026-08-11
+
+### Added
+
+- `skills/自媒体/uc-media-0010-product/templates/channel-profile.template.md`：频道定位·受众·默认分发跨集模板
+- `skills/自媒体/uc-media-0010-product/templates/产品卡.template.md`：本集产品卡模板（§0 只读引用频道档案）
+
+### Changed
+
+- `skills/自媒体/uc-media-0010-product/SKILL.md`：拆分双真源——频道档案写 `<project_root>/.dwy/uc-media/channel-profile.md`（有则复用），本集产品卡只写主题·讲/不讲·分块时长；支持「更新频道定位 / 重写受众」强制刷新
+- `skills/自媒体/uc-media-flow/CONTRACT.md` · `SKILL.md` · `执行清单.template.md`：频道闸门、PATHS `channel_profile`、进度表 channel 行
+- `skills/自媒体/uc-media-0020-topic/` · `uc-media-0040-script/` · `uc-media-0050-design/`：上游必读频道档案；受众/语气/气质不再从本集卡重生成
+- `skills/自媒体/README.md`：目录结构补充 `.dwy/uc-media/`
+
+---
+
+## 0.4.2 — 2026-08-10
+
+### Added
+
+- `skills/自媒体/media-platform-packaging/assets/cover-style-master-v1.png`：封面视觉母版（style reference）
+
+### Changed
+
+- `skills/自媒体/media-platform-packaging/SKILL.md`：固定视觉母版约束 + 提示词骨架强制引用该母版；生成后 25% 缩放可读性检查
+
+---
+
+## 0.4.1 — 2026-08-10
+
+### Changed
+
+- `skills/自媒体/media-platform-packaging/`：同步源仓更新
+  - 平台表拆分 B站 / YouTube：B站用 `#标签`，YouTube 标签字段用英文逗号分隔关键词
+  - `references/platform-copy-examples.md` 增补 YouTube 标签格式示例
+
+---
+
+## 0.4.0 — 2026-08-10
+
+### Added
+
+- `skills/自媒体/media-platform-packaging/`：多平台自媒体包装与封面（源：`xiaoyuan-knowledge-town/.agents/skills/media-platform-packaging`）
+  - B站 / 抖音 / 小红书 / 微信视频号标题、简介、标签规则
+  - 16:9、4:3、3:4 封面版式与生图流程（依赖 `imagegen`）
+  - `references/platform-copy-examples.md`：标题长度与封面文字优先级示例
+  - 产出约定写入 `media/0070-package/` 包装清单
+
+### Changed
+
+- `skills/自媒体/README.md`：Skills 表登记 `media-platform-packaging`
+
+---
+
+## 0.3.0 — 2026-08-07
+
+### Added
+
+- 新分类 `skills/自媒体/`：迁入短视频 / 科普自媒体全流程 skills（源：`xiaoyuan-knowledge-town/function-tools/skills`）
+  - **编排**：`uc-media-flow`（CONTRACT + 执行清单模板，`fast`/`standard`）
+  - **流水线**：`uc-media-0010-product` → `0020-topic` → `0030-facts` → `0040-script` → `0050-design` → `0060-assets` → `0070-package` → `0080-factory`
+  - **扩展**：`uc-media-comic-kit`（漫画科普表达）、`uc-media-knowledge-town`（知识小城视觉 / Remotion 预设）
+  - 含 scripts（facts HTML、shots 校验、cue timeline）、templates、schema、Remotion 组件资产
+  - 硬编路径 `templates/skills/…` 改为 skill 包相对路径，适配 `dwy` sync 后 `.claude/skills/` / `.agents/skills/`
+
+---
+
 ## 0.2.0 — 2026-07-23
 
 ### Added

package/templates/ai-tools/VERSION

@@ -1 +1 @@
-0.2.0
+0.10.0

package/templates/ai-tools/rules/Android/dwy-android-core.md

@@ -454,6 +454,70 @@ val data = newService.fetch()
 // TODO(zhang, 2026-05-30): 兼容企业微信扫码,关联 issue #1234
 ```
 
+### 2.9.1 临时代码标识（强制 · Java / Kotlin / XML）
+
+产品源码（`src/main` 等）中的业务待办、调试旁路、假数据**必须**用固定标签，便于 AS TODO 窗口 / 全局搜索定位。`src/test`、`androidTest` 正规测试 mock **不强制**。
+
+| 标签 | 用途 | 格式 |
+|---|---|---|
+| `TODO` | 业务/技术未完成 | `// TODO(name, YYYY-MM-DD): 说明`（同 §2.9） |
+| `TESTCODE` | 临时调试、跳过校验、试验开关 | `// TESTCODE: 说明 + 移除条件` |
+| `MOCK` | 假数据、假接口、stub 实现 | `// MOCK: 说明 + 将来替换点` |
+
+- 注释符：Java/Kotlin 用 `//`；XML 用 `<!-- -->`
+- 写 mock/调试代码的**同一 diff 必须带标**；接真实现后**删标签与包夹**
+- 禁止无标签假返回；禁止自造 `// 假数据`、`// test only` 等替代词
+- 发版/提测前搜 `MOCK`、`TESTCODE`，清单交给负责人确认（允许残留但须知情）
+
+**单行**（仅一行代码）：行上写标签即可。
+
+```kotlin
+// MOCK: 用户列表假数据，接 UserRepository.list() 后删除
+fun users() = listOf(User("张三"))
+
+// TESTCODE: 本地跳过登录，联调完删除
+if (BuildConfig.DEBUG) return true
+```
+
+**多行 / 大段（≥2 行逻辑）强制包夹**——标签在前、`BEGIN`/`END` 成对，说明写在 `BEGIN` 行：
+
+```text
+// MOCK BEGIN: <说明 + 将来替换点>
+... 多行假数据 / stub ...
+// MOCK END
+
+// TESTCODE BEGIN: <说明 + 移除条件>
+... 多行调试 / 旁路 ...
+// TESTCODE END
+```
+
+```kotlin
+// ❌ 大段无包夹
+fun loadHome(): HomeData {
+    val banners = listOf(Banner("a"), Banner("b"))
+    val user = User("张三")
+    return HomeData(banners, user)
+}
+
+// ✅
+// MOCK BEGIN: 首页假数据，接 HomeRepository.fetch 后删除
+fun loadHome(): HomeData {
+    val banners = listOf(Banner("a"), Banner("b"))
+    val user = User("张三")
+    return HomeData(banners, user)
+}
+// MOCK END
+```
+
+```xml
+<!-- MOCK BEGIN: 预览占位，接 CMS 后删除 -->
+<TextView android:text="占位标题" />
+<TextView android:text="占位副标题" />
+<!-- MOCK END -->
+```
+
+AS 默认 TODO 窗主要扫 `TODO`；`TESTCODE`/`MOCK` 用全局搜索，或在 Settings → Editor → TODO 增加 pattern `\bTESTCODE\b.*`、`\bMOCK\b.*`。
+
 ### 2.10 Gradle 脚本注释(Groovy)
 
 老项目的 `build.gradle` / `settings.gradle` 多用 **Groovy** 编写(新项目 Kotlin DSL `*.gradle.kts` 同理)。构建脚本是声明式配置,注释**只解释"为什么这样配",不复述配置项字面**。
@@ -995,7 +1059,7 @@ if (trimmed.isNotEmpty()) { ... }
 | 15  | 无空 `catch` 块、无 `catch (Throwable)`、无 `e.printStackTrace()`                                                                                                                                                                | ✓        |
 | 16  | 嵌套不超过 3 层,函数体不超过 50 行,单文件不超过 500 行                                                                                                                                                                                        | ✓        |
 | 17  | 资源命名遵守:layout 前缀(`activity_`* / `fragment_*` / `item_*`)、id 控件缩写(`tv_*` / `et_*` / `btn_*` / `rv_*` …)、drawable / selector 状态后缀(`_normal` / `_pressed` / `_disabled` …)、anim / menu / style / mipmap 命名,9-patch 带 `.9` 后缀 | ✓        |
-| 18  | 无注释掉的代码块(垃圾代码),TODO 必须带责任人 + 日期 + 上下文                                                                                                                                                                                     | ✓        |
+| 18  | 无注释掉的代码块(垃圾代码)；业务 TODO 带责任人+日期；产品源码假数据/调试旁路带 `MOCK:` / `TESTCODE:`                                                                                                                                                     | ✓        |
 | 19  | `if` / `else` / `else if` / `for` / `while` / `do-while` 语句即使单行也带 `{}`(Kotlin 表达式 `if` 除外)                                                                                                                                | ✓        |
 | 20  | 新增类按**功能聚合**放对应功能包(`login/` / `order/`),不按 `activities/` / `models/` 分层横切;仅多功能共享才放 `common/`                                                                                                                              | ✓        |
 | 21  | Gradle 脚本(Groovy / kts):锁版本 / `exclude` / 自定义 task / 变体 / 关键魔法值有 why 注释,无复述式、无注释掉的配置块                                                                                                                                     | ✓        |

package/templates/ai-tools/rules/Python/dwy-python-core.md

@@ -282,6 +282,53 @@ class CreateUserRequest(BaseModel):
 - 所有类、所有方法/函数（含私有）**必须**有 docstring
 - docstring 统一使用 **Google 风格**
 
+### 临时代码标识（强制）
+
+产品源码中的业务待办、调试旁路、假数据**必须**用固定标签，便于编辑器全局搜索。`tests/` 内正规 mock / fixture **不强制**。
+
+| 标签 | 用途 | 格式 |
+|---|---|---|
+| `TODO` | 业务/技术未完成 | `# TODO(name, YYYY-MM-DD): 说明`（推荐带责任人与日期） |
+| `TESTCODE` | 临时调试、跳过校验、试验开关 | `# TESTCODE: 说明 + 移除条件` |
+| `MOCK` | 假数据、假接口、stub 实现 | `# MOCK: 说明 + 将来替换点` |
+
+- 写 mock/调试代码的**同一 diff 必须带标**；接真实现后**删标签与包夹**
+- 禁止无标签假返回；禁止自造 `# 假数据`、`# test only` 等替代词
+- 发版/提测前 `rg 'MOCK|TESTCODE'`，清单交给负责人确认（允许残留但须知情）
+
+**单行**（仅一行代码）：
+
+```python
+# MOCK: 登录假 token，接 POST /auth/login 后删除
+return {"token": "fake-token"}
+
+# TESTCODE: 强制测试账号，提测前删除
+user_id = 1
+```
+
+**多行 / 大段（≥2 行逻辑）强制包夹**：
+
+```text
+# MOCK BEGIN: <说明 + 将来替换点>
+...
+# MOCK END
+
+# TESTCODE BEGIN: <说明 + 移除条件>
+...
+# TESTCODE END
+```
+
+```python
+# MOCK BEGIN: 用户详情假数据，接 UserRepository.get 后删除
+user = {
+    "id": 1,
+    "name": "张三",
+    "roles": ["admin"],
+}
+return user
+# MOCK END
+```
+
 ### 完整示例（模块 / 类 / 方法 / 私有方法 docstring）
 
 ```python

package/templates/ai-tools/rules/Vue/dwy-vue-core.md

@@ -453,6 +453,60 @@ import type { UserInfo } from '@/features/users/types'
 5. 全部使用**中文**，**禁止**混用中英文
 6. 代码改了，注释**必须**同步更新
 
+### 临时代码标识（强制 · TS / Vue）
+
+产品源码（`src/`）中的业务待办、调试旁路、假数据**必须**用固定标签。`tests/` 内 Vitest mock **不强制**。
+
+| 标签 | 用途 | 格式 |
+|---|---|---|
+| `TODO` | 业务/技术未完成 | `// TODO(name, YYYY-MM-DD): 说明`（推荐） |
+| `TESTCODE` | 临时调试、`console` 后门、试验开关 | `// TESTCODE: 说明 + 移除条件` |
+| `MOCK` | 假数据、假接口、stub | `// MOCK: 说明 + 将来替换点` |
+
+- `<script>` / `.ts` 用 `//`；模板用 `<!-- ... -->`
+- 写 mock/调试的**同一 diff 必须带标**；接真实现后**删标签与包夹**
+- 禁止无标签假返回；禁止自造 `// 假数据` 等替代词
+- 发版前搜 `MOCK`、`TESTCODE`，清单确认（允许残留但须知情）
+
+**单行**（仅一行代码）：
+
+```ts
+// MOCK: 首页 banner 假数据，接 GET /banners 后删除
+const banners = ref([{ id: 1, title: 'demo' }])
+
+// TESTCODE: 打开时 dump store，上线前删除
+// console.log(store.$state)
+```
+
+**多行 / 大段（≥2 行逻辑）强制包夹**：
+
+```text
+// MOCK BEGIN: <说明 + 将来替换点>
+...
+// MOCK END
+
+// TESTCODE BEGIN: <说明 + 移除条件>
+...
+// TESTCODE END
+```
+
+```ts
+// MOCK BEGIN: 首页假数据，接 GET /home 后删除
+const banners = ref([
+  { id: 1, title: 'demo-a' },
+  { id: 2, title: 'demo-b' },
+])
+const user = ref({ name: '张三' })
+// MOCK END
+```
+
+```vue
+<!-- MOCK BEGIN: 无接口时的占位，接 CMS 后删除 -->
+<div>占位标题</div>
+<div>占位副标题</div>
+<!-- MOCK END -->
+```
+
 ### 示例
 
 ```typescript
@@ -509,6 +563,7 @@ AI 编写或审查 Vue 代码时，**必须**检查以下违规模式：
 | 解构 store 丢响应性 | `const { x } = store`（应用 `storeToRefs`） | 高 |
 | 注释缺失 | 导出函数 / 类型 / 接口字段无中文注释 | 中 |
 | 注释为英文 | 项目中文环境下写英文注释 | 中 |
+| 无标签 mock/调试 | `src/` 假数据或调试旁路未标 `MOCK:` / `TESTCODE:` | 高 |
 | 硬编码 API 地址 | URL 直接写在代码里，未走 `import.meta.env` | 高 |
 | 相对路径回溯 | `../../../` 跨层导入 | 中 |
 | scoped 替代 Tailwind | 大段 scoped CSS 实现可用 Tailwind 表达的样式 | 中 |

package/templates/ai-tools/rules/iOS/dwy-swift-core.md

@@ -36,6 +36,52 @@ final class TaskListViewModel {}
 - 统一 `guard` + early return，不要多层 `else`。
 - 禁止 `try?` 吞异常；不写无意义 `value ?? default`。
 
+### 临时代码标识（强制）
+
+产品源码中的业务待办、调试旁路、假数据**必须**用固定标签（`//`，勿写进正式 `///` 文档注释）。单元测试 / UITest 正规 mock **不强制**。
+
+| 标签 | 用途 | 格式 |
+|---|---|---|
+| `TODO` | 业务/技术未完成 | `// TODO(name, YYYY-MM-DD): 说明`（推荐） |
+| `TESTCODE` | 临时调试、跳过生物识别/鉴权等 | `// TESTCODE: 说明 + 移除条件` |
+| `MOCK` | 假数据、stub Service | `// MOCK: 说明 + 将来替换点` |
+
+- 写 mock/调试的**同一 diff 必须带标**；接真实现后**删标签与包夹**
+- 禁止无标签假返回；禁止自造 `// 假数据` 等替代词
+- 发版/提测前搜 `MOCK`、`TESTCODE`，清单确认（允许残留但须知情）
+
+**单行**（仅一行代码）：
+
+```swift
+// MOCK: 个人资料假数据，接 ProfileService.fetch 后删除
+let profile = Profile(name: "Demo", avatarURL: nil)
+
+// TESTCODE: 跳过生物识别，提测包删除
+// return true
+```
+
+**多行 / 大段（≥2 行逻辑）强制包夹**：
+
+```text
+// MOCK BEGIN: <说明 + 将来替换点>
+...
+// MOCK END
+
+// TESTCODE BEGIN: <说明 + 移除条件>
+...
+// TESTCODE END
+```
+
+```swift
+// MOCK BEGIN: 个人资料假数据，接 ProfileService.fetch 后删除
+let profile = Profile(
+    name: "Demo",
+    avatarURL: nil,
+    roles: ["user"]
+)
+// MOCK END
+```
+
 ## 全面屏与布局
 
 - 默认尊重安全区；固定内容区用 `safeAreaInset` / `safeAreaPadding`。