用途:该技能用于为 Smart Setup 生成和维护命令行参考页面,适用于需要记录某个命令、补充缺失的命令页,或按既有规范更新命令文档的场景。
主要能力与信息要求:技能强调不得编造命令行为、选项或描述,需从三类来源收集信息:一是源码,命令声明位于 tms/src/Commands/Commands.<CommandName>.pas,可获取命令名(RegisterCommand 第一个参数)、短描述(第三参数)、长描述(第四参数)、用法行(第五参数)、通过 RegisterOption 或 RegisterUnNamedOption 注册的选项及其名称、短别名、描述与标志(HasValue、Required、AllowMultiple、Hidden),以及 AddCommand 传入的 CommandGroups.* 常量所决定的命令分组;二是命令行输出,运行 tms help <command> 验证选项名与描述;三是实现源码,位于 tms/src/ 下,用于理解复杂行为、边界情况并构造示例。
分组与全局选项:命令分组常量定义在 tms/src/Commands/Commands.CommonOptions.pas,包括 Install(Installing and updating:)、Config(Configuration:)、Status(Informative:)、Diagnosis(Check and Repair:)、Self(Concerning tms tool itself:)。全局选项同样在该文件中注册:-config <file>、-add-config <file>、-verbose、-display-options <options>、-p:<path>=<value>。
工作流:创建新页面时,先收集上述信息,参考 doc/source/reference/ 下 1–2 个已有命令页面以匹配风格与深度,按 references/command-conventions.md 的模板创建 doc/source/reference/tms-<command-name>.md,并在 doc/source/reference/toc.yml 的对应分组位置添加页面;若参考章节为新增,还需更新 doc/source/toc.yml。更新已有页面时,读取现有内容,从源码与 tms help <command> 获取最新信息,按既有结构更新相关章节。索引页 doc/source/reference/index.md 按 tms 输出的分组与顺序列出全部命令,分组顺序由 common/src/UCommandLine.pas 中 PrintGroupedCommands 遍历 _Groups 的顺序决定。使用前应先通过 doc-guidelines 技能了解文档约定,并阅读 references/command-conventions.md 获取命令页结构、选项格式与 Smart Setup 特定规则。
限制:所有内容必须基于上述三类来源,未提供的事实不应臆造。