Skip to content

Commit 7943b27

Browse files
cursoragentmorluto
andcommitted
Align jacobian math skill guidance after rebase
Co-authored-by: morluto <morluto@users.noreply.github.com>
1 parent 44f3639 commit 7943b27

2 files changed

Lines changed: 66 additions & 48 deletions

File tree

.agents/skills/jacobian-math/SKILL.md

Lines changed: 33 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -10,18 +10,22 @@ description: Use Jacobian for specialized exact mathematics, including matrix de
1010
In Codex Code Mode, call the nested methods
1111
`tools.mcp__jacobian__math_find(...)` and
1212
`tools.mcp__jacobian__math_run(...)` directly. Do not enumerate, filter, or
13-
print `ALL_TOOLS` merely to locate them; that needlessly adds every matching
14-
tool description to the model context. Return only the typed projection when
15-
available, for example:
13+
print `ALL_TOOLS`; that loads matching tool descriptions into context. Return
14+
only the typed projection when available:
1615

1716
```js
1817
const r = await tools.mcp__jacobian__math_find({query: "...", limit: 3});
1918
text(r.structuredContent ?? r);
2019
```
2120
22-
Call `math.run` directly when the requested local outcome exactly matches one of
23-
these stable built-in contracts; replace the example values but preserve the
24-
shown JSON types:
21+
Use Jacobian for each requested exact mathematical outcome, even when small or
22+
shell-solvable. Route multiple requested outcomes separately. Prefer a
23+
capability matching the requested operation over a generic arithmetic substep
24+
that yields the same scalar; composing already-known supporting operations remains allowed when clearer.
25+
Do not call Jacobian for definitions, formatting, or non-execution tasks.
26+
27+
Call `math.run` directly when the requested local outcome exactly matches these
28+
stable built-in contracts; replace examples but preserve JSON types:
2529
2630
- `integer.compute.gcd`, `integer.compute.lcm`, or
2731
`integer.compute.extended_gcd` in `EXPLORE` mode:
@@ -36,26 +40,31 @@ shown JSON types:
3640
`{"determinant_uri":"<determinant_uri from compute output>"}`.
3741
3842
For other outcomes or unfamiliar payloads, use `math.find` with a specific
39-
plain-language outcome and any domain or mode already implied by the task; a
40-
capability ID is not required. Request only as many matches as are useful
41-
because lower `limit` values reduce context. Inspect the `CONTRACT` view only
42-
when its typed schema is needed to construct the `math.run` payload. A discovery
43-
card's validated `invocation_example`, or its required top-level fields when no
44-
example is available, may already provide a sufficient payload shape.
43+
plain-language outcome and implied domain or mode; no capability ID is required.
44+
Use low `limit` values. Inspect `CONTRACT` only when the typed schema is needed.
45+
A card's `invocation_example`, or required top-level fields, may be enough.
46+
47+
Do not add a discovery domain filter unless its exact installed spelling is
48+
known. When discovery exposes recovery paths, follow those fields (for example,
49+
`remove_unknown_domain_filter`, `remove_filters`, or `reformulate_query`) before
50+
treating absence as final. After invalid input, correct the reported constraint
51+
and retry within the task resource bounds as further errors appear. If one
52+
provider is unavailable, continue with other installed routes that can produce
53+
the outcome. Treat timeouts as non-conclusions. Accept only a completed result
54+
whose scope covers the input, and carry forward the smallest decisive value,
55+
witness, status, assurance, completeness, and open obligations; preserve artifact
56+
refs, including verification record URIs.
4557
4658
Keep representation, decomposition, composition, iteration, verification
4759
timing, and stopping decisions agent-owned. Treat timeouts, errors, incomplete
4860
searches, and missing witnesses as non-conclusions.
4961
50-
When independent checking is requested, calculations or programs authored by
51-
the same model are not independent checker evidence. Use an installed `VERIFY`
52-
capability when available. An artifact URI or checker-result summary is not a
53-
task-local verification-record file: never reconstruct or paraphrase such a
54-
record from the returned fields. Claim `VERIFIED` only when the result has
55-
assurance level `VERIFIED`, the exact record bytes are available, and any
56-
required task authorization and bindings are preserved. Otherwise use a lower
57-
assurance permitted by the task.
58-
59-
Verification is bound to the exact checked claim. Do not transfer `VERIFIED` from an
60-
input, premise, factorization, or related artifact to a conclusion derived by the
61-
model; the final conclusion needs its own checker-bound verification record.
62+
When independent checking is requested, model-authored calculations or programs
63+
are not independent evidence. Use installed `VERIFY` when available. An artifact
64+
URI or checker summary is not a task-local verification-record file: never
65+
reconstruct or paraphrase such a record from returned fields. Claim `VERIFIED`
66+
only when the result has assurance level `VERIFIED`, exact record bytes, and
67+
required task authorization and bindings are preserved; otherwise use lower
68+
task-permitted assurance. Verification is bound to the exact checked claim: do
69+
not transfer `VERIFIED` from an input, premise, factorization, or related
70+
artifact to a model-derived conclusion, which needs its own checker-bound record.

