使用说明
研究管道模板
这是一个独立的、GitHub就绪的模板,用于NotebookLM MCP研究到实现管道。
包含
.agents/rules/generic_workspace_rules.md.agents/workflows/generic/--Runbook、注册表、NLM约定.github/prompts/generic-step0-nlm-setup通过generic-step5scripts/pipeline_gate_check.sh,bootstrap_domain.sh,setup.shtests/run_smoke_tests.sh.github/workflows/pipeline-gates.yml,link-validation.ymldocs/--管道图、MCP布线、NotebookLM集成指南examples/toy_topic/
快速开始
bash scripts/setup.sh # first-time setup: permissions + optional bootstrap
- 打开
.agents/workflows/generic/README.md - 应用
.agents/workflows/generic/copilot_system_prompt.md - 使用
/generic-step0-nlm-setup创建或链接您的NotebookLM笔记本 - 跟随
generic-step1→generic-step5斜线按顺序提示 - 跟踪中的审批状态
research/<topic_slug>/approval_registry.md
闸门命令
- scripts/pipeline_gate_check.sh预实现<topic_slug>
- scripts/pipeline_gate_check.sh预完成<topic_slug>
- 可选显式路径:scripts/pipeline_gate_check.sh预实现<topic_slug>研究/<topic_silug>/approval_registry.md
MCP类型和角色
| MCP/型号 | 工具名称 | 角色 | 不适用 |
|---|---|---|---|
| 笔记本LM MCP | mcp_notebooklm_* |
研究基础、源代码综合、设计结构、故障分析 | 代码生成、代码修改 |
| 顺序思维MCP | mcp_sequentialthi_sequentialthinking |
歧义消解、多候选比较、决策轨迹构建 | 真值存储来源 |
| 个人DeepSeek编码器33b | mcp_personaldeeps_* (Ollama本地) |
代码生成、调试、重构——通过本地Ollama完全离线运行 | 架构重新设计,绕过大门 |
| 双子座 (通过Copilt/neneneba API) | GitHub Copilot Chat | 常规推理辅助、快速问答、文档审核 | 取代设计决策的顺序思维 |
布线规则
- 研究知识→ 笔记本LM MCP 首先,总是
- 设计模糊/候选人比较→ 顺序思维MCP 在任何规格之前
- 代码任务(已批准的规范存在)→ 个人DeepSeek编码器33b 首选(离线,无数据泄漏)
- 双子座→ 仅作补充;从来不是架构的主要决策引擎
工具关系
- 双子座→ 笔记本LM→ 副驾驶 (体系结构无损传递路径):将Gemini设计的体系结构存储为NotebookLM源→Copilot查询为NLM MCP=歪曲、无缩写接收。将Gemini输出直接粘贴到Copilot中会导致上下文相关的扭曲。
- NotebookLM=无损中继存储:Gemini(设计)+论文/参考资料(研究)全部作为源存储在NLM中。之后的所有步骤都只引用NLM查询。
- 副驾驶→ 深度求索:Copilot=协调器,DeepSeek=代码执行器。必须只提供经批准的规格。禁止重新定义体系结构。
- 完整关系图:
docs/mcp_routing.md
持续集成
- 管道闸门+烟雾测试:
.github/workflows/pipeline-gates.yml--运行在PR和workflow_dispatch - 链接验证:
.github/workflows/link-validation.yml--检查每次推送时是否存在所有关键文件路径main
存储库元文件
- 许可证
- 贡献.md
- 代码_OF_CONDUCT.md
- 安全.md
运营文档
- 发布清单:
RELEASE_CHECKLIST.md - 常见问题:
FAQ.md - 变更日志:
CHANGELOG.md - 当前版本:
VERSION(默认值0.1.0)
5分钟演示
- 指南:
examples/toy_topic/README.md - 样本行:
examples/toy_topic/approval_registry.sample.md
域引导(研究+开发)
自动创建主题专用文件夹和规则映射:
- scripts/bootstrap_domain.sh<topic_slug>
- 示例:scripts/bootstrap_domain.sh vision_ammonly
生成的输出:
research/和development/文件夹树.agents/rules/<topic>_workspace_rules.md.agents/workflows/generic/<topic>_folder_rule_map.md- NotebookLM笔记本注册提示(创建新的或现有链接)
NotebookLM集成
- 按主题创建或链接笔记本:
docs/notebooklm_integration.md - 源命名约定:
<topic>_<stage>_<type>_<YYYYMMDD> - 笔记本注册表:
.agents/workflows/generic/notebooklm_notebook_registry.md - 源约定规则:
.agents/workflows/generic/notebooklm_source_conventions.md
文档
- 管道流程图(美人鱼):
docs/pipeline_diagram.md - MCP路由决策树:
docs/mcp_routing.md - NotebookLM完整指南:
docs/notebooklm_integration.md
备注
- 替换
<OWNER>/<REPO>在创建GitHub存储库后,在徽章URL中。 - 推荐的第一个标签:
v0.1.0
