Skip to content
cccskills
FreePublished on GitHub

ihs-repo-harness

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

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (3)

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

SKILL.md (original)

Review the instructions the agent will receive before you install.

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 快速出静态趋势,再按需执行全量检查

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

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

The English summary is being prepared. Showing the original description.

alibaba/opc-starter88Updated Jul 22, 2026

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

The English summary is being prepared. Showing the original description.

alibaba/opc-starter88Updated Jul 22, 2026

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.

The English summary is being prepared. Showing the original description.

alibaba/opc-starter88Updated Jul 22, 2026

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

The English summary is being prepared. Showing the original description.

alibaba/opc-starter88Updated Jul 22, 2026

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

The English summary is being prepared. Showing the original description.

alibaba/opc-starter88Updated Jul 22, 2026

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".

The English summary is being prepared. Showing the original description.

alibaba/opc-starter88Updated Jul 22, 2026

See all skills by alibaba

Report a problem with this skill