无障碍修复人力估算翻译：从工程师人天到团队真实日历的严谨换算 —— vscode-gitlens a11y-remediate 技能实战指南

开发工具版本控制【免费下载链接】vscode-gitlensSupercharge Git inside VS Code and unlock untapped knowledge within each repository — Visualize code authorship at a glance via Git blame annotations and CodeLens, seamlessly navigate and explore Git repositories, gain valuable insights via rich visualizations and powerful comparison commands, and so much more项目地址https://gitcode.com/gh_mirrors/vs/vscode-gitlens点击查看免费下载无障碍a11y审计输出的是S/M/L级别的单条问题规模与一个求和后的工程师人天区间如 3.5–13 engineer-days这本质上是一个规划信号而不是人力诉求——管理者无法拿着 3.5–13 工程师人天 走进 VP 会议。本文以 vscode-gitlens 仓库中.claude/skills/a11y-remediate/references/staffing-translation.md为骨架完整讲解如何把审计产出的人天估算在获得团队速度上下文后严谨地翻译为管理层可以承诺的人力诉求staffing ask与冲刺计划sprint plan并同步给出仓库源码级的实现佐证与不可越界的反例清单。读完本文你将掌握五要素输入的门槛判定、D/F人天换算公式、可并行化判定规则、冲刺向上取整原则、A/B/C 三级输出格式的选择逻辑以及跨审计汇总与共享组件库多产品协调成本的处置方法。一、为什么需要人力翻译审计人天与日历时间的鸿沟/a11y-audit技能产出的粗规模估计rough sizing是一个熟悉该组件的开发者视角下的聚焦人天区间。据 a11y-audit 输出格式文档 中的定义EffortS ≈ 0.25–0.5 天、M ≈ 0.5–2 天、L ≈ 2–5 天且该区间明确排除了 QA/回归周期、意外未知数与返工同时声明不是日历时间、不可按冲刺估算——技能没有团队速度上下文。这意味着审计人天假设了100% 聚焦时间。而真实团队里会议、评审、被打断会蚕食大量工时。staffing-translation.md的存在目的就是把这种理想化的聚焦人天翻译成管理者能真正承诺的日历时间与冲刺数——但前提是用户提供了团队速度上下文。文档开篇的硬性规则Hard rule必须始终遵守如果用户没有提供团队规模、速度与节奏cadence技能必须拒绝输出任何日历或冲刺数字直说原因绝不虚构。这一原则与 a11y-remediate SKILL.md 中 8 条 load-bearing rules 的第 1、4 条一脉相承Never fabricate numbers——每个数字都有出处审计字段或用户输入未知就写 requires [input]Never convert engineer-days to calendar weeks without velocity input。二、技能需要用户提供的五要素输入在输出任何人力估算之前技能必须先确认以下五项上下文。每一项都有明确的缺失处理方式——对应输出字段直接写成[not provided — cannot calculate]绝不输出猜测数字输入示例若缺失团队规模Team sizegraph 团队 3 名工程师无法给出人力 × 日历聚焦时间占比Focus-time fraction约 60% 聚焦时间其余用于会议/评审/打断默认 50%并附显式 caveat冲刺节奏Sprint cadence双周冲刺周二到周二可输出工程师人天但无法输出冲刺数PR 评审周期PR review cycle从开 PR 到合入约 2 天可输出人天但无法输出总日历既有承诺Existing commitments团队 70% 产能已分配给 Q2 的功能 X拒绝声称产能可用由读者自行扣减这五项在 a11y-remediate SKILL.md 的 Detection spine — Step 2 Team context 中同样被列为用户提供项技能无法发明团队特性未提供就必须询问。其中聚焦时间占比的默认值为 50%且必须在输出中显式标注该 caveat并在提案 Section 10 中标记。判断要点只要有一项未提供对应的输出字段就保持为占位符式的可读声明而不是一个被脑补出来的数字。三、换算公式从聚焦人天到日历人天当上下文齐备时给定审计人天估计D与团队聚焦时间占比F0 F ≤ 1换算关系如下日历工程师人天Calendar engineer-daysD / F。文档示例一个 0.5 天任务在 60% 聚焦时间下 ≈ 0.83 个日历天。单工程师顺序完成Calendar by one engineerD / F天。N 名工程师并行Parallel by N engineers(D / F) / N天——且仅当工作可以被并行化见下方并行化规则。这套公式在 a11y-remediate 输出格式文档 的 Section 5 — Staffing Ask 中落地为标题行headline与推导derivation分离的结构标题行只给结论让管理者直接引用公式与除法运算全部放在Detailed derivation小节供工程评审核对两者绝不混在一起。并行化规则Parallelization rules并非所有审计问题都能靠加人提速必须逐类判定Safely Shippable Now可安全交付项可以跨工程师并行——每个 PR 相互独立。Issue Group问题组项不可并行——整组必须作为一个 PR 一次性落地。Design-blocked设计阻塞项不可跨工程师并行——它们在等待一个决策加人无济于事。协调成本随人数上升3 名工程师处理 10 人天的项目通常实际耗时 3.3 个日历天原因包括 PR 评审排队、共享文件合并冲突与上下文切换开销。从仓库实现看这种组必须整体落地的约束与 a11y-audit 输出格式文档 中 Issue Groups 的定义完全对应共享同一复合 ARIA 模式、共享容器角色契约、共享符号、级联依赖或需要同一个新工具类的多个问题必须打包为同一组交付——这与并行化判定直接挂钩。冲刺换算激进的向上取整给定冲刺长度S双周冲刺通常为 10 个工作日与日历人天估计C所需冲刺数ceil(C / S)必须激进向上取整0.4 个冲刺应表述为1 个冲刺并混排其他工作。永远不要对管理者说这只需要半个冲刺——他们会按半个冲刺去排期最终必然落空。四、三种输出格式选择输入所能支撑的最受限格式技能必须选择用户输入所能支撑的最保守最受限格式绝不输出比输入允许的更自信的格式。格式 A —— 完整人力诉求用户提供了全部输入所需冲刺1 个冲刺用于可安全交付项可由 2 名工程师并行设计决策落地后再增加 1 个冲刺用于 Issue Group A。人力诉求2 名工程师 × 1 个冲刺处理当前可交付工作设计阻塞组解除阻塞后1 名工程师 × 1 个冲刺。Caveats假设 60% 聚焦时间、2 天 PR 评审周期、无意外回归。设计阻塞项在阻塞决策落地前不会取得进展。格式 B —— 仅工程师人天不做冲刺换算未提供节奏所需工程师人天8 个问题共 3.5–13 天单人、顺序执行。若并行可安全交付项2.5–6 人天可拆给 2 名工程师约 1.5–3 个日历天Issue Group 项必须作为一个 PR 落地。Caveats未提供冲刺换算——技能没有节奏cadence输入。格式 C —— 仅工程师人天完全没有团队上下文所需工程师人天3.5–13 天单人、顺序、聚焦时间。未提供人力翻译。技能没有团队规模、速度或节奏输入。若读者需要人力/冲刺诉求必须补充这些输入后重新调用。格式 C 的实际行为与 a11y-remediate SKILL.md 中 If team size is not provided, the skill cannot emit headcount × time staffing asks. Say so plainly. 完全一致不硬凑把缺口说清楚并把该缺口登记进提案的 Section 10Explicit Gaps。五、禁止声称的边界What NOT to claim以下四条是硬性红线任何一条被越过都意味着产出物失去可信度没有速度数据绝不把工程师人天换算成日历周。一个 5 天任务在没有聚焦时间上下文时不能等同于一周。绝不把可并行与不可并行的工作求和为一个数字。两类工作必须分开呈现。绝不声称工程师可以在本工作与另一个项目之间上下文切换。若团队有既有承诺要么按承诺扣减可用产能要么明确声明无法扣减。缺少以下任何一项绝不声称Q3 可以实现所需冲刺数 团队在整个 Q3 的可用性 设计决策 ETA。三者缺一即不可承诺。这些边界在 a11y-remediate 输出格式文档 的 Rules across all sections 中被进一步系统化为每个数字必须有出处provenance工程师人天只能来自审计 Effort 区间、冲刺只能来自用户提供的节奏、人力只能来自用户提供的团队规模加并行化分析、日历日期只能来自用户提供的承诺——读者若无法把一个数字追溯回它的输入它就是虚构的必须删除。这正是 SKILL.md 中 Pre-finalize pass Scan 1 — Every number has provenance 的检查内容。六、跨审计规模格式的不对称性处理当汇总两个或更多审计时每个审计的规模以该审计自己的格式呈现——要么是数字人天区间如DraggableGraphHeader.tsx: 1.5–5 engineer-days要么是N/A如ScrollbarContainer.tsx: N/A因为其 Options 跨越一个数量级。这两种格式不可互换处置规则如下按审计自身格式引用其规模。不要把数字区间重新表述为 N/A也不要把 N/A 强行变成数字。绝不对不兼容的规模格式求和。用(1.5–5) N/A计算出的 Phase-2 总量就是虚构的必须拒绝每个审计保留各自的区间并显式陈述 N/A。产出单一冲刺数或聚合数字时必须声明哪些审计贡献了数字、哪些是 N/A且只把聚合结果限定在贡献数字的审计范围内。文档给出的示例表述为Phase 2 sprint count cannot be calculated: DraggableGraphHeader contributed 1.5–5 engineer-days; ScrollbarContainer is N/A pre-decision. An aggregate cannot be emitted until ScrollbarContainers design decision narrows its Options.N/A作为合法规模答案的判定依据来自 a11y-audit 输出格式文档当所有问题都是设计阻塞且设计决策的 Options 在实现规模上跨越一个数量级如加一个按键处理器 vs 重构滚动架构时应输出N/A而不是一个跨度超过一个数量级的无用数字——downstream rollups cannot consume it。此外跨审计引用问题时必须使用{文件名主干}#N形式如draggable-graph-header#3、scrollbar-container#1以避免歧义因为每个审计的问题编号都从 #1 开始若某审计存在编号缺口如无 #5汇总表格中必须保留该注释。七、多产品共享组件库的协调成本当审计覆盖被多个产品消费的共享库组件如gitkraken/gitkraken-components同时被vscode-gitlens与桌面端应用使用时必须计入跨产品协调成本每一项修复都会在每个消费产品的回归测试中产生协调成本。按消费方数量追加开销预算粗略指引为每增加一个消费方追加 20–40% 工程师人天具体取决于消费方 CI/测试的深度。若技能不知道消费方是谁必须将修复标记为需要额外协调并注明估算不包含下游产品验证。文档给出的标准 caveat 表述The component audited ships ingitkraken/gitkraken-components(consumed byvscode-gitlensand the GitKraken desktop app). The engineer-day estimate above is library-side work only. Downstream regression testing in consumer products adds approximately 20–40% per consumer and is owned by those product teams.这一机制在 vscode-gitlens 仓库中有真实的落点佐证packages/components/package.json定义了gitlens/components共享组件包Reusable GitLens Lit components, controllers, directives, and styles而共享图表布局实现 packages/plus/commit-graph/src/zones.ts 在注释中明确提到其minWidth下限ref 32、message 50 等match the legacy gitkraken-components zones说明当前实现正是从被多产品消费的共享库演进而来——因此文档所述library-side work only的边界与每消费方 20–40% 的回归验证预算对该类组件的任何修复估算都适用。同时a11y-audit SKILL.md 的 Step 3 Shared-library detection 也要求审计先判定目标是否属于被多消费方导入的共享库并据此升级语义元素替换如span onClick→button的视觉回归关注度。八、在技能流水线中的完整定位与配套规则staffing-translation.md并非孤立文件它是/a11y-remediate技能路由表中的一个叶子节点。据 a11y-remediate SKILL.md路由时机Building the staffing ask section → readstaffing-translation.md配套的还有critical-path.md设计决策串行阻塞、compliance-rollup.md合规汇总、customer-framing.md、deferral-risk.md与output-format.md。提案中的位置Staffing Ask 是 10 节提案结构的第 5 节位于 Executive Summary第 0 节与 Sprint Plan第 6 节之间。Executive Summary 中只呈现Phase 1 多少人、Phase 2 多少人 × 几个冲刺的结论不展示推导算术。校准单行Mandatory calibration one-liner动笔前必须先输出Audits in scope: {N, files}. Team: {...}. Compliance target: {...}. Unaudited surface: {...}. Named owners: {...}让读者明确知道提案基于哪些输入运行——输入缺失 输出拒绝而非输出虚构。前置依赖该技能不是审计它只消费/a11y-audit的输出没有审计就先跑/a11y-audit。审计输出必须包含 Effort/风险字段、Issue Groups、Safely Shippable Now 与 Design-blocked 表等结构化内容提取才能完整。配套规则还包括绝不虚构责任人只用角色名除非用户提供了角色 → 人名映射、绝不虚构合规范围1 个文件的审计不能回答graph 是否合规、以及每个提案必须以 Section 10 What this CANNOT answer 收尾——缺口不隐藏而是列出并给出闭合路径。汇总审计时Issue Group 的依赖类型标签必须原样保留不同审计可能用 shared utility、cascade、cascade shared design decision 等不同词汇按语义类别归组并注明标签差异绝不静默改写某个审计的 Safely-Shippable 若为None必须引用原因如 all issues design-blocked而不是裸写None以免被误读为审计未完成。九、实操自查清单把规则变成可执行的检查将本文全部规则浓缩为写提案前的一页自检单输入核对五要素规模/聚焦/节奏/PR 周期/既有承诺逐项确认缺失即输出[not provided — cannot calculate]。换算正确日历人天 D / F冲刺数 ceil(C / S)且激进取整。并行判定Safely Shippable 可并行、Issue Group 整组落地、Design-blocked 不可加人协调成本随人数上升。格式选择按最受限格式 A/B/C 输出标题行与推导分离。红线检查无速度不换算日历周可并行/不可并行不求和不声称上下文切换无冲刺数 可用性 决策 ETA 不承诺季度目标。跨审计纪律按审计自身格式引用规模N/A与数字区间绝不求和问题引用用{文件}#N标签原样保留。共享库开销每消费方 20–40% 回归验证预算估算仅覆盖 library-side work并显式注明。出处可溯扫描草稿中每个数字能否追溯到审计字段、用户输入或本文公式不能则替换为 requires [input] 并登记进 Section 10。遵循这套流程产出的 Staffing Ask才是管理者可以带进 VP 会议、工程负责人可以复核推导、且经得起每个数字都有出处审查的规划文档——这正是 vscode-gitlens 无障碍治理体系中从审计发现到决策承诺之间那条不虚构、不越界、可追溯的翻译通道。赞分享开发工具版本控制【免费下载链接】vscode-gitlensSupercharge Git inside VS Code and unlock untapped knowledge within each repository — Visualize code authorship at a glance via Git blame annotations and CodeLens, seamlessly navigate and explore Git repositories, gain valuable insights via rich visualizations and powerful comparison commands, and so much more项目地址https://gitcode.com/gh_mirrors/vs/vscode-gitlens点击查看免费下载相关推荐vscode-gitlens 无障碍修复技能a11y-remediate刷新维护清单接口契约、共享引用与版本管理实践vscode gitlens 无障碍修复技能a11y remediate刷新维护清单接口契约、共享引用与版本管理实践 导读 a11y remediate开发工具版本控制Open-Sora 零门槛实战一句提示词生成 AI 视频单卡 60 秒出片Open Sora 零门槛实战一句提示词生成 AI 视频单卡 60 秒出片 Open Sora 是一个面向 AI 视频生成的开源项目它想解决的核心问题很直人工智能大模型媒体生成音视频预训练分布式训练维护 WCAG 与 ARIA 规范引用vscode-gitlens a11y-audit 无障碍审计技能刷新指南维护 WCAG 与 ARIA 规范引用vscode gitlens a11y audit 无障碍审计技能刷新指南 无障碍审计a11y技能在 vscode开发工具版本控制创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考