dr-claw 1.1.2

package/server/taskmaster-templates/README.md

@@ -0,0 +1,150 @@
+# TaskMaster Template Schema
+
+This directory contains JSON templates used by the Pipeline Board.
+
+Each template serves two purposes:
+
+1. Define the web form fields users fill in (`metaFields`, `sectionFields`).
+2. Define how tasks are generated from `research_brief.json` (`pipeline.stages.*.task_blueprints`).
+
+## How Templates Are Used
+
+When a user applies a template:
+
+1. Backend creates `.pipeline/docs/research_brief.json` using the selected template.
+2. User-provided form values are mapped into JSON paths (for example `sections.ideation.problem_framing`).
+3. Backend parses that brief and generates `.pipeline/tasks/tasks.json` from `pipeline.stages`.
+
+## Required Top-Level Fields
+
+Each template JSON should include:
+
+- `id`: Stable template identifier.
+- `name`: Human-readable template name shown in UI.
+- `description`: Short UI description.
+- `domain`: Logical grouping (for filtering).
+- `category`: Usually same as domain.
+- `format`: Currently `research-brief-json`.
+- `fileName`: Usually `research_brief.json`.
+- `metaFields`: Array of meta form field definitions.
+- `sectionFields`: Form field definitions grouped by `survey`, `ideation`, `experiment`, `publication`, `promotion`.
+- `pipeline`: Task generation blueprint (stage requirements, quality gates, and task blueprints).
+
+## Field Definition Schema
+
+Fields inside `metaFields` and `sectionFields.*` use:
+
+- `key`: Local field key.
+- `label`: UI label.
+- `path`: Dot-path written into the brief JSON.
+- `placeholder`: Optional UI hint text.
+- `type`: Optional, use `"array"` for multi-line list input.
+
+For `type: "array"`, each input line becomes one array item.
+
+## Pipeline Schema
+
+`pipeline` drives task generation. Typical shape:
+
+- `version`: Pipeline schema version.
+- `mode`: Optional mode marker (for example `"idea"`).
+- `stages`: Object with keys:
+  - `survey`
+  - `ideation`
+  - `experiment`
+  - `publication`
+  - `promotion`
+
+Each stage may define:
+
+- `required_elements`: JSON paths that should exist in the brief.
+- `optional_elements`: Additional paths for guidance.
+- `quality_gate`: Checklist items.
+- `task_blueprints`: Ordered task definitions used to build `tasks.json`.
+- `recommended_skills`: Suggested skills for that stage.
+
+## Stage-to-Skills Mapping
+
+Current backend stage skill map (also used as fallback when a task does not provide explicit `recommended_skills`):
+
+| Stage | Base Skills | Type-Specific Hints |
+|---|---|---|
+| `survey` | `inno-deep-research`, `academic-researcher`, `dataset-discovery` | `exploration` -> `inno-deep-research`, `academic-researcher`, `dataset-discovery`; `analysis` -> `inno-deep-research`, `academic-researcher` |
+| `ideation` | `inno-pipeline-planner`, `inno-idea-generation`, `inno-prepare-resources` | `analysis` -> `inno-idea-generation`, `academic-researcher`; `exploration` -> `inno-idea-generation`, `inno-code-survey` |
+| `experiment` | `inno-code-survey`, `inno-experiment-dev`, `inno-experiment-analysis` | `implementation` -> `inno-experiment-dev`, `analysis` -> `inno-experiment-analysis`, `exploration` -> `inno-code-survey` |
+| `publication` | `inno-paper-writing`, `inno-reference-audit`, `inno-rclone-to-overleaf` | `writing` -> `inno-paper-writing`, `analysis` -> `inno-reference-audit` |
+| `promotion` | `making-academic-presentations` | `scripting`/`rendering`/`narration`/`delivery` -> `making-academic-presentations` |
+
+Recommendation priority for each task:
+
+1. Stage-level `recommended_skills`
+2. Stage map base skills
+3. Stage map task-type skills
+4. Task blueprint `recommended_skills`
+
+## Task Blueprint Schema
+
+Each item in `task_blueprints` supports:
+
+- `id`: Stable blueprint id.
+- `title`: Task title shown in UI.
+- `description`: Task description.
+- `taskType`: Suggested type (for example `analysis`, `implementation`, `writing`, `exploration`, `scripting`, `rendering`, `narration`, `delivery`).
+- `priority`: Optional (`low`, `medium`, `high`).
+- `dependencies`: Optional array of task IDs.
+- `inputsNeeded`: Optional array of required JSON paths or inputs.
+- `recommended_skills`: Optional per-task skills.
+- `nextActionPrompt`: Optional prompt used by chat handoff.
+
+## Minimal Template Example
+
+```json
+{
+  "id": "example-template",
+  "name": "Example Template",
+  "description": "Demo template",
+  "domain": "ai-research",
+  "category": "ai-research",
+  "format": "research-brief-json",
+  "fileName": "research_brief.json",
+  "metaFields": [
+    { "key": "title", "label": "Title", "path": "meta.title" }
+  ],
+  "sectionFields": {
+    "ideation": [
+      { "key": "problem_framing", "label": "Problem Framing", "path": "sections.ideation.problem_framing" }
+    ],
+    "experiment": [],
+    "publication": [],
+    "promotion": []
+  },
+  "pipeline": {
+    "version": "1.1",
+    "mode": "idea",
+    "stages": {
+      "ideation": {
+        "required_elements": ["sections.ideation.problem_framing"],
+        "quality_gate": ["Problem framing is specific"],
+        "task_blueprints": [
+          {
+            "id": "define_problem_scope",
+            "title": "Define problem scope",
+            "description": "Clarify scope, assumptions, and constraints.",
+            "taskType": "analysis"
+          }
+        ],
+        "recommended_skills": ["inno-idea-generation"]
+      },
+      "experiment": { "task_blueprints": [] },
+      "publication": { "task_blueprints": [] },
+      "promotion": { "task_blueprints": [] }
+    }
+  }
+}
+```
+
+## Notes
+
+- Keep `id` stable once released (it may be used in saved briefs).
+- Keep `path` values aligned with the `research_brief.json` shape.
+- Task order in `task_blueprints` matters; it affects generated task order.

