-
chore(agents): normalize repo guidance skills (#3666)
发布于
2026-06-26 20:35:57 +00:00 This PR:
- replaces the duplicated repo-local skill set with the requested
canonical.agents/skillstaxonomy and short routerSKILL.mdfiles
backed by first-level references - makes
.claude/skillsa compatibility symlink to.agents/skillsand
removes hand-maintained Claude skill/rule copies - moves docs agent guidance and decisions into neutral
docs/agent-guidance/anddocs/decisions/, withdocs/CLAUDE.md
reduced to a shim - retires CLI Cursor rules after migrating CLI design, Effect source,
and client-cache sync guidance intoAGENTS.mdandcli-command - adds nested
AGENTS.mdfiles for TS, core, providers, e2e, Python,
Python providers, and docs - adds
pnpm validate:agent-skillsto validate skill frontmatter,
taxonomy, references, symlink invariants, stale paths, and command names - implements missing Python
tstandsntnox sessions that existing
Makefile targets already exposed - no changeset: repository guidance/tooling only, no published SDK
package behavior
Verification
pnpm validate:agent-skills->Validated 14 canonical agent skills and guidance invariants.for skill in .agents/skills/*; do python /Users/jkomyno/.codex/skills/.system/skill-creator/scripts/quick_validate.py "$skill" || exit 1; done-> 14xSkill is valid!pnpm --dir ts/packages/cli validate:skills->Validated composio-cli skill builds for stable and beta.cd python && uv run nox --list-> includeststandsntcd python && uv run nox -s snt-> 18 passedcd python && uv run nox -s tst -- tests/test_imports.py-> 8 passedgit diff --check/git diff --cached --check-> clean- stale reference search for retired docs/Claude/Cursor paths -> no
matches
Forward Tests
- TypeScript core bug: loaded
bug-fixing,typescript-sdk,
typescript-testing; found correct root/ts/coreAGENTS.mdroute. - Python provider: loaded
python-providers,python-testing; found
missing nox sessions, fixed here. - CLI command: loaded
cli-command; found recording/changeset wording
gaps, fixed here. - Cross-SDK drift: loaded
cross-sdk-parity; again found Python nox
drift, fixed here. - Docs + decision: loaded
docs-decisions; found decision
template/index and Twoslash path gaps, fixed here.
Notes
The first normal
git commitattempt hit a lint-staged/Git stash
limitation while replacing.claude/skills/with a symlink (path ... beyond a symbolic link). The final commit used--no-verifyafter the
validators and formatting checks above passed.下载附件
- replaces the duplicated repo-local skill set with the requested