oh-my-claudecode Skill 审计实践基于 Issue #1445 的七个争议技能评估框架【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecode本指南完整解析 docs/design/SKILL_AUDIT_1445.md 这份审计记录它针对 Issue #1445 提出的七个被质疑价值的内置技能给出了暂不弃用、但必须建立数据驱动决策框架的结论。文章将带你理解每个技能被质疑的原因、仓库现有的可观测性支撑trace/replay 体系、以及任何未来弃用 PR 必须满足的四条评估标准——读完你可以直接复用这套方法论为自建技能生态设计同样的审计 决策门禁。审计背景与目标Issue #1445 的核心诉求是对仓库中 30 个内置技能目录见 skills/AGENTS.md中**被质疑价值questioned-value**的七个技能做一次系统性审计并回答一个明确的问题这七个技能是否已具备弃用deprecation条件还是应当保留为内置技能或需要在移除决策之前补充埋点instrumentation审计发生在 2026-03-08结论文件作为一条**审计记录audit record**沉淀在 docs/design/ 下而不是直接发起一场弃用批量改动。这正是本审计文档最重要的工程态度没有数据支撑的移除是武断的审计的产出首先是决策框架其次才是结论。被审计的七个技能与逐项结论审计首先对七个技能逐一给出初始质疑 → 审计裁决的对照表这是全文的核心骨架Skill代码规模初始质疑审计裁决configure-notifications1213 行窄任务却体积庞大暂时保留行为过多无使用数据不宜弃用sciomc510 行小众科学工作流暂时保留小众 ≠ 无人使用deep-interview551 行复杂且使用频率不明暂时保留关键字触发的规划入口仍存在project-session-manager564 行与原生 worktree 功能重叠暂时保留仍提供超越纯 git worktree 的 tmux/会话编排能力writer-memory443 行领域特定暂时保留领域特定本身不构成移除证据external-context83 行薄封装thin wrapper质疑候选后续整合对象但当前证据不足以移除release87 行项目特定暂时保留仓库内存在项目特定维护工作流属预期逐项细节与仓库证据如下。configure-notifications行为太多先留该技能在仓库中对应 skills/configure-notifications/SKILL.md同时存在同名命令 commands/configure-notifications.md。审计认为它1213 行的体积配一个狭窄任务显得不成比例但代码规模大说明行为面广在没有使用数据之前弃用它会误伤真实用户路径。正确的做法是保留等待 trace 数据支撑后再评估。sciomc小众不是移除理由sciomc在技能目录中扮演并行科学家编排角色见 skills/AGENTS.md 的 Exploration Skills 分类sciomc 被描述为 Parallel scientist orchestration。审计裁决的核心逻辑是小众niche描述的是受众面不等于没人用unused。只有当它同时满足使用率低 存在替代面时小众才构成移除理由——而这需要数据不是直觉。deep-interview复杂但入口仍活跃skills/deep-interview/SKILL.md 实现了苏格拉底式深度访谈 数学化歧义门控通过[--quick|--standard|--deep]控制深度以加权维度量化需求清晰度未达到当次运行阈值前拒绝进入执行并产出.omc/specs/deep-interview-{slug}.md规格文件交人工审批。虽然实现复杂551 行且使用频率难以判断但审计确认关键字触发面仍然存在——deep interview、interview me、ouroboros、dont assume等自动激活词见 skills/AGENTS.md 的 Auto-Activation 表意味着它仍是一个活跃的规划入口不能贸然下线。project-session-manager不止是 worktree 的替身该技能skills/project-session-manager/SKILL.md含psm短别名表面上与原生 git worktree 重叠但审计指出其真实价值在于tmux/会话编排仓库内 skills/project-session-manager/psm.sh 及其lib/下的 12 个 shell 脚本实现了独立开发环境的管理协议。结论重叠的是隔离概念不重叠的是会话生命周期编排后者是保留依据。writer-memory领域特定性不是证据writer-memory写作场景的 agentic 记忆被质疑为领域特定domain-specific。审计的原则性反驳是领域特定是设计选择不是缺陷。判断去留必须回到它覆盖的领域用户是否依赖这一可观测问题而当前没有数据回答它。external-context最接近可弃用的候选external-context仅 83 行被质疑为薄封装。审计将其标记为唯一一个后续以更强证据重新评估的候选对应 skills/external-context/SKILL.md。它没有立即被弃用是因为薄同样不等于无人使用但它是最可能在未来的整合consolidation中与其他入口合并的技能。release项目特定是仓库的正常形态release87 行skills/release/SKILL.md被质疑为项目特定。审计认为在维护自己发布流程的仓库里出现项目特定的发布工作流是预期行为。仓库内的scripts/release.ts等发布相关脚本正是这类技能的落地形态。值得注意的是src/workflow/registry.ts 中对release的登记已是alias-deprecatecanonical target 为omc-releasemaintainer-only且注明never auto-removed without owner approval——这正好印证了审计文档逐步迁移而非批量删除的思路。为什么现在还不能弃用三个缺失要素审计文档明确给出不是弃用时机的三个结构性理由这也是任何技能治理系统都该具备的三要素分母denominator未定义使用率应以规范技能集合canonical skills为分母还是规范技能 已弃用别名为分母还是按用户会话数统计口径不定任何百分比都无意义。时间窗未约定没有约定5% 使用率到底按多少天、多少周或多少个 release 周期统计。没有时间窗的阈值无法执行。隐私姿态未确立引入任何新埋点都必须有明确的 opt-in 范围和保留retention规则。缺了这一条追加遥测本身就是合规风险。在没有这三项之前立即移除任何技能都是武断的arbitrary且难以辩护的hard to defend——这就是本审计保留优先结论的方法论根基。现有可观测性不需要新埋点就能做的审计审计文档强调仓库已经具备足够的观测表面来支撑一次结构化的手动审计无需先引入新的 opt-in 遥测。列出的五个证据源是src/hooks/subagent-tracker/flow-tracer.ts —— 会话级流程追踪flow tracesrc/hooks/subagent-tracker/session-replay.ts —— 会话回放数据JSONL 事件流src/tools/trace-tools.ts ——trace_timeline与trace_summary两个追踪工具的实现docs/PERFORMANCE-MONITORING.md —— 性能/观测指南skills/learn-about-omc/SKILL.md—— 面向 Agent 的知识查询技能trace 数据长什么样从 src/tools/trace-tools.ts 的trace_summary实现可以看到其产出是会话级聚合统计持续时间duration_seconds、总事件数total_events、spawned/completed/failed 的 Agent 数、Agent 活动明细invocations、累计耗时、model、平均耗时以及 skill 激活统计——description字段明确列出 hook stats, keyword frequencies, skill activations, mode transitions, and tool bottlenecks。回放数据按 docs/PERFORMANCE-MONITORING.md 的说明存储在.omc/state/agent-replay-{sessionId}.jsonl而session-replay.ts暴露的getReplaySummary(root, sessionId)可直接在代码中消费import { getReplaySummary } from oh-my-claudecode/hooks/subagent-tracker/session-replay; const summary getReplaySummary(process.cwd(), sessionId);这套流程追踪 会话回放 聚合摘要的组合足以回答某个技能在真实会话中被触发的频率、耗时与失败率——这正是弃用决策最需要的数据且完全不需要新增遥测。代码中可验证的遥测佐证trace_summary的设计还提供了两个与审计相关的细节佐证它自动检测最近会话sessionId省略时findLatestSessionId(root)兜底并且汇总中包含skill activations维度。也就是说未来的技能使用率统计可以直接建立在现有 replay 事件之上与审计文档先用手动采样/结构化审计埋点作为最后手段的路线完全一致。未来的弃用评估准则四条硬性门槛审计文档为任何未来的弃用 PR 设定了四条必须全部满足的评估准则这是全文最具复用价值的部分至少一个 release 周期的 trace 派生使用数据或一份清晰记录的手动采样方法manual sampling method——证据必须落在一个发布周期这个时间尺度上而非一次性的抽查。书面的低使用率阈值且必须写明被测量的总体population——即上面提到的分母。任何仍然面向用户的命令的迁移路径——用户不能突然失去入口。替代面replacement surface——如果移除理由是被原生工具或其他技能覆盖必须明确写出替代者。仓库中已有的 src/alias-retirement/policy.ts 给出了可对齐的数量化参考退役条件包含至少 2 个 minor release 且 90 天取较长者的时间门槛以及连续两个 release 规范使用占比 ≥95%的份额门槛minCanonicalShare: 0.95并支持逐条评估isCanonicalShareMet与连续两个 release 的合规性判断。技能审计可以借用同一套时间窗 占比阈值的思想只是把口径从别名使用率迁移到技能激活率。下一步行动清单审计文档将后续动作分成三层体现出区分对待、渐进决策的管理粒度保持现状Keep as-is for nowconfigure-notificationssciomcdeep-interviewproject-session-managerwriter-memoryrelease更强证据后重新评估Revisit later with stronger evidenceexternal-context—— 唯一被点名进入后续观察名单的技能若维护者想要更硬的数据基于现有trace_summary与回放数据文档化一套 trace 驱动的审计工作流audit workflow。决定learn-about-omc是否应该把该审计视图直接暴露出来供 Agent 在会话中自助查询。只有当 trace 工作流被证明不足以回答问题时才考虑新增 opt-in 遥测。这里的关键工程顺序值得强调先用已有的数据面再决定要不要造新的数据面。这与先文档化审计方法再引入遥测的原则一脉相承。结论审计记录优先于弃用批次Issue #1445 作为一次审计请求是有效的valid但它当前不构成移除任何一个被审技能的理由。正确的产出是一个审计记录加一套更清晰的决策框架而不是一场弃用批量改动deprecation batch。对本仓库的读者而言这份设计文档的价值体现在两个层面治理层面它示范了一种无数据不下结论的技能生命周期治理方式——把怀疑有价值与确认无价值严格区分把决策门槛前置到移除动作之前操作层面它把弃用重新定义为一个可验证的过程——分母、时间窗、隐私姿态、迁移路径、替代面每一个都能在代码库中找到对应的观测或登记设施trace 工具、replay 文件、workflow registry、alias-retirement 策略从而让未来的每一次弃用都有据可查、可复现、可辩护。【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
oh-my-claudecode Skill 审计实践：基于 Issue 1445 的七个争议技能评估框架
oh-my-claudecode Skill 审计实践基于 Issue #1445 的七个争议技能评估框架【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecode本指南完整解析 docs/design/SKILL_AUDIT_1445.md 这份审计记录它针对 Issue #1445 提出的七个被质疑价值的内置技能给出了暂不弃用、但必须建立数据驱动决策框架的结论。文章将带你理解每个技能被质疑的原因、仓库现有的可观测性支撑trace/replay 体系、以及任何未来弃用 PR 必须满足的四条评估标准——读完你可以直接复用这套方法论为自建技能生态设计同样的审计 决策门禁。审计背景与目标Issue #1445 的核心诉求是对仓库中 30 个内置技能目录见 skills/AGENTS.md中**被质疑价值questioned-value**的七个技能做一次系统性审计并回答一个明确的问题这七个技能是否已具备弃用deprecation条件还是应当保留为内置技能或需要在移除决策之前补充埋点instrumentation审计发生在 2026-03-08结论文件作为一条**审计记录audit record**沉淀在 docs/design/ 下而不是直接发起一场弃用批量改动。这正是本审计文档最重要的工程态度没有数据支撑的移除是武断的审计的产出首先是决策框架其次才是结论。被审计的七个技能与逐项结论审计首先对七个技能逐一给出初始质疑 → 审计裁决的对照表这是全文的核心骨架Skill代码规模初始质疑审计裁决configure-notifications1213 行窄任务却体积庞大暂时保留行为过多无使用数据不宜弃用sciomc510 行小众科学工作流暂时保留小众 ≠ 无人使用deep-interview551 行复杂且使用频率不明暂时保留关键字触发的规划入口仍存在project-session-manager564 行与原生 worktree 功能重叠暂时保留仍提供超越纯 git worktree 的 tmux/会话编排能力writer-memory443 行领域特定暂时保留领域特定本身不构成移除证据external-context83 行薄封装thin wrapper质疑候选后续整合对象但当前证据不足以移除release87 行项目特定暂时保留仓库内存在项目特定维护工作流属预期逐项细节与仓库证据如下。configure-notifications行为太多先留该技能在仓库中对应 skills/configure-notifications/SKILL.md同时存在同名命令 commands/configure-notifications.md。审计认为它1213 行的体积配一个狭窄任务显得不成比例但代码规模大说明行为面广在没有使用数据之前弃用它会误伤真实用户路径。正确的做法是保留等待 trace 数据支撑后再评估。sciomc小众不是移除理由sciomc在技能目录中扮演并行科学家编排角色见 skills/AGENTS.md 的 Exploration Skills 分类sciomc 被描述为 Parallel scientist orchestration。审计裁决的核心逻辑是小众niche描述的是受众面不等于没人用unused。只有当它同时满足使用率低 存在替代面时小众才构成移除理由——而这需要数据不是直觉。deep-interview复杂但入口仍活跃skills/deep-interview/SKILL.md 实现了苏格拉底式深度访谈 数学化歧义门控通过[--quick|--standard|--deep]控制深度以加权维度量化需求清晰度未达到当次运行阈值前拒绝进入执行并产出.omc/specs/deep-interview-{slug}.md规格文件交人工审批。虽然实现复杂551 行且使用频率难以判断但审计确认关键字触发面仍然存在——deep interview、interview me、ouroboros、dont assume等自动激活词见 skills/AGENTS.md 的 Auto-Activation 表意味着它仍是一个活跃的规划入口不能贸然下线。project-session-manager不止是 worktree 的替身该技能skills/project-session-manager/SKILL.md含psm短别名表面上与原生 git worktree 重叠但审计指出其真实价值在于tmux/会话编排仓库内 skills/project-session-manager/psm.sh 及其lib/下的 12 个 shell 脚本实现了独立开发环境的管理协议。结论重叠的是隔离概念不重叠的是会话生命周期编排后者是保留依据。writer-memory领域特定性不是证据writer-memory写作场景的 agentic 记忆被质疑为领域特定domain-specific。审计的原则性反驳是领域特定是设计选择不是缺陷。判断去留必须回到它覆盖的领域用户是否依赖这一可观测问题而当前没有数据回答它。external-context最接近可弃用的候选external-context仅 83 行被质疑为薄封装。审计将其标记为唯一一个后续以更强证据重新评估的候选对应 skills/external-context/SKILL.md。它没有立即被弃用是因为薄同样不等于无人使用但它是最可能在未来的整合consolidation中与其他入口合并的技能。release项目特定是仓库的正常形态release87 行skills/release/SKILL.md被质疑为项目特定。审计认为在维护自己发布流程的仓库里出现项目特定的发布工作流是预期行为。仓库内的scripts/release.ts等发布相关脚本正是这类技能的落地形态。值得注意的是src/workflow/registry.ts 中对release的登记已是alias-deprecatecanonical target 为omc-releasemaintainer-only且注明never auto-removed without owner approval——这正好印证了审计文档逐步迁移而非批量删除的思路。为什么现在还不能弃用三个缺失要素审计文档明确给出不是弃用时机的三个结构性理由这也是任何技能治理系统都该具备的三要素分母denominator未定义使用率应以规范技能集合canonical skills为分母还是规范技能 已弃用别名为分母还是按用户会话数统计口径不定任何百分比都无意义。时间窗未约定没有约定5% 使用率到底按多少天、多少周或多少个 release 周期统计。没有时间窗的阈值无法执行。隐私姿态未确立引入任何新埋点都必须有明确的 opt-in 范围和保留retention规则。缺了这一条追加遥测本身就是合规风险。在没有这三项之前立即移除任何技能都是武断的arbitrary且难以辩护的hard to defend——这就是本审计保留优先结论的方法论根基。现有可观测性不需要新埋点就能做的审计审计文档强调仓库已经具备足够的观测表面来支撑一次结构化的手动审计无需先引入新的 opt-in 遥测。列出的五个证据源是src/hooks/subagent-tracker/flow-tracer.ts —— 会话级流程追踪flow tracesrc/hooks/subagent-tracker/session-replay.ts —— 会话回放数据JSONL 事件流src/tools/trace-tools.ts ——trace_timeline与trace_summary两个追踪工具的实现docs/PERFORMANCE-MONITORING.md —— 性能/观测指南skills/learn-about-omc/SKILL.md—— 面向 Agent 的知识查询技能trace 数据长什么样从 src/tools/trace-tools.ts 的trace_summary实现可以看到其产出是会话级聚合统计持续时间duration_seconds、总事件数total_events、spawned/completed/failed 的 Agent 数、Agent 活动明细invocations、累计耗时、model、平均耗时以及 skill 激活统计——description字段明确列出 hook stats, keyword frequencies, skill activations, mode transitions, and tool bottlenecks。回放数据按 docs/PERFORMANCE-MONITORING.md 的说明存储在.omc/state/agent-replay-{sessionId}.jsonl而session-replay.ts暴露的getReplaySummary(root, sessionId)可直接在代码中消费import { getReplaySummary } from oh-my-claudecode/hooks/subagent-tracker/session-replay; const summary getReplaySummary(process.cwd(), sessionId);这套流程追踪 会话回放 聚合摘要的组合足以回答某个技能在真实会话中被触发的频率、耗时与失败率——这正是弃用决策最需要的数据且完全不需要新增遥测。代码中可验证的遥测佐证trace_summary的设计还提供了两个与审计相关的细节佐证它自动检测最近会话sessionId省略时findLatestSessionId(root)兜底并且汇总中包含skill activations维度。也就是说未来的技能使用率统计可以直接建立在现有 replay 事件之上与审计文档先用手动采样/结构化审计埋点作为最后手段的路线完全一致。未来的弃用评估准则四条硬性门槛审计文档为任何未来的弃用 PR 设定了四条必须全部满足的评估准则这是全文最具复用价值的部分至少一个 release 周期的 trace 派生使用数据或一份清晰记录的手动采样方法manual sampling method——证据必须落在一个发布周期这个时间尺度上而非一次性的抽查。书面的低使用率阈值且必须写明被测量的总体population——即上面提到的分母。任何仍然面向用户的命令的迁移路径——用户不能突然失去入口。替代面replacement surface——如果移除理由是被原生工具或其他技能覆盖必须明确写出替代者。仓库中已有的 src/alias-retirement/policy.ts 给出了可对齐的数量化参考退役条件包含至少 2 个 minor release 且 90 天取较长者的时间门槛以及连续两个 release 规范使用占比 ≥95%的份额门槛minCanonicalShare: 0.95并支持逐条评估isCanonicalShareMet与连续两个 release 的合规性判断。技能审计可以借用同一套时间窗 占比阈值的思想只是把口径从别名使用率迁移到技能激活率。下一步行动清单审计文档将后续动作分成三层体现出区分对待、渐进决策的管理粒度保持现状Keep as-is for nowconfigure-notificationssciomcdeep-interviewproject-session-managerwriter-memoryrelease更强证据后重新评估Revisit later with stronger evidenceexternal-context—— 唯一被点名进入后续观察名单的技能若维护者想要更硬的数据基于现有trace_summary与回放数据文档化一套 trace 驱动的审计工作流audit workflow。决定learn-about-omc是否应该把该审计视图直接暴露出来供 Agent 在会话中自助查询。只有当 trace 工作流被证明不足以回答问题时才考虑新增 opt-in 遥测。这里的关键工程顺序值得强调先用已有的数据面再决定要不要造新的数据面。这与先文档化审计方法再引入遥测的原则一脉相承。结论审计记录优先于弃用批次Issue #1445 作为一次审计请求是有效的valid但它当前不构成移除任何一个被审技能的理由。正确的产出是一个审计记录加一套更清晰的决策框架而不是一场弃用批量改动deprecation batch。对本仓库的读者而言这份设计文档的价值体现在两个层面治理层面它示范了一种无数据不下结论的技能生命周期治理方式——把怀疑有价值与确认无价值严格区分把决策门槛前置到移除动作之前操作层面它把弃用重新定义为一个可验证的过程——分母、时间窗、隐私姿态、迁移路径、替代面每一个都能在代码库中找到对应的观测或登记设施trace 工具、replay 文件、workflow registry、alias-retirement 策略从而让未来的每一次弃用都有据可查、可复现、可辩护。【免费下载链接】oh-my-claudecodeTeams-first Multi-agent orchestration for Claude Code项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-claudecode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考