package/server/taskmaster-templates/README.zh-CN.md

@@ -0,0 +1,150 @@
+# TaskMaster 模板结构说明
+
+本目录存放 Pipeline Board 使用的 JSON 模板。
+
+每个模板有两个职责：
+
+1. 定义 Web 表单字段（`metaFields`、`sectionFields`）。
+2. 定义从 `research_brief.json` 生成任务的规则（`pipeline.stages.*.task_blueprints`）。
+
+## 模板如何生效
+
+当用户应用模板时：
+
+1. 后端基于模板生成 `.pipeline/docs/research_brief.json`。
+2. 前端填写的字段按 `path` 回填到该 JSON（例如 `sections.ideation.problem_framing`）。
+3. 后端解析 brief，并根据 `pipeline.stages` 生成 `.pipeline/tasks/tasks.json`。
+
+## 顶层字段（建议）
+
+每个模板 JSON 建议包含：
+
+- `id`：模板唯一标识（稳定）。
+- `name`：UI 展示名称。
+- `description`：模板简介。
+- `domain`：领域分组（用于筛选）。
+- `category`：分类（通常与 domain 一致）。
+- `format`：当前为 `research-brief-json`。
+- `fileName`：通常为 `research_brief.json`。
+- `metaFields`：Meta 区域表单定义。
+- `sectionFields`：分阶段表单定义（`survey/ideation/experiment/publication/promotion`）。
+- `pipeline`：任务生成蓝图。
+
+## 表单字段定义
+
+`metaFields` 和 `sectionFields.*` 的字段结构：
+
+- `key`：字段键名。
+- `label`：UI 显示名称。
+- `path`：写入 brief 的点路径。
+- `placeholder`：输入提示（可选）。
+- `type`：可选，`"array"` 表示多行数组输入。
+
+当 `type: "array"` 时，前端每一行会转为数组一项。
+
+## Pipeline 结构
+
+`pipeline` 决定任务生成逻辑，典型结构：
+
+- `version`：pipeline 版本号。
+- `mode`：模式标记（如 `"idea"`）。
+- `stages`：阶段对象，通常包含：
+  - `survey`
+  - `ideation`
+  - `experiment`
+  - `publication`
+  - `promotion`
+
+每个阶段可定义：
+
+- `required_elements`：该阶段关键字段路径。
+- `optional_elements`：可选字段路径。
+- `quality_gate`：阶段质量门检查项。
+- `task_blueprints`：任务蓝图（按顺序生成任务）。
+- `recommended_skills`：建议技能列表。
+
+## 阶段 Skills 映射表
+
+当前后端使用的阶段技能映射（当任务没有显式 `recommended_skills` 时会作为兜底）：
+
+| 阶段 | 基础技能 | 按任务类型补充 |
+|---|---|---|
+| `survey` | `inno-deep-research`, `academic-researcher`, `dataset-discovery` | `exploration` -> `inno-deep-research`、`academic-researcher`、`dataset-discovery`，`analysis` -> `inno-deep-research`、`academic-researcher` |
+| `ideation` | `inno-pipeline-planner`, `inno-idea-generation`, `inno-prepare-resources` | `analysis` -> `inno-idea-generation`、`academic-researcher`，`exploration` -> `inno-idea-generation`、`inno-code-survey` |
+| `experiment` | `inno-code-survey`, `inno-experiment-dev`, `inno-experiment-analysis` | `implementation` -> `inno-experiment-dev`，`analysis` -> `inno-experiment-analysis`，`exploration` -> `inno-code-survey` |
+| `publication` | `inno-paper-writing`, `inno-reference-audit`, `inno-rclone-to-overleaf` | `writing` -> `inno-paper-writing`，`analysis` -> `inno-reference-audit` |
+| `promotion` | `making-academic-presentations` | `scripting`/`rendering`/`narration`/`delivery` -> `making-academic-presentations` |
+
+每个任务推荐技能的合成优先级：
+
+1. 阶段配置 `recommended_skills`
+2. 阶段映射基础技能
+3. 阶段映射的任务类型技能
+4. 任务蓝图自身 `recommended_skills`
+
+## task_blueprints 字段
+
+`task_blueprints` 中每个任务支持：
+
+- `id`：蓝图任务 ID（稳定）。
+- `title`：任务标题。
+- `description`：任务描述。
+- `taskType`：任务类型（如 `analysis`、`implementation`、`writing`、`exploration`、`scripting`、`rendering`、`narration`、`delivery`）。
+- `priority`：可选，`low/medium/high`。
+- `dependencies`：可选，依赖任务 ID 数组。
+- `inputsNeeded`：可选，输入依赖路径或条件。
+- `recommended_skills`：可选，任务级技能建议。
+- `nextActionPrompt`：可选，Chat 接力提示词。
+
+## 最小模板示例
+
+```json
+{
+  "id": "example-template",
+  "name": "示例模板",
+  "description": "演示模板",
+  "domain": "ai-research",
+  "category": "ai-research",
+  "format": "research-brief-json",
+  "fileName": "research_brief.json",
+  "metaFields": [
+    { "key": "title", "label": "标题", "path": "meta.title" }
+  ],
+  "sectionFields": {
+    "ideation": [
+      { "key": "problem_framing", "label": "问题界定", "path": "sections.ideation.problem_framing" }
+    ],
+    "experiment": [],
+    "publication": [],
+    "promotion": []
+  },
+  "pipeline": {
+    "version": "1.1",
+    "mode": "idea",
+    "stages": {
+      "ideation": {
+        "required_elements": ["sections.ideation.problem_framing"],
+        "quality_gate": ["问题界定足够具体"],
+        "task_blueprints": [
+          {
+            "id": "define_problem_scope",
+            "title": "定义问题范围",
+            "description": "明确边界、假设与约束。",
+            "taskType": "analysis"
+          }
+        ],
+        "recommended_skills": ["inno-idea-generation"]
+      },
+      "experiment": { "task_blueprints": [] },
+      "publication": { "task_blueprints": [] },
+      "promotion": { "task_blueprints": [] }
+    }
+  }
+}
+```
+
+## 实践建议
+
+- 模板 `id` 一旦发布尽量保持不变（可能已被历史 brief 引用）。
+- `path` 必须与 `research_brief.json` 的结构一致。
+- `task_blueprints` 顺序会直接影响 `tasks.json` 的生成顺序。

