用途:这是 hve-core 中供 Documentation 智能体使用的共享文档能力,把 audit、drift、validate、author 四种流程所需的持久知识集中到一个包中,让轻量封装按模式加载对应指引,而不必内嵌能力说明。
主要能力与模式:audit 模式加载 references/conventions.md、coverage-method.md、validation-toolchain.md、content-sensitivity.md,以技能驱动的审计循环替代原 Doc Ops 工作流;drift 模式加载 conventions.md、code-doc-mapping.md、content-sensitivity.md,使用仓库本地映射表与漂移启发式;validate 模式加载 validation-toolchain.md、accessibility-checks.md、content-sensitivity.md、rai-guardrails.md,运行文档校验并在需要时升级正式评审;author 模式加载 templates/guide.md、templates/reference.md 及 conventions、accessibility-checks、content-sensitivity、rai-guardrails,按仓库约定产出叙述型或参考型文档。
使用方式:按模式加载相应参考文件;audit 与 validate 默认运行本地安全可执行的检查,并单独汇总已有 CI 状态,未运行的 CI 检查须记为 Pending CI、Skipped、Deferred 或 Unavailable,不得记为 Passed;仅当任务明确要求复现某条 CI 通道时才在本地调用。会话状态写入 .copilot-tracking/documentation/ 下的 {{YYYY-MM-DD}}-session.md。
限制:不编写 ADR、BRD、PRD 等规划产物;不内嵌可访问性、RAI 或安全标准逻辑,而是指向专门参考文件,并在需要专业评估时转交相应规划者。浏览器安装、模型或审核环境、服务、凭据与交互式 UI 视为独立前置条件,而非自动故障恢复。audit 与 validate 在记录本地安全结果与单独 CI 证据后即停止,缺失的专门环境或 CI 证据须单独报告,不得推断、自动配置或记为通过。文档改动应保持事实性并限定在当前任务范围内。