SuperAPI AI 工具集

dsh-prose-standard

智能体与模型

查看项目

更新于 10-15 20:35

技能介绍

用途:为 deepseek-harness 仓库中的说明性文字(prose)提供编辑判断与覆盖要求,包括判断文档或注释应在何处保留、添加、精简、恢复或审计。适用于撰写、审阅、恢复、精简、审计文档与注释,以及决定说明文字的内容边界。

主要能力:以“完整命题”为准,编辑前识别并保留参与者与动作、条件与时序、must/may/never 等情态、否定保证与例外、归属、副作用、失败模式与后果;只有所有事实分句都保留且表达更清晰时才删形容词、重复与叙述。要求在使用点保留完整的本地契约(行为、失败、归属、后果),架构、理由、算法、历史与扩展示例则链接到唯一归属文档。

按位置规定必需覆盖内容:公共 JSDoc 记录调用方可见的返回差异、抛出或拒绝、副作用、归属、时序、取消与持久性;内部注释仅用于说明非本地结构和复杂本地结构,删除控制流叙述与代码复述;模块注释说明角色、依赖、职责与非常规架构选择;测试仅解释非常规设计;Cookbooks 含前置条件、必需操作、真实入口、可观察验证与警告;README 含消费者契约(配置、语义、失败、限制、扩展点、模型可见影响);Agent Notes 保留独特理由、机制、替代方案、后果、已发布验证证据与具名覆盖缺口;事后总结保留事件序列、证据、因果链、影响与预防;Skills 与 agent 指令说明行为护栏与范围限制;提示词与可见字符串视为行为。

使用方式:需显式给定范围,缺失时只报告所需输入并停止,不推断全仓库范围。模式有 automatic 与 interactive,默认 automatic,仅用户明确要求提问或校准才进入交互模式;模式控制是否提问,不控制写入权限。审阅与审计只报告发现,不编辑;明确要求写入、修复或精简时才应用清晰改动。始终排除 vendor/,其排除规则应置于包含 glob 之后,例如 ripgrep 命令以 --glob '!vendor/' 结尾,Git 命令使用 :(exclude)vendor/。同时排除 .agents/notes/archived/。生成目录、快照与夹具视为派生物,先改拥有它的源或场景,再重新生成。

限制:该技能是指导,不是脚本。若授权范围没有可归属场景,则不改措辞并在报告中说明延期,不能将其静默并入纯文风编辑。范围仅含 vendor/ 时报无可处理文件。本页未提供具体安装命令、价格或平台信息。