package/server/taskmaster-templates/ai-research-dataset.json

@@ -0,0 +1,230 @@
+{
+  "id": "ai-research-dataset",
+  "name": "AI Research - Dataset-Centric",
+  "description": "For dataset construction, benchmark creation, and data-centric AI studies",
+  "domain": "ai-research",
+  "category": "ai-research",
+  "format": "research-brief-json",
+  "fileName": "research_brief.json",
+  "metaFields": [
+    { "key": "title", "label": "Paper Title", "path": "meta.title", "placeholder": "Optional project title" },
+    { "key": "lead_author", "label": "Lead Author", "path": "meta.lead_author", "placeholder": "Optional lead author" },
+    { "key": "target_venue", "label": "Target Venue", "path": "meta.target_venue", "placeholder": "Optional venue" }
+  ],
+  "sectionFields": {
+    "survey": [
+      { "key": "literature_scope", "label": "Literature Scope", "path": "sections.survey.literature_scope", "placeholder": "Existing datasets, benchmarks, and related survey boundary" },
+      { "key": "key_references", "label": "Key References", "path": "sections.survey.key_references", "type": "array", "placeholder": "One dataset or paper per line" },
+      { "key": "synthesis_summary", "label": "Synthesis Summary", "path": "sections.survey.synthesis_summary", "placeholder": "What existing resources cover well vs poorly" },
+      { "key": "open_gaps", "label": "Open Gaps", "path": "sections.survey.open_gaps", "type": "array", "placeholder": "One unmet need or benchmark gap per line" }
+    ],
+    "ideation": [
+      { "key": "research_goal", "label": "Research Goal", "path": "sections.ideation.research_goal", "placeholder": "What bottleneck does this dataset solve?" },
+      { "key": "problem_framing", "label": "Problem Framing", "path": "sections.ideation.problem_framing", "placeholder": "Define scope, users, and boundaries" },
+      { "key": "evidence_plan", "label": "Evidence Plan", "path": "sections.ideation.evidence_plan", "placeholder": "Key references and gap analysis" },
+      { "key": "success_criteria", "label": "Success Criteria", "path": "sections.ideation.success_criteria", "type": "array", "placeholder": "One criterion per line" }
+    ],
+    "experiment": [
+      { "key": "hypothesis_or_validation_goal", "label": "Validation Goal", "path": "sections.experiment.hypothesis_or_validation_goal", "placeholder": "What should experiments validate?" },
+      { "key": "dataset_or_data_source", "label": "Data Source Plan", "path": "sections.experiment.dataset_or_data_source", "placeholder": "Collection source and protocol" },
+      { "key": "method_or_protocol", "label": "Construction Protocol", "path": "sections.experiment.method_or_protocol", "placeholder": "Annotation, cleaning, governance" },
+      { "key": "evaluation_plan", "label": "Evaluation Plan", "path": "sections.experiment.evaluation_plan", "placeholder": "Metrics, baselines, ablations" }
+    ],
+    "publication": [
+      { "key": "paper_outline", "label": "Paper Outline", "path": "sections.publication.paper_outline", "placeholder": "Dataset story and contribution boundaries" },
+      { "key": "figures_tables_plan", "label": "Figures/Tables Plan", "path": "sections.publication.figures_tables_plan", "placeholder": "Leaderboards, data cards, comparisons" },
+      { "key": "artifact_plan", "label": "Artifact Plan", "path": "sections.publication.artifact_plan", "placeholder": "README, license, release assets" },
+      { "key": "submission_checklist", "label": "Submission Checklist", "path": "sections.publication.submission_checklist", "type": "array", "placeholder": "One item per line" }
+    ],
+    "promotion": [
+      { "key": "slide_outline", "label": "Slide Outline", "path": "sections.promotion.slide_outline", "placeholder": "Dataset pitch or talk outline" },
+      { "key": "deck_style", "label": "Deck Style", "path": "sections.promotion.deck_style", "placeholder": "Visual treatment for examples, tables, and benchmarks" },
+      { "key": "homepage_plan", "label": "Homepage Plan", "path": "sections.promotion.homepage_plan", "placeholder": "Dataset page structure, downloads, leaderboards, and examples" },
+      { "key": "tts_config", "label": "TTS Config", "path": "sections.promotion.tts_config", "placeholder": "Voice and narration settings for demo assets" },
+      { "key": "video_assembly_plan", "label": "Video Assembly Plan", "path": "sections.promotion.video_assembly_plan", "placeholder": "How to combine slides, audio, demos, and walkthrough clips" }
+    ]
+  },
+  "pipeline": {
+    "version": "1.1",
+    "mode": "idea",
+    "stages": {
+      "survey": {
+        "required_elements": [
+          "sections.survey.literature_scope",
+          "sections.survey.synthesis_summary"
+        ],
+        "optional_elements": [
+          "sections.survey.key_references",
+          "sections.survey.open_gaps"
+        ],
+        "quality_gate": [
+          "Existing datasets and benchmarks are mapped with explicit scope boundaries",
+          "Open gaps justify why a new dataset or benchmark is needed"
+        ],
+        "task_blueprints": [
+          {
+            "id": "dataset_prior_resource_survey",
+            "title": "Survey prior datasets, benchmarks, and data cards",
+            "description": "Collect the main related datasets and benchmark suites, then compare scope and governance tradeoffs.",
+            "taskType": "exploration",
+            "recommended_skills": ["inno-deep-research", "academic-researcher"]
+          },
+          {
+            "id": "dataset_gap_and_positioning",
+            "title": "Synthesize dataset gaps and positioning",
+            "description": "Explain which data coverage, quality, or evaluation gaps remain unsolved and how this project positions itself.",
+            "taskType": "analysis",
+            "recommended_skills": ["inno-deep-research", "academic-researcher"]
+          }
+        ],
+        "recommended_skills": [
+          "inno-deep-research",
+          "academic-researcher"
+        ]
+      },
+      "ideation": {
+        "required_elements": [
+          "sections.ideation.research_goal",
+          "sections.ideation.problem_framing"
+        ],
+        "optional_elements": [
+          "sections.ideation.evidence_plan",
+          "sections.ideation.success_criteria"
+        ],
+        "quality_gate": [
+          "Dataset scope, target users, and use restrictions are explicit",
+          "Value over existing datasets is articulated"
+        ],
+        "task_blueprints": [
+          {
+            "id": "dataset_problem_and_scope",
+            "title": "Define dataset problem statement and scope boundaries",
+            "description": "Specify target use-cases, inclusion/exclusion scope, and risk boundaries.",
+            "taskType": "analysis",
+            "recommended_skills": ["inno-idea-generation", "academic-researcher"]
+          },
+          {
+            "id": "dataset_schema_and_collection_plan",
+            "title": "Design schema and data collection plan",
+            "description": "Define label schema, sampling strategy, and collection channels.",
+            "taskType": "exploration",
+            "recommended_skills": ["inno-idea-generation", "dataset-discovery"]
+          }
+        ],
+        "recommended_skills": [
+          "inno-pipeline-planner",
+          "inno-idea-generation"
+        ]
+      },
+      "experiment": {
+        "required_elements": [
+          "sections.experiment.hypothesis_or_validation_goal",
+          "sections.experiment.method_or_protocol",
+          "sections.experiment.evaluation_plan"
+        ],
+        "optional_elements": [
+          "sections.experiment.dataset_or_data_source"
+        ],
+        "quality_gate": [
+          "Annotation/cleaning protocol is reproducible",
+          "Benchmark and baseline plan are executable"
+        ],
+        "task_blueprints": [
+          {
+            "id": "dataset_annotation_and_qc_protocol",
+            "title": "Specify annotation, cleaning, and quality-control protocol",
+            "description": "Define annotation guidelines, inter-annotator checks, and curation flow.",
+            "taskType": "implementation",
+            "recommended_skills": ["inno-experiment-dev"]
+          },
+          {
+            "id": "dataset_baseline_and_benchmark_plan",
+            "title": "Run baseline benchmark plan and error analysis",
+            "description": "Establish baseline models/heuristics, evaluate, and summarize failure patterns.",
+            "taskType": "analysis",
+            "recommended_skills": ["inno-experiment-analysis"]
+          }
+        ],
+        "recommended_skills": [
+          "inno-experiment-dev",
+          "inno-experiment-analysis"
+        ]
+      },
+      "publication": {
+        "required_elements": [
+          "sections.publication.paper_outline",
+          "sections.publication.submission_checklist"
+        ],
+        "optional_elements": [
+          "sections.publication.figures_tables_plan",
+          "sections.publication.artifact_plan"
+        ],
+        "quality_gate": [
+          "Data card and governance statements are complete",
+          "Release artifacts and benchmark tables are publication-ready"
+        ],
+        "task_blueprints": [
+          {
+            "id": "dataset_documentation_and_datacard",
+            "title": "Prepare dataset documentation and data card",
+            "description": "Draft dataset statement, bias/safety notes, and intended-use guidance.",
+            "taskType": "writing",
+            "recommended_skills": ["inno-paper-writing"]
+          },
+          {
+            "id": "dataset_release_and_submission_bundle",
+            "title": "Finalize release bundle and submission package",
+            "description": "Assemble benchmark tables, README/license, and supplementary artifacts.",
+            "taskType": "writing",
+            "recommended_skills": ["inno-paper-writing", "inno-reference-audit"]
+          }
+        ],
+        "recommended_skills": [
+          "inno-paper-writing",
+          "inno-reference-audit"
+        ]
+      },
+      "promotion": {
+        "required_elements": [
+          "sections.promotion.slide_outline"
+        ],
+        "optional_elements": [
+          "sections.promotion.deck_style",
+          "sections.promotion.tts_config",
+          "sections.promotion.video_assembly_plan",
+          "sections.promotion.homepage_plan"
+        ],
+        "quality_gate": [
+          "Slides and homepage highlight dataset value, access path, and benchmark evidence",
+          "Delivery plan covers downloads, walkthrough assets, and public-facing explanations"
+        ],
+        "task_blueprints": [
+          {
+            "id": "dataset_promotion_overview_story",
+            "title": "Create dataset overview story for slides and homepage",
+            "description": "Package the dataset motivation, coverage, and benchmark value into a public-facing narrative.",
+            "taskType": "scripting",
+            "recommended_skills": ["making-academic-presentations"]
+          },
+          {
+            "id": "dataset_promotion_assets",
+            "title": "Generate showcase visuals and supporting media assets",
+            "description": "Prepare examples, summary figures, and homepage visuals for dataset promotion.",
+            "taskType": "rendering",
+            "recommended_skills": ["making-academic-presentations"]
+          },
+          {
+            "id": "dataset_promotion_delivery_bundle",
+            "title": "Assemble narration, slide, and homepage delivery bundle",
+            "description": "Produce narration guidance and package assets for talks, demos, and dataset release communication.",
+            "taskType": "delivery",
+            "recommended_skills": ["making-academic-presentations"]
+          }
+        ],
+        "recommended_skills": [
+          "making-academic-presentations"
+        ]
+      }
+    }
+  }
+}