@hupan56/wlkj 2.5.0 → 2.7.0

package/templates/root/AGENTS.md

@@ -16,6 +16,8 @@
 
 **DO NOT skip this question. DO NOT auto-detect. ALWAYS ASK.**
 **Wait for user answer before doing ANYTHING else.**
+**DO NOT search/read/analyze in the same turn as asking — the reply MUST end after the question.**
+Asking platform + simultaneously searching code in the same response is a VIOLATION.
 
 ---
 
@@ -38,15 +40,21 @@ Quest 与 QoderWork 没有斜杠命令，AI 必须按下表把用户自然语言
 
 | 用户说什么 | 触发 skill |
 |------------|-----------|
-| "写个需求""生成PRD""做个原型" | prd-generator + prototype-generator |
+| "写个需求""生成PRD""做个原型""新模块" | /wl-prd-full（完整档，正经需求）|
+| "加个字段""加个导出按钮""改下文案""小改动" | /wl-prd-quick（快档，零星需求）|
+| "评审PRD""检查需求文档""PRD质量怎么样""这个PRD合格吗" | /wl-prd-review（评审 PRD 质量）|
+| "录入设计稿""Figma稿录入""把这个设计录入" | wl-design import (design-import) |
+| "按设计出原型""按设计师规范出原型" | wl-design generate (prototype-generator) |
+| "评审原型""设计稿看一下""检查交互稿" | wl-design review (design-review) |
 | "查一下""代码在哪""搜保险""考勤API" | wl-search |
 | "建任务""排优先级""任务做完了" | wl-task |
 | "项目怎么样""进度""健康度" | wl-status |
 | "写日报""周报""我干了啥" | wl-report |
-| "用户反馈""数据怎么样" | wl-insight |
+| "调研""竞品""对标""规划""路线图""接下来做什么""发现个机会""探讨需求" | wl-insight（探索站）|
 | "生成规格""写spec" | spec-generator |
 | "开始写代码""按规格实现" | spec-coder |
-| "写单元测试" | test-generator |
+| "测一下XX支不支持YY""验一下XX能不能""XX功能对不对""跑测试用例""回归测试" | /wl-test（测试工作流, 命令或带验证点的自然语言触发） |
+| "写单元测试""补单测" | /wl-test unit（test-generator） |
 | "评审PRD" | prd-review |
 | "提交代码""commit""推上去" | wl-commit |
 | "初始化""换开发者""环境检查" | wl-init |
@@ -57,7 +65,7 @@ Quest 与 QoderWork 没有斜杠命令，AI 必须按下表把用户自然语言
 ## CRITICAL RULE #3: User NEVER touches git
 
 PMs on this team do not know git. ALL git operations are invisible:
