@hupan56/wlkj 3.3.13 → 3.3.15

package/bin/cli.js

@@ -1,13 +1,6 @@
 #!/usr/bin/env node
 // wlkj - workflow toolkit
 
-// Windows 中文乱码修复：cmd/PowerShell 默认 GBK，cli.js 输出 UTF-8 → 乱码
-if (process.platform === "win32") {
-  try { execSync("chcp 65001", { stdio: "ignore" }); } catch (e) {}
-  process.stdout.setDefaultEncoding("utf-8");
-  process.stderr.setDefaultEncoding("utf-8");
-}
-
 const path = require("path");
 const fs = require("fs");
 const { execSync } = require("child_process");

package/package.json

@@ -1,29 +1,29 @@
-{
-  "name": "@hupan56/wlkj",
-  "version": "3.3.13",
-  "description": "AI Product R&D Workflow - PRD/Prototype/Search/Task/Report",
-  "bin": {
-    "wlkj": "bin/cli.js"
-  },
-  "files": [
-    "bin/",
-    "templates/",
-    "MAC-VERIFY.md"
-  ],
-  "keywords": [
-    "workflow",
-    "ai",
-    "prd",
-    "pipeline",
-    "qoder",
-    "product",
-    "team"
-  ],
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=16"
-  }
-}
+{
+  "name": "@hupan56/wlkj",
+  "version": "3.3.15",
+  "description": "AI Product R&D Workflow - PRD/Prototype/Search/Task/Report",
+  "bin": {
+    "wlkj": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "templates/",
+    "MAC-VERIFY.md"
+  ],
+  "keywords": [
+    "workflow",
+    "ai",
+    "prd",
+    "pipeline",
+    "qoder",
+    "product",
+    "team"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=16"
+  }
+}

package/templates/qoder/commands/optional/wl-spec.md

@@ -38,11 +38,3 @@ User input:
 ## 下一步
 - spec 已 confirmed → `/wl-code <REQ-ID>` 按 spec 严格实现（spec gate 放行）
 - 实现完 → `/wl-test` 验证 → `/wl-commit` 提交回流
-
-
-## 🚨 接地铁律（防幻觉/保真，Qoder AI 必须遵守）
-
-1. **溯源**：引用代码符号/表名/接口用**真实原名**（如 `CostApplyController`、`base_asset`），非中文描述——只引 MCP 工具（rag_search/schema_link/context_360/get_impact 等）召回的真实符号，提升可溯源性
-2. **禁编**：不编造未在召回里出现的类名/表名/字段/接口；召回不足时标"待确认（知识层未召回）"，**诚实优于编造**
-3. **接地（数据表）**：涉及数据表/字段时，先调 MCP `schema_link`/`query_schema` 取真表真列；未召回真表禁编 t_xxx 表名+字段充数
-4. **完整**：产物详尽展开（每节实质内容，不一行带过）

package/templates/qoder/commands/optional/wl-status.md

@@ -89,11 +89,3 @@ $PY "$R/.qoder/scripts/validation/metrics/usability_score.py" --html
 - **CLI/IDE**（NoOp 自动降级）：落盘 `workspace/members/{dev}/journal/dashboard-{时间戳}.html`，输出路径供打开
 
 不用 cap.present 也能跑——上面的 Health Score 维度表本身是纯文本，富展示只是增强可视化（T244 cap.present 接入点）。
-
-
-## 🚨 接地铁律（防幻觉/保真，Qoder AI 必须遵守）
-
-1. **溯源**：引用代码符号/表名/接口用**真实原名**（如 `CostApplyController`、`base_asset`），非中文描述——只引 MCP 工具（rag_search/schema_link/context_360/get_impact 等）召回的真实符号，提升可溯源性
-2. **禁编**：不编造未在召回里出现的类名/表名/字段/接口；召回不足时标"待确认（知识层未召回）"，**诚实优于编造**
-3. **接地（数据表）**：涉及数据表/字段时，先调 MCP `schema_link`/`query_schema` 取真表真列；未召回真表禁编 t_xxx 表名+字段充数
-4. **完整**：产物详尽展开（每节实质内容，不一行带过）

