SuperAPI AI 工具集

draft-marker-discipline

通用与其它

查看项目

更新于 10-15 17:28

技能介绍

用途:当手稿由多人、多会话或智能体分次撰写时,把未决问题留在源文件里而非聊天或独立清单中,使其随文本保存、可计数、可审计。

主要能力:定义四类标记——\TODO(红色,仅限事实或来源问题)、\note(蓝色,面向作者的编辑意见)、\directive(方框,必须修改的内容及原因)、\superseded(灰色,被冻结决定替换但保留的文本);四者均可通过草稿模式开关隐藏,便于输出干净副本。按解决途径而非主题对 TODO 分类:A 公开检索、B 付费或受限文本、C 团队或作者决定、D 专有数据、E 证据不存在(应写明估计及其来源)。

使用方式:统计时报告可执行数量而非原始 grep 数量,并附上命令;字数统计须先剥离图表环境与图注、四类标记、注释行,再用 detex 而非正则,技能附带 scripts/prose_wordcount.py,需 detex(Debian/Ubuntu 为 texlive-binextra),示例:python3 ~/.claude/skills/draft-marker-discipline/scripts/prose_wordcount.py --sections paper/sections --order 01-intro,02-methods,03-results。剥离宏须用花括号匹配而非惰性正则,嵌套花括号会导致构建失败;脚本化替换须断言命中次数,零命中视为错误。归档原则:记录“为何不可用”的材料留在工作树,不可用材料本身移入 git 历史,并写明恢复命令。

适用场景:跨会话撰写、批量处理未决标记、引用手稿长度、移除被取代材料、跨多文件脚本化编辑。

限制:不用于判断来源是否支持某主张(属 claim-source-verification),也不用于重构不稳定的论证(属 manuscript-optimizer)。其余细节暂未提供。