用途:在 deepseek-harness 仓库中撰写、移动、审阅或审计文档时,按 DeepSeek Harness 文档标准执行。规则来源为 docs/AGENTS.md,本技能只提供工作流探针,不作脚本执行。
规则来源(读取,不要重新总结):docs/AGENTS.md 规定层级、教程与参考形式、分类法、预算与 slop 清单;.agents/notes/README.md 说明何时需要 Agent Note、如何归档及内部结构;docs/postmortem/README.md 说明何时需要复盘;docs/i18n/README.md 规定双语配对规则,编辑任一侧须在同一变更中处理对侧;根 AGENTS.md 为长期指令;归档的 Agent Note 属冻结历史快照,不参与编辑维护。
先结构后文字:按标准作者顺序处理范围内文档,Agent Note 不做此结构处理。先定位文档在仓库与导航树中的位置,说明自身主题与直接子项;设定允许的详细程度,主体保留完整细节,直接子项只概括用途、职责与高层行为,更深解释移交给对应子文档并加链接;按预期用途而非路径或标题分类,教程须按顺序导向可观察结果,参考须支持在明确范围内的查找;教程另需私下标注读者与概念难度,追踪前置条件并重排。混合形式显著时拆分。
放置约束:配对文档(pnpm run verify-translation-pairing --list)每次编辑都需更新中文对侧并用 --write 重录,易变内容优先放非配对位置;生成目录不得手工编辑;重命名或移动前用 verify-md-links 与 verify-doc-refs 检查入链,移动须原子完成。
语料审计:先验证并获取 PR 实时基线,运行 pnpm --silent run change-scope --base <verified-base-ref>;用 pnpm run verify-doc-budgets --list 与 git ls-files '*.md' ':(exclude)vendor/**' | xargs wc -w | sort -rn | head -30 测预算;用 dsh-trim-cot-leakage 查推理转录泄漏;查重复表述、手写目录与 JSDoc 复述;在 implemented/ Agent Note 中删去迁移计划、验收清单与未来时态;从语料审计与编辑中排除 .agents/notes/archived/。预算变红时按 docs/AGENTS.md 的 relocate-condense-raise 顺序处理。
校验:至少运行 pnpm run doc-sync、pnpm run lint、git diff --check;配对文档变更时运行 pnpm run verify-translation-pairing --write <pair>;PR 说明应给出字数增减、解释有意超长例外并列出检查项。限制:本技能为指引,不执行命令,未提供具体收费、价格与平台信息。