instrlint 0.1.10 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/dist/cli.cjs +150 -11
  2. package/dist/cli.cjs.map +1 -1
  3. package/dist/cli.js +151 -12
  4. package/dist/cli.js.map +1 -1
  5. package/package.json +1 -1
  6. package/skills/claude-code/SKILL.md +10 -2
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "instrlint",
3
- "version": "0.1.10",
3
+ "version": "0.2.2",
4
4
  "description": "Lint and optimize your CLAUDE.md / AGENTS.md — find dead rules, token waste, and structural issues",
5
5
  "type": "module",
6
6
  "bin": {
package/skills/claude-code/SKILL.md CHANGED
@@ -40,7 +40,7 @@ When the user runs `/instrlint [args]`, translate to:
40
40
 
41
41
  ## LLM 驗證流程（--verify）
42
42
 
43
- contradiction / duplicate detector 是純文字啟發式，可能產生 false positive。你（host agent）能讀懂語意，可以複核這些 findings。
43
+ contradiction / duplicate / structure detector 是純文字啟發式，可能產生 false positive。你（host agent）能讀懂語意，可以複核這些 findings。
44
44
 
45
45
  **協議概念：** instrlint 不會自己呼叫 LLM API。它把可疑 findings 寫成 `candidates.json`，由你判斷後寫 `verdicts.json`，再由 instrlint merge 回報告。
46
46
 
@@ -116,9 +116,17 @@ npx instrlint@latest --apply-verdicts instrlint-verdicts.json --format markdown
116
116
  - **rejected**：表面相似但實際說的是不同的細節 / 範圍 / 例外
117
117
  - **uncertain**：判不出來
118
118
 
119
+ ### structure
120
+
121
+ - **confirmed**：這條規則確實更適合由 git hook 或 path-scoped rule file 自動執行，放在 CLAUDE.md 中是多餘的
122
+ - **rejected**：這條規則是架構決策說明、一般性原則、或需要人工判斷的 context，不適合用工具強制執行（例：「LLM 驗證必須由 host orchestrate」是設計原則，不是 git hook 能攔的）
123
+ - **uncertain**：無法判斷，需要看更多 context
124
+
119
125
  ### 通則
120
126
 
121
- - 先讀 `candidate.context.ruleA.text` / `ruleB.text`，必要時用 Read tool 看該 file 的上下文
127
+ - structure：先讀 `candidate.context.rule.text` 和 `candidate.context.suggestion`
128
+ - contradiction / duplicate：先讀 `candidate.context.ruleA.text` / `ruleB.text`
129
+ - 必要時用 Read tool 看該 file 的上下文
122
130
  - `reason` 實務上寫 ≤ 20 字即可（上限 500 字元，instrlint 會驗證）
123
131
  - 沒有 verdict 的 candidate 不需要寫進 verdicts.json（instrlint 會保留它不動）
124
132
  - `rejected` findings 在最終報告中會被過濾掉；`confirmed` 和 `uncertain` 會附上你的 reason 顯示