本文へ移動
cccskills
無料GitHub で公開

ihs-repo-harness

IHS(IDE Harness Score)仓库健康评估技能。用于衡量 AI Coding IDE 驾驭能力下的代码仓技术债变化趋势,输出 IHS.md 评测报告(代码腐化、测试信号、文档对齐、变好/变坏结论)。

インストール方法を見る

含まれるファイル(3)

  • SKILL.md2.5 KB
  • scripts/__pycache__/generate_ihs_report.cpython-313.pyc33.0 KB
  • scripts/generate_ihs_report.py23.0 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

IHS Repo Harness

目标:借鉴 OpenAI Harness Engineering 的思路(约束 + 评测 + 回归),把 AI 快速开发带来的技术债"可视化、可量化、可追踪"。


1) 何时触发

当你需要回答以下问题时触发本技能:

  • 当前仓库健康度是在变好还是变坏?
  • 最近迭代是否引入了隐性技术债?
  • 测试与文档是否跟上了代码变更速度?

推荐触发词:

  • 运行 IHS 评估
  • 检查仓库是否变好还是变坏
  • 生成 IHS 报告

2) 触发命令(标准)

在仓库根目录执行:

python3 .claude/skills/ihs-repo-harness/scripts/generate_ihs_report.py --output docs/IHS.md

可选参数:

  • --skip-runtime-checks:跳过 type-check / test / coverage(仅静态分析)
  • --history-window <N>:自定义文档对齐分析窗口(默认 40 commits)

3) 评估维度(IHS)

IHS 总分 = 代码腐化度(40%) + 测试信号(35%) + 文档对齐(25%)

A. 代码腐化度(Code Entropy)

关注点:

  • TODO/FIXME/HACK/XXX
  • any、@ts-ignore/@ts-nocheck
  • eslint-disable
  • 超大文件(>400 行)

B. 测试信号(Harness Checks)

关注点:

  • 测试文件/源码文件比
  • npm run type-check 结果
  • npm run test 结果
  • npm run coverage -- --reporter=json-summary 结果与覆盖率摘要

C. 文档对齐(Docs Alignment)

关注点:

  • 关键文档是否存在(AGENTS.md、docs/、README、SUPABASE_COOKBOOK)
  • 最近窗口内"代码提交 vs 文档提交"对齐率
  • 文档新鲜度(<=120 天)

4) 输出契约

执行完成后必须产出:

  1. 根目录报告:docs/IHS.md
  2. 明确结论:
    • 仓库状态:好 / 坏
    • 趋势判断:变好 / 变坏 / 持平(对比 HEAD~1)
  3. 可执行改进建议(按优先级排序)

5) 判定标准(默认)

  • 总分 >= 70:状态判定为 好
  • 总分 < 70:状态判定为 坏
  • 与 HEAD~1 的静态趋势分对比:
    • Δ > 1 => 变好
    • Δ < -1 => 变坏
    • 其他 => 持平

6) 推荐执行节奏

  • 每次较大功能合并前执行 1 次
  • 每周固定执行 1 次,持续追踪技术债趋势
  • 在 CI 中可先使用 --skip-runtime-checks 快速出静态趋势,再按需执行全量检查

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

代码仓库 AI 亲和度审计工具,支持前端、后端、全栈等各类项目。此技能用于检查给定的代码仓库对 AI Coding 工具的友好程度,生成详细的分析报告和改进建议。当用户需要评估代码仓库是否适合 AI 辅助开发、希望提升仓库的 AI 可操作性、或准备引入 AI Coding 工具前进行仓库评估时,应使用此技能。支持 TypeScript/JavaScript、Go、Java/Kotlin、Python、Rust 等主流技术栈。融合 OpenAI Harness Engineering 方法论,评估 Outer Loop(反馈闭环、评估门禁、机械化不变量)建设。

日本語の概要は準備中です。原文の説明を表示しています。

alibaba/opc-starter882026年7月22日 更新

OPC-Starter 智能开发技能。AI 亲和的 React Boilerplate 项目开发规范,支持动态上下文感知、TDD 驱动开发、Agent Studio 扩展。适用于认证系统、组织架构、Agent 工具、数据同步等模块的迭代开发。

日本語の概要は準備中です。原文の説明を表示しています。

alibaba/opc-starter882026年7月22日 更新

Push the LLM to reconsider, refine, and improve its recent output. Use when user asks for deeper critique or mentions a known deeper critique method, e.g. socratic, first principles, pre-mortem, red team.

日本語の概要は準備中です。原文の説明を表示しています。

alibaba/opc-starter882026年7月22日 更新

Strategic business analyst and requirements expert. Use when the user asks to talk to Mary or requests the business analyst.

日本語の概要は準備中です。原文の説明を表示しています。

alibaba/opc-starter882026年7月22日 更新

System architect and technical design leader. Use when the user asks to talk to Winston or requests the architect.

日本語の概要は準備中です。原文の説明を表示しています。

alibaba/opc-starter882026年7月22日 更新

Builds, edits or analyzes Agent Skills through conversational discovery. Use when the user requests to "Create an Agent", "Analyze an Agent" or "Edit an Agent".

日本語の概要は準備中です。原文の説明を表示しています。

alibaba/opc-starter882026年7月22日 更新

alibaba のスキルをすべて見る

このスキルの問題を報告する