package/templates/qoder/commands/wl-code.md

@@ -216,11 +216,3 @@ cap.mcp.call("learn", {
 })
 ```
 - 至少写 1 条最有价值的认知。try/except 不阻塞。
-
-
-## 🚨 接地铁律（防幻觉/保真，Qoder AI 必须遵守）
-
-1. **溯源**：引用代码符号/表名/接口用**真实原名**（如 `CostApplyController`、`base_asset`），非中文描述——只引 MCP 工具（rag_search/schema_link/context_360/get_impact 等）召回的真实符号，提升可溯源性
-2. **禁编**：不编造未在召回里出现的类名/表名/字段/接口；召回不足时标"待确认（知识层未召回）"，**诚实优于编造**
-3. **接地（数据表）**：涉及数据表/字段时，先调 MCP `schema_link`/`query_schema` 取真表真列；未召回真表禁编 t_xxx 表名+字段充数
-4. **完整**：产物详尽展开（每节实质内容，不一行带过）

package/templates/qoder/commands/wl-commit.md

@@ -41,11 +41,3 @@ Before committing, check:
 ## 下一步
 - 提交回流成功后，更新任务状态：`/wl-task finish <REQ-ID>`（标记开发完成，同步禅道）
 - 查看本次提交在需求链路的位置：平台资产中心 → 需求 → 变更史
-
-
-## 🚨 接地铁律（防幻觉/保真，Qoder AI 必须遵守）
-
-1. **溯源**：引用代码符号/表名/接口用**真实原名**（如 `CostApplyController`、`base_asset`），非中文描述——只引 MCP 工具（rag_search/schema_link/context_360/get_impact 等）召回的真实符号，提升可溯源性
-2. **禁编**：不编造未在召回里出现的类名/表名/字段/接口；召回不足时标"待确认（知识层未召回）"，**诚实优于编造**
-3. **接地（数据表）**：涉及数据表/字段时，先调 MCP `schema_link`/`query_schema` 取真表真列；未召回真表禁编 t_xxx 表名+字段充数
-4. **完整**：产物详尽展开（每节实质内容，不一行带过）

package/templates/qoder/commands/wl-init.md

@@ -1,129 +1,129 @@
----
-name: wl-init
-description: "初始化/切换开发者身份 + 环境体检。Initialize/switch developer identity + environment health check. "
-argument-hint: "[name] [role]"
-auto-approve: true
-allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]
----
-
-# /wl-init - One-stop Init (Developer + Environment Doctor)
-
-Usage:
-  /wl-init              - 体检环境 + 显示状态
-  /wl-init 小王          - 切换/注册开发者 + 体检 + 自动修复
-  /wl-init 小王 pm       - 注册新开发者(带角色) + 体检 + 自动修复
-
-## 🔧 环境自检（QoderWork 桌面端 vs Qoder IDE/CLI）
-
-**先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
-```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
-PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
-```
-> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。后续脚本统一用 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`。
-
-## Engine: init_doctor.py (幂等, 增量, 永不重头再来)
-
-> **鲁棒性保证**：doctor 每项检查独立，**单项失败不阻塞其它项**；无 git 时优雅降级（团队同步/克隆禁用，但本地 PRD/搜索/任务/报告仍可用）。
-> **退出码**：`0` = 全部健康，`1` = 有未解决问题（`--fix` 能修的已自动修）。AI 据此判断"是否可直接开工"。
-
-### Case 1: /wl-init (no arguments)
-```bash
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" doctor 2>/dev/null || python3 "$R/.qoder/scripts/orchestration/wlkj.py" doctor
-```
-Report the doctor's findings to the user in friendly language.
-If it found fixable issues, ask: "发现 N 个问题，要我自动修复吗？"
-then run with --fix.
-
-### Case 2/3: /wl-init 小王 [pm]
-```bash
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" doctor 2>/dev/null || python3 "$R/.qoder/scripts/orchestration/wlkj.py" doctor --fix 小王 [pm]
-```
-This single command does ALL of:
-1. 注册/切换开发者 (.qoder/.developer, key=value 格式) + 个人空间目录
-2. 拉取团队最新 (team_sync pull - 拿到别人的 PRD 和最新知识图谱)
-3. 克隆缺失的源码仓库 (按 config.yaml git_sync.projects)
-4. 知识图谱: 7天内新鲜->跳过 / 过期->增量同步 / 缺失->全量构建(仅首次)
-5. 校验风格约束文件 + PRD 模板
-6. 检查周五自动构建状态, 给出本系统的设置命令
-
-After doctor finishes:
-- init_developer auto-registers identity (member.json + signing key)
-- No separate "team.py add" needed anymore
-
-## Incremental Guarantee (为什么不会重头再来)
-
-| 状态 | 行为 |
-|------|------|
-| 本周已 init 过 / 周五任务跑过 | 索引新鲜(≤7天) -> 全部跳过, 秒级完成 |
-| 周五任务没跑/失效 | 索引过期 -> git diff 增量更新, 只处理变更文件 |
-
-## 🔗 平台项目绑定（60 人各用各的项目）
-
-**每个开发者绑定自己的项目。** `/wl-init` 时选择 → 拉 token → 写 mcp_config.json。
-**切换项目 = 重跑 `/wl-init` 选另一个。** 60 人各自选自己的项目，token 绑定到项目，知识层自动隔离。
-
-### 已绑定？（探测多宿主路径）
-```bash
-grep -l WLKJ_PROJECT_ID "$R/.qoder/mcp_config.json" 2>/dev/null && echo "已绑定" || echo "未绑定"
-```
-
-### 未绑定或要切换？一行命令：
-```bash
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" switch-project
-```
-脚本会：
-1. 问邮箱+密码（或用 --email/--pw 参数）
-2. 连平台 `POST /api/auth/bind` 拉项目列表
-3. 列出你的所有项目，选一个
-4. 自动写 mcp_config.json（含该项目的 token + project_id）
-
-非交互模式（CI/自动化）：
-```bash
-$PY "$R/.qoder/scripts/orchestration/wlkj.py" switch-project --email a@b.c --pw xxx --project-uuid <UUID>
-```
-
-**之后所有命令自动用该项目的知识层、token、回流地址。不同人选不同项目 = 完全隔离。**
-| 全新机器 | 克隆仓库 + 全量构建一次, 之后永远增量 |
-| 团队其他人已更新图谱 | team_sync pull 直接拿到, 本机不用构建 |
-
-## .developer File Format (MANDATORY)
-
-ALWAYS write `.qoder/.developer` in key=value format:
-```
-name=小王
-role=pm
-initialized_at=2026-06-12T10:00:00
-```
-Do NOT use `name: value` style. (Parsers accept both for legacy files,
-but new writes must use `=`.)
-
-## Git Author Check
-
-The doctor reports if `git config user.name` differs from the developer
-name (it breaks /wl-report's commit statistics). If the user agrees,
-run: `git config user.name {name}`. Do not change it without confirmation.
-
-## Status Display
-After any operation, show:
-```
-Developer: 小王 (pm)
-Team: 3 members (1 PM, 2 Dev)
-Active tasks: 2 (1 in progress, 1 draft)
-知识图谱: 2 天前更新 (新鲜)
-```
-
-## Safety Rules
-- NEVER delete workspace/ content
-- NEVER overwrite member.json or task.json
-- Full index build ONLY when index is completely missing (doctor handles this)
-
-## 产品常踩的坑（遇到时这样解释，别让产品卡住）
-
-| 现象 | 原因 | 怎么说 / 怎么办 |
-|------|------|----------------|
-| `/wl-init --fix` 卡在第 4 项几分钟 | 正在 clone 大源码仓库（fywl-ics 8973 文件） | 告诉用户"首次克隆大仓库要几分钟，属正常，耐心等"。clone 失败（网络/权限）只影响"搜索真实代码"，本地 PRD/任务/报告不受影响 |
-| 搜代码总返回 0 结果 / 生成原型字段全空 | `config.yaml` 的 `platforms.{xx}.project` 写的项目名在 `data/code/` 下不存在（管理员改了 git_sync URL 忘改 platforms） | doctor 第 4 项会报 `platforms.X.project = '...' 但无此目录`。让管理员核对 config.yaml 的 platforms 映射 |
-| `git user.name` 与开发者名不一致警告 | 影响后续 /wl-report 统计 + push 门禁 | doctor 已自动用 `--fix` 修正本仓库 git config。用户未带 `--fix` 时提示重跑 |
-| 没装 git | doctor 第 1 项报 WARN | 不阻塞：本地 PRD/搜索/任务/报告仍可用，只有团队同步/克隆禁用 |
-| 搜出来的代码是旧的 | 知识图谱 >7 天未更新 | doctor 第 5 项会增量同步，`--fix` 自动跑 |
+---
+name: wl-init
+description: "初始化/切换开发者身份 + 环境体检。Initialize/switch developer identity + environment health check. "
+argument-hint: "[name] [role]"
+auto-approve: true
+allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]
+---
+
+# /wl-init - One-stop Init (Developer + Environment Doctor)
+
+Usage:
+  /wl-init              - 体检环境 + 显示状态
+  /wl-init 小王          - 切换/注册开发者 + 体检 + 自动修复
+  /wl-init 小王 pm       - 注册新开发者(带角色) + 体检 + 自动修复
+
+## 🔧 环境自检（QoderWork 桌面端 vs Qoder IDE/CLI）
+
+**先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
+```bash
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
+```
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。后续脚本统一用 `$PY "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`。
+
+## Engine: init_doctor.py (幂等, 增量, 永不重头再来)
+
+> **鲁棒性保证**：doctor 每项检查独立，**单项失败不阻塞其它项**；无 git 时优雅降级（团队同步/克隆禁用，但本地 PRD/搜索/任务/报告仍可用）。
+> **退出码**：`0` = 全部健康，`1` = 有未解决问题（`--fix` 能修的已自动修）。AI 据此判断"是否可直接开工"。
+
+### Case 1: /wl-init (no arguments)
+```bash
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" doctor 2>/dev/null || python3 "$R/.qoder/scripts/orchestration/wlkj.py" doctor
+```
+Report the doctor's findings to the user in friendly language.
+If it found fixable issues, ask: "发现 N 个问题，要我自动修复吗？"
+then run with --fix.
+
+### Case 2/3: /wl-init 小王 [pm]
+```bash
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" doctor 2>/dev/null || python3 "$R/.qoder/scripts/orchestration/wlkj.py" doctor --fix 小王 [pm]
+```
+This single command does ALL of:
+1. 注册/切换开发者 (.qoder/.developer, key=value 格式) + 个人空间目录
+2. 拉取团队最新 (team_sync pull - 拿到别人的 PRD 和最新知识图谱)
+3. 克隆缺失的源码仓库 (按 config.yaml git_sync.projects)
+4. 知识图谱: 7天内新鲜->跳过 / 过期->增量同步 / 缺失->全量构建(仅首次)
+5. 校验风格约束文件 + PRD 模板
+6. 检查周五自动构建状态, 给出本系统的设置命令
+
+After doctor finishes:
+- init_developer auto-registers identity (member.json + signing key)
+- No separate "team.py add" needed anymore
+
+## Incremental Guarantee (为什么不会重头再来)
+
+| 状态 | 行为 |
+|------|------|
+| 本周已 init 过 / 周五任务跑过 | 索引新鲜(≤7天) -> 全部跳过, 秒级完成 |
+| 周五任务没跑/失效 | 索引过期 -> git diff 增量更新, 只处理变更文件 |
+
+## 🔗 平台项目绑定（60 人各用各的项目）
+
+**每个开发者绑定自己的项目。** `/wl-init` 时选择 → 拉 token → 写 mcp_config.json。
+**切换项目 = 重跑 `/wl-init` 选另一个。** 60 人各自选自己的项目，token 绑定到项目，知识层自动隔离。
+
+### 已绑定？（探测多宿主路径）
+```bash
+grep -l WLKJ_PROJECT_ID "$R/.qoder/mcp_config.json" 2>/dev/null && echo "已绑定" || echo "未绑定"
+```
+
+### 未绑定或要切换？一行命令：
+```bash
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" switch-project
+```
+脚本会：
+1. 问邮箱+密码（或用 --email/--pw 参数）
+2. 连平台 `POST /api/auth/bind` 拉项目列表
+3. 列出你的所有项目，选一个
+4. 自动写 mcp_config.json（含该项目的 token + project_id）
+
+非交互模式（CI/自动化）：
+```bash
+$PY "$R/.qoder/scripts/orchestration/wlkj.py" switch-project --email a@b.c --pw xxx --project-uuid <UUID>
+```
+
+**之后所有命令自动用该项目的知识层、token、回流地址。不同人选不同项目 = 完全隔离。**
+| 全新机器 | 克隆仓库 + 全量构建一次, 之后永远增量 |
+| 团队其他人已更新图谱 | team_sync pull 直接拿到, 本机不用构建 |
+
+## .developer File Format (MANDATORY)
+
+ALWAYS write `.qoder/.developer` in key=value format:
+```
+name=小王
+role=pm
+initialized_at=2026-06-12T10:00:00
+```
+Do NOT use `name: value` style. (Parsers accept both for legacy files,
+but new writes must use `=`.)
+
+## Git Author Check
+
+The doctor reports if `git config user.name` differs from the developer
+name (it breaks /wl-report's commit statistics). If the user agrees,
+run: `git config user.name {name}`. Do not change it without confirmation.
+
+## Status Display
+After any operation, show:
+```
+Developer: 小王 (pm)
+Team: 3 members (1 PM, 2 Dev)
+Active tasks: 2 (1 in progress, 1 draft)
+知识图谱: 2 天前更新 (新鲜)
+```
+
+## Safety Rules
+- NEVER delete workspace/ content
+- NEVER overwrite member.json or task.json
+- Full index build ONLY when index is completely missing (doctor handles this)
+
+## 产品常踩的坑（遇到时这样解释，别让产品卡住）
+
+| 现象 | 原因 | 怎么说 / 怎么办 |
+|------|------|----------------|
+| `/wl-init --fix` 卡在第 4 项几分钟 | 正在 clone 大源码仓库（fywl-ics 8973 文件） | 告诉用户"首次克隆大仓库要几分钟，属正常，耐心等"。clone 失败（网络/权限）只影响"搜索真实代码"，本地 PRD/任务/报告不受影响 |
+| 搜代码总返回 0 结果 / 生成原型字段全空 | `config.yaml` 的 `platforms.{xx}.project` 写的项目名在 `data/code/` 下不存在（管理员改了 git_sync URL 忘改 platforms） | doctor 第 4 项会报 `platforms.X.project = '...' 但无此目录`。让管理员核对 config.yaml 的 platforms 映射 |
+| `git user.name` 与开发者名不一致警告 | 影响后续 /wl-report 统计 + push 门禁 | doctor 已自动用 `--fix` 修正本仓库 git config。用户未带 `--fix` 时提示重跑 |
+| 没装 git | doctor 第 1 项报 WARN | 不阻塞：本地 PRD/搜索/任务/报告仍可用，只有团队同步/克隆禁用 |
+| 搜出来的代码是旧的 | 知识图谱 >7 天未更新 | doctor 第 5 项会增量同步，`--fix` 自动跑 |

package/templates/qoder/commands/wl-search.md

@@ -213,11 +213,3 @@ $PY "$R/.qoder/scripts/orchestration/wlkj.py" kg grep-text 车辆不存在 --ext
 - `/wl-search t_quality_case 表结构` → 先 `list_envs()` 问环境 → `query_schema`
 - `/wl-search 资产管理功能画像` → `cap.mcp.call("feature_overview", {"feature": "资产管理"})`
 - `/wl-search 车辆不存在报错从哪来` → `wlkj.py kg grep-text 车辆不存在 --ext java`
-
-
-## 🚨 接地铁律（防幻觉/保真，Qoder AI 必须遵守）
-
-1. **溯源**：引用代码符号/表名/接口用**真实原名**（如 `CostApplyController`、`base_asset`），非中文描述——只引 MCP 工具（rag_search/schema_link/context_360/get_impact 等）召回的真实符号，提升可溯源性
-2. **禁编**：不编造未在召回里出现的类名/表名/字段/接口；召回不足时标"待确认（知识层未召回）"，**诚实优于编造**
-3. **接地（数据表）**：涉及数据表/字段时，先调 MCP `schema_link`/`query_schema` 取真表真列；未召回真表禁编 t_xxx 表名+字段充数
-4. **完整**：产物详尽展开（每节实质内容，不一行带过）

package/templates/qoder/commands/wl-task.md

@@ -617,11 +617,3 @@ prd ──create(带REQ-ID)──→ task ──start──→ code/test ──f
 ```
 
 > 完整执行规则见 `.qoder/skills/wl-task/SKILL.md`（Quest/QoderWork 自然语言入口）。
-
-
-## 🚨 接地铁律（防幻觉/保真，Qoder AI 必须遵守）
-
-1. **溯源**：引用代码符号/表名/接口用**真实原名**（如 `CostApplyController`、`base_asset`），非中文描述——只引 MCP 工具（rag_search/schema_link/context_360/get_impact 等）召回的真实符号，提升可溯源性
-2. **禁编**：不编造未在召回里出现的类名/表名/字段/接口；召回不足时标"待确认（知识层未召回）"，**诚实优于编造**
-3. **接地（数据表）**：涉及数据表/字段时，先调 MCP `schema_link`/`query_schema` 取真表真列；未召回真表禁编 t_xxx 表名+字段充数
-4. **完整**：产物详尽展开（每节实质内容，不一行带过）

package/templates/qoder/commands/wl-test.md

@@ -154,11 +154,3 @@ JUnit 测试（Mock + MockMvc，Given-When-Then）→ 输出 `tests/{package}/{C
 ## 报告
 - quick：用例表 + 执行结果（pass/fail），全过建议继续别的，失败列原因
 - browser：同上 + 建议修复重跑或 `/wl-commit`
-
-
-## 🚨 接地铁律（防幻觉/保真，Qoder AI 必须遵守）
-
-1. **溯源**：引用代码符号/表名/接口用**真实原名**（如 `CostApplyController`、`base_asset`），非中文描述——只引 MCP 工具（rag_search/schema_link/context_360/get_impact 等）召回的真实符号，提升可溯源性
-2. **禁编**：不编造未在召回里出现的类名/表名/字段/接口；召回不足时标"待确认（知识层未召回）"，**诚实优于编造**
-3. **接地（数据表）**：涉及数据表/字段时，先调 MCP `schema_link`/`query_schema` 取真表真列；未召回真表禁编 t_xxx 表名+字段充数
-4. **完整**：产物详尽展开（每节实质内容，不一行带过）

package/templates/qoder/config.yaml

@@ -122,9 +122,8 @@ autotest:
 # setup.py init 时会交互式配置 git remote add origin <url>。
 # 不配也能本地工作, 但 push/同步功能不可用。
 team_remote:
-  # url: 团队 git 地址(留空则 setup.py 会问; 填了团队所有人 init 自动用)。注意:不要在 url: 同行写中文注释,setup.py 会把注释当 url
-  url: ""
-  branch: master
+  url: ""  # 留空则 setup.py 会问; 填了团队所有人 init 时自动用这个地址
+  branch: master  # 团队主分支
 
 # ── Git Sync (Weekly) ──
 # 每个项目在 data/code/ 下有自己的 git 仓库

package/templates/qoder/contracts/insight.md

@@ -1,55 +1,55 @@
-# 模块契约：insight（需求探索）
-
-> 需求上游探索站。在写 PRD 之前把"该做什么、为什么做"想清楚。
-> 四模式：clarify（默认，产品听不懂时对焦）/ discover（发现机会）/ research（调研竞品）/ plan（规划 roadmap）。
-> 与 prd 的分工：insight 想清楚方向，prd 落地怎么做。
-
----
-
-## Input（吃什么）
-
-| 优先级 | 输入 | 怎么用 |
-|--------|------|--------|
-| **完整** | 一个模糊需求/产品想法 | 先 clarify 对焦，再按需 discover/research/plan |
-| 参考 | 现状代码/业务 | `context_pack` / `feature_overview` 锚定现状，禁止编造 |
-| 参考 | 竞品/外部信息 | research 模式走 WebSearch + 多 agent 调研 |
-
-**第一性原理**：看未来，不编造。结论必须锚定现状（context_pack）。
-
----
-
-## Output（吐什么）
-
-### 探索产物
-
-```
-路径：data/docs/drafts/
-内含（按模式产出）：
-  insight-plan-{topic}-{date}.md      ← plan 模式：OST/Gap 分析 + MVP + Roadmap
-  research-agent-{N}-{视角}.md        ← research 模式：多视角调研中间产物
-  insight-research-{topic}-{date}.md  ← research 模式：汇总报告
-  clarify-prototype-*.html            ← clarify 模式：帮产品理解的原型（可选）
-```
-
-### 核心方法
-
-- **OST**（Objective-Strategy-Tactic）：目标→策略→战术拆解
-- **JTBD**（Jobs-to-be-done）：用户要完成的"任务"
-- **Gap 分析**：现状 vs 目标的差距 → 机会
-
----
-
-## 校验（合格标准）
-
-- [ ] 结论锚定现状（引用了 context_pack / 真实代码），非空中楼阁
-- [ ] 全中文输出（语言锁）
-- [ ] 有明确"转 PRD"或"放弃"的建议，不悬空
-- [ ] research 模式：调研有来源，不是泛泛而谈
-
----
-
-## 不做（边界）
-
-- 不写实现级 PRD（那是 prd 模块的活）
-- 不直接改代码（那是 code 模块的活）
-- discover/research 是辅助决策，**最终是否落地由人决定**
+# 模块契约：insight（需求探索）
+
+> 需求上游探索站。在写 PRD 之前把"该做什么、为什么做"想清楚。
+> 四模式：clarify（默认，产品听不懂时对焦）/ discover（发现机会）/ research（调研竞品）/ plan（规划 roadmap）。
+> 与 prd 的分工：insight 想清楚方向，prd 落地怎么做。
+
+---
+
+## Input（吃什么）
+
+| 优先级 | 输入 | 怎么用 |
+|--------|------|--------|
+| **完整** | 一个模糊需求/产品想法 | 先 clarify 对焦，再按需 discover/research/plan |
+| 参考 | 现状代码/业务 | `context_pack` / `feature_overview` 锚定现状，禁止编造 |
+| 参考 | 竞品/外部信息 | research 模式走 WebSearch + 多 agent 调研 |
+
+**第一性原理**：看未来，不编造。结论必须锚定现状（context_pack）。
+
+---
+
+## Output（吐什么）
+
+### 探索产物
+
+```
+路径：data/docs/drafts/
+内含（按模式产出）：
+  insight-plan-{topic}-{date}.md      ← plan 模式：OST/Gap 分析 + MVP + Roadmap
+  research-agent-{N}-{视角}.md        ← research 模式：多视角调研中间产物
+  insight-research-{topic}-{date}.md  ← research 模式：汇总报告
+  clarify-prototype-*.html            ← clarify 模式：帮产品理解的原型（可选）
+```
+
+### 核心方法
+
+- **OST**（Objective-Strategy-Tactic）：目标→策略→战术拆解
+- **JTBD**（Jobs-to-be-done）：用户要完成的"任务"
+- **Gap 分析**：现状 vs 目标的差距 → 机会
+
+---
+
+## 校验（合格标准）
+
+- [ ] 结论锚定现状（引用了 context_pack / 真实代码），非空中楼阁
+- [ ] 全中文输出（语言锁）
+- [ ] 有明确"转 PRD"或"放弃"的建议，不悬空
+- [ ] research 模式：调研有来源，不是泛泛而谈
+
+---
+
+## 不做（边界）
+
+- 不写实现级 PRD（那是 prd 模块的活）
+- 不直接改代码（那是 code 模块的活）
+- discover/research 是辅助决策，**最终是否落地由人决定**