用途:该技能用于指导使用 noweb 系统进行文学编程(literate programming),核心要求是在对 .nw 文件做任何修改前先激活,避免直接编辑导致文学质量不达标。
主要能力:技能内置 references/ 参考文档,覆盖 noweb 命令(tangling、weaving、flags、排错,涉及 notangle、noweave、-R、-L)、测试组织与放置、整体概览与结构图、Git 工作流与 .gitignore、多目录项目与 makefile、项目初始化模板,以及 LaTeX 前言与 PythonTeX/biber 构建注意事项。
使用方式:修改 .nw 文件时先阅读现有结构,按文学编程原则规划——先写解释问题与方案的散文,再设计命名清晰的代码块,最后用 make/notangle 重新生成代码并测试。文档块以 @ 开头,代码块以 <<chunk name>>= 开头,散文中的代码用 [[code]] 引用,块名中的标识符需用 [[...]] 转义。
适用场景:维护或评审 .nw 文件、编写面向维护者或学生的文学程序、组织大型多目录项目。
限制:资料未提供具体安装命令、收费方式或平台支持信息;技能强调文学质量与代码正确性同等重要,若仅代码可运行但文学质量差仍视为任务失败。