npm/skills/jacobian-math/SKILL.md

Lines changed: 33 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -10,18 +10,22 @@ description: Use Jacobian for specialized exact mathematics, including matrix de
1010
In Codex Code Mode, call the nested methods
1111
`tools.mcp__jacobian__math_find(...)` and
1212
`tools.mcp__jacobian__math_run(...)` directly. Do not enumerate, filter, or
13-
print `ALL_TOOLS` merely to locate them; that needlessly adds every matching
14-
tool description to the model context. Return only the typed projection when
15-
available, for example:
13+
print `ALL_TOOLS`; that loads matching tool descriptions into context. Return
14+
only the typed projection when available:
1615

1716
```js
1817
const r = await tools.mcp__jacobian__math_find({query: "...", limit: 3});
1918
text(r.structuredContent ?? r);
2019
```
2120
22-
Call `math.run` directly when the requested local outcome exactly matches one of
23-
these stable built-in contracts; replace the example values but preserve the
24-
shown JSON types:
21+
Use Jacobian for each requested exact mathematical outcome, even when small or
22+
shell-solvable. Route multiple requested outcomes separately. Prefer a
23+
capability matching the requested operation over a generic arithmetic substep
24+
that yields the same scalar; composing already-known supporting operations remains allowed when clearer.
25+
Do not call Jacobian for definitions, formatting, or non-execution tasks.
26+
27+
Call `math.run` directly when the requested local outcome exactly matches these
28+
stable built-in contracts; replace examples but preserve JSON types:
2529
2630
- `integer.compute.gcd`, `integer.compute.lcm`, or
2731
`integer.compute.extended_gcd` in `EXPLORE` mode:
@@ -36,26 +40,31 @@ shown JSON types:
3640
`{"determinant_uri":"<determinant_uri from compute output>"}`.
3741
3842
For other outcomes or unfamiliar payloads, use `math.find` with a specific
39-
plain-language outcome and any domain or mode already implied by the task; a
40-
capability ID is not required. Request only as many matches as are useful
41-
because lower `limit` values reduce context. Inspect the `CONTRACT` view only
42-
when its typed schema is needed to construct the `math.run` payload. A discovery
43-
card's validated `invocation_example`, or its required top-level fields when no
44-
example is available, may already provide a sufficient payload shape.
43+
plain-language outcome and implied domain or mode; no capability ID is required.
44+
Use low `limit` values. Inspect `CONTRACT` only when the typed schema is needed.
45+
A card's `invocation_example`, or required top-level fields, may be enough.
46+
47+
Do not add a discovery domain filter unless its exact installed spelling is
48+
known. When discovery exposes recovery paths, follow those fields (for example,
49+
`remove_unknown_domain_filter`, `remove_filters`, or `reformulate_query`) before
50+
treating absence as final. After invalid input, correct the reported constraint
51+
and retry within the task resource bounds as further errors appear. If one
52+
provider is unavailable, continue with other installed routes that can produce
53+
the outcome. Treat timeouts as non-conclusions. Accept only a completed result
54+
whose scope covers the input, and carry forward the smallest decisive value,
55+
witness, status, assurance, completeness, and open obligations; preserve artifact
56+
refs, including verification record URIs.
4557
4658
Keep representation, decomposition, composition, iteration, verification
4759
timing, and stopping decisions agent-owned. Treat timeouts, errors, incomplete
4860
searches, and missing witnesses as non-conclusions.
4961
50-
When independent checking is requested, calculations or programs authored by
51-
the same model are not independent checker evidence. Use an installed `VERIFY`
52-
capability when available. An artifact URI or checker-result summary is not a
53-
task-local verification-record file: never reconstruct or paraphrase such a
54-
record from the returned fields. Claim `VERIFIED` only when the result has
55-
assurance level `VERIFIED`, the exact record bytes are available, and any
56-
required task authorization and bindings are preserved. Otherwise use a lower
57-
assurance permitted by the task.
58-
59-
Verification is bound to the exact checked claim. Do not transfer `VERIFIED` from an
60-
input, premise, factorization, or related artifact to a conclusion derived by the
61-
model; the final conclusion needs its own checker-bound verification record.
62+
When independent checking is requested, model-authored calculations or programs
63+
are not independent evidence. Use installed `VERIFY` when available. An artifact
64+
URI or checker summary is not a task-local verification-record file: never
65+
reconstruct or paraphrase such a record from returned fields. Claim `VERIFIED`
66+
only when the result has assurance level `VERIFIED`, exact record bytes, and
67+
required task authorization and bindings are preserved; otherwise use lower
68+
task-permitted assurance. Verification is bound to the exact checked claim: do
69+
not transfer `VERIFIED` from an input, premise, factorization, or related
70+
artifact to a model-derived conclusion, which needs its own checker-bound record.

0 commit comments

Comments
 (0)