-- After any publish/save action (/wl-prd publish, /wl-task create/finish,
+- After any publish/save action (/wl-prd-full publish, /wl-task create/finish,
   /wl-report save), run: `python .qoder/scripts/team_sync.py push`
 - To get teammates' latest work: `python .qoder/scripts/team_sync.py pull`
 - If team_sync prints SYNC_CONFLICT, YOU (the AI) resolve the conflict
@@ -79,30 +87,40 @@ web/pc/管理端 -> fywl-ui
 app/mobile/h5/移动端 -> Carmg-H5
 ```
 
-## 11 Commands (All prefixed /wl-)
-
-### Pipeline Core
-| Command | Auto | Purpose |
-|---------|------|---------|
-| `/wl-init` | YES | Register/switch developer identity |
-| `/wl-prd` | YES | Generate PRD (ASKS platform first!) |
-| `/wl-spec` | YES | Generate technical Spec from PRD |
-| `/wl-code` | NO | Code implementation (needs confirm) |
-| `/wl-commit` | NO | Git commit + push + sync (needs confirm) |
-
-### Product Management
-| Command | Auto | Purpose |
-|---------|------|---------|
-| `/wl-search` | YES | Search code index (supports Chinese, platform filtering) |
-| `/wl-task` | YES | Task management + RICE prioritization |
-| `/wl-status` | YES | Project status + roadmap + health |
-| `/wl-insight` | YES | Feedback analysis + metrics review |
-
-### Reporting
-| Command | Auto | Purpose |
-|---------|------|---------|
-| `/wl-report` | YES | Generate daily or weekly work report |
-| `/wl-test` | NO | Generate unit tests (needs confirm) |
+## Commands: 7 Core (小而美) + Optional
+
+> 认知面只暴露 7 个核心命令，每个是一道工序站，每个带模式参数。
+> **一个命令当多个用**——记不住参数也没关系，自然语言一样路由。
+> 模块契约（输入/输出/校验）见 `.qoder/contracts/`。
+
+### 7 Core Commands（记住这 7 个就够）
+
+| Command | 工序站 | 模式参数（第一个词路由） | Auto | 背后 skill |
+|---------|--------|------------------------|------|-----------|
+| `/wl-init` | 身份 | （无） | YES | wl-init |
+| `/wl-prd-full` | 需求（完整档） | 支持 `参考:<报告>` 衔接 insight | YES | prd-generator |
+| `/wl-prd-quick` | 需求（小改动） | （无） | YES | prd-generator |
+| `/wl-prd-review` | 需求（评审） | （无） | YES | prd-review |
+| `/wl-design` | 设计 | `import`/`generate`/`review` 或默认(import) | YES | design-import/prototype-generator/design-review |
+| `/wl-task` | 任务 | `create`/`list`/`start`/`finish` | YES | wl-task |
+| `/wl-code` | 编码 | （无，按 spec 实现） | NO | spec-coder |
+| `/wl-test` | 测试 | `quick`/`browser`/`unit` 或默认(quick) | NO | wl-test / test-generator |
+| `/wl-commit` | 提交 | （无） | NO | wl-commit |
+
+### Optional Commands（长大了再开，非执行链路必经）
+
+> 物理上归在 `.qoder/commands/optional/` 子目录（Qoder IDE 会按子目录归类显示），
+> QoderWork 安装脚本已支持递归扫描，4 个照样能装到用户级。
+
+| Command | 用途 | 何时用 |
+|---------|------|--------|
+| `/wl-search` | 代码索引搜索 | 全员工具，按需，非工序站 |
+| `/wl-spec` | PRD→技术规格 | 需求复杂时（小团队可直接 `/wl-code`） |
+| `/wl-status` | 项目健康度/路线图 | 需要 PMO/汇报时 |
+| `/wl-report` | 日报周报 | 需要向上汇报时 |
+| `/wl-insight` | 需求探索/外部调研/未来规划 | 需求方向没定、要做调研或规划时（位于 /wl-prd-full 之前）|
+
+> **新人只需记 7 个核心命令**，能把活从需求干到提交。可选 5 个按场景启用。
 
 ## Knowledge Index
 
@@ -110,6 +128,15 @@ app/mobile/h5/移动端 -> Carmg-H5
 Search: /wl-search <keyword> returns compact results (~200 bytes)
 Weekly sync: python .qoder/scripts/git_sync.py
 
+### MCP Servers (QoderWork / Qoder IDE)
+注册在 `~/.qoderwork/mcp.json`，setup.py 一键配齐：
+- `qoder-knowledge-graph` (stdio) — 本仓库知识图谱，13 个工具 (search_code/api, get_impact, context_360, fill_prototype, get_design_system...)。自动拉起。
+- `playwright` (stdio) — 浏览器自动化，快且稳。自动拉起。
+- `qoder-mysql` (stdio) — 只读查真实数据库结构/数据。自动拉起。
+- `lanhu` (STDIO) — 蓝湖设计稿直读，设计师发链接 AI 提取颜色/尺寸/字体/切图。
+  **STDIO 模式：开 QoderWork 自动起、关自动停**（QoderWork 原生进程管理，无需手动 start）。
+  cookie 按角色隔离（UI 能改稿/PM 只读）：wrapper 读当前 `.developer` → 该角色的 `workspace/members/{dev}/.secrets/lanhu.env`（gitignored）。换角色改 `.developer` + 配该角色 cookie → 重启 QoderWork。首次配置跑 `python .qoder/scripts/setup_lanhu.py`。
+
 ### Style Index (Prototype Reference)
 UI patterns from Vue files: Tables(718), Forms(301), Detail(129), Dashboard(90)
 Top components: Space(583), Modal(270), Select(172), Input(134)
@@ -129,13 +156,22 @@ Prototype templates:
 Prototype output: workspace/members/{dev}/drafts/prototype-{feature}.html
 Style priority: Code > PDF > Default
 
-## Workflow
+## Workflow: 契约网（非强制流水线）
 
-/wl-init -> /wl-prd (ASK PLATFORM!) -> /wl-task -> /wl-spec -> /wl-code -> /wl-test -> /wl-commit -> /wl-report
+模块间**不强制顺序**，靠标准契约文件对接（详见 `.qoder/contracts/`）。
+完整链路**可以**这么走，但任何模块都能独立开机：
 
-## Cross-platform & Qoder Product Family Compatibility
+```
+/wl-init → /wl-prd-full (ASK PLATFORM!) → /wl-design → /wl-task → /wl-code → /wl-test → /wl-commit
+  身份       需求        设计          任务        编码        测试        提交
+```
+
+**独立性**：每个模块认文件不认流程。缺上游 → 手动喂个契约文件，或用自然语言 +
+`context_pack.py` 让 AI 自检索补全（见 `.qoder/contracts/fallback.md`）。
+
+## Qoder 全系列兼容（IDE / Quest / CLI / QoderWork）
 
-This pipeline works on Windows + macOS, across the whole Qoder family.
+This pipeline works on Windows + macOS, across the **whole Qoder family**.
 Each product loads rules from a different carrier — keep them in sync:
 
 | 产品/模式 | 规则载体 | 命令载体 |
@@ -144,7 +180,26 @@ Each product loads rules from a different carrier — keep them in sync:
 | Qoder Quest 模式 | .qoder/rules/ + .qoder/skills/ + .qoder/agents/ | 自然语言 -> skills |
 | Qoder CLI (qodercli) | 本文件 AGENTS.md | 自然语言 -> scripts |
 | QoderWork 桌面 Agent | 安装 .qoder/skills/ 下的技能 | 自然语言 -> skills |
-| Claude Code 等其他工具 | 本文件 AGENTS.md | .qoder/commands/wl-*.md |
+
+> 本流水线聚焦 Qoder 全系列，4 种载体功能等价。知识图谱 13 个能力（影响分析/
+> 覆盖矩阵/功能画像/业务流程/多跳遍历…）通过统一 CLI `python .qoder/scripts/kg.py`
+> 全系列触达；QoderWork 环境也可直接调 MCP 工具。
+
+## QoderWork Integration: Optional Enhancement Only (Progressive Enhancement)
+
+> 🔒 **核心原则：本流水线绝不强依赖 QoderWork。**
+> 团队里有人用 Qoder IDE、有人用 Qoder CLI、有人用 QoderWork —— 必须保证前两者开箱即用、功能完整。
+> QoderWork 的「连接器 / 专家套件 / 定时任务」只能是**可选增强**：有就锦上添花，没有就静默回退，绝不报错、绝不阻塞。
+
+具体落实：
+- **本地数据是唯一事实源**：task.json / git log / drafts / index 永远是真相，连接器只是它的"投影/补充"
+- **增强段统一标记 `🧩 QoderWork 增强（可选）`**：出现在 wl-report / wl-task / wl-status 三个 skill 里，每段都明确写"无连接器则自动回退 + 不影响纯 Qoder 使用"
+- **探测而非假设**：只在运行环境真正提供了「日历/待办/邮件」工具可读时才启用增强；看不到就跳过，补一句 `[xx 未启用：非 QoderWork 或未授权连接器]`
+- 已接入的增强点：
+  - `/wl-report` 读日历补"会议/评审"到日报（补 PM/设计岗无提交的空窗）
+  - `/wl-task` 把任务同步为待办 + finish 后标记完成（本地仍为准）
+  - `/wl-status` 用真实日历节点校准"按时交付""团队同步"两维健康度
+- 未来加任何 QoderWork 增强都必须遵循同样原则：**先保证纯 Qoder 可跑，再叠加可选层。**
 
 - THE rule file: `.qoder/rules/wl-pipeline.md` — 修改流程规则时同步更新它和本文件
 - Quest 修改 agents/skills 后需重启 Quest 窗口/新建对话才能生效（Qoder 已知限制）
@@ -178,5 +233,5 @@ must PASS (>=80%). Metrics definition: data/docs/constitution/eva-metrics.md
 
 | Level | Commands | Auto |
 |-------|---------|------|
-| SAFE | /wl-init, /wl-prd, /wl-search, /wl-task, /wl-spec, /wl-status, /wl-insight, /wl-report | YES |
+| SAFE | /wl-init, /wl-prd-full, /wl-prd-quick, /wl-prd-review, /wl-design, /wl-task, /wl-search, /wl-spec, /wl-status, /wl-insight, /wl-report | YES |
 | DANGEROUS | /wl-code, /wl-test, /wl-commit | NO |

package/templates/root/requirements.txt

@@ -0,0 +1,21 @@
+# QODER Pipeline Python 依赖
+# 安装: pip install -r requirements.txt
+# (或 npx @hupan56/wlkj install-env 自动装)
+
+# ── 核心 (必装, 不装知识图谱/MCP/配置全崩) ──
+duckdb>=1.1.0            # 知识图谱存储 (kg.duckdb / kg_db.duckdb)
+pymysql>=1.1.0           # MySQL 只读 MCP + 数据层图谱构建
+PyYAML>=6.0              # config.yaml / learn / preferences 解析
+requests>=2.28.0         # API 调用 / 通知
+
+# ── 索引构建 (管理员装, 构建代码图谱用) ──
+tree-sitter>=0.21.0      # AST 解析 (扫代码建图谱)
+tree-sitter-typescript>=0.21.0  # Vue/TS 语法解析
+
+# ── 测试 (QA 装, 自动化测试用) ──
+playwright>=1.40.0       # 浏览器自动化测试
+# playwright install      # 装完 pip 包还要跑这句装浏览器
+
+# ── 可选增强 (按需装) ──
+ddddocr>=1.4.7           # 验证码识别 (登录测试用)
+cryptography>=37.0.0     # 飞书集成加密 (用飞书通知才装)