SuperAPI AI 工具集

book-writing-workspace

写作与研究

查看项目

更新于 10-15 16:46

技能介绍

用途:面向技术书籍写作与既有原稿仓库的评估与标准化,覆盖原稿结构、写作智能体、说明文档、评审规则,可选支持 Markdown→Re:VIEW→PDF。

主要能力:确认正文位于 sections/ 且每节一个文件;大纲与最终稿分离;章节引言文件使用 kebab-case 命名(如 00-introduction/00-introduction.md);定位读者画像 SSOT(新工作区用 docs/reader-personas.md 定义主要画像、次要画像、先备知识与完成目标);规范章节/小节布局、写作规则、评审流程与页数分配;运行写作与评审循环直至 P1/P2 问题解决;对照读者画像与预期成果逐章评审;核对字数目标与来源可信度;测量构建页数而非仅凭字符估算判断页数超支;逐条处理外部议题、PR 与出版商校样意见;仅在需要可复现输出时启用 Re:VIEW/PDF;交付前冻结候选版本并运行发布就绪门禁。

使用方式:新建工作区用 python scripts/setup_workspace.py --name "project-name" --title "Book Title" --path "<parent-dir>" --chapters 8,仅在需要 Re:VIEW/PDF 时加 --with-review;随后定制 docs/reader-personas.md、docs/page-allocation.md、docs/schedule.md、.github/copilot-instructions.md。默认 1 文件 = 1 小节,章节引言与小节文件并列。智能体默认含 @writing、@writing-reviewer,加 --with-review 时含 @converter。依赖 Python 3.8+、Git 必需,Docker 仅 Re:VIEW PDF 构建可选。

限制:Git 工作流因项目而异,本技能不提供通用提交/推送提示。作者简介缺失细节不得编造,临时代文需跟踪至确认。字符数估算偏高,作者侧构建页数不等于出版社印刷页数。具体命令、依赖版本与格式化规则应保留在生成的工作区中。官方文本暂未提供。