菜单
Build, typecheck, and test the agentick monorepo. Use when asked to verify changes, run checks, or ensure nothing is broken.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Create a new agentick tool using createTool. Use when asked to add a tool, create a tool, or implement tool functionality.
Add a new package to the agentick monorepo. Use when creating a new @agentick/* package.
Create a new agentick lifecycle hook or custom hook. Use when asked to add a hook, create reactive behavior, or implement lifecycle logic.
Test an agentick agent with mock model responses. Use when asked to write tests, test an agent, or verify agent behavior.
Create a new model adapter for agentick. Use when asked to add support for a new model provider (Anthropic, Mistral, Cohere, etc).
Create a new agentick JSX component. Use when asked to add a component, create a UI primitive, or build a reusable agent building block.
| name | build-and-check |
| description | Build, typecheck, and test the agentick monorepo. Use when asked to verify changes, run checks, or ensure nothing is broken. |
After making changes, run the appropriate checks:
# Typecheck everything (fast, catches most issues)
pnpm typecheck
# Typecheck a specific package
pnpm --filter @agentick/core typecheck
pnpm --filter @agentick/kernel typecheck
# Run all tests
pnpm test
# Run tests for a specific package
pnpm --filter @agentick/core test
pnpm --filter @agentick/gateway test
# Run a single test file
pnpm vitest run packages/core/src/hooks/__tests__/knob.spec.ts
# Full build (slower, for publishing verification)
pnpm build
| Change | Command |
|---|---|
| Modified a type/interface | pnpm typecheck (ALL packages — structural typing) |
| Modified a single package | pnpm --filter @agentick/PACKAGE typecheck && pnpm --filter @agentick/PACKAGE test |
| Modified kernel or shared | pnpm typecheck && pnpm test (foundation packages affect everything) |
| Added a new export | pnpm typecheck |
| Before committing | pnpm typecheck && pnpm test |
| Before publishing | pnpm build && pnpm typecheck && pnpm test |
When modifying a TypeScript interface, always run full pnpm typecheck — not just the package you edited. Structural typing means anonymous object literals in other packages may implement your interface without explicitly referencing it.
Grep for the property name across all .ts files, not just the interface name:
# If you renamed or deleted a property called "eventBuffer":
grep -r "eventBuffer" packages/ --include="*.ts"
pnpm install fails with CodeArtifact error: Your ~/.npmrc may have a stale registry. Workaround:
NPM_CONFIG_REGISTRY=https://registry.npmjs.org pnpm install
Type error in a package you didn't touch: Likely a structural typing issue. Check if your interface change affects object literals elsewhere.
Test timeout: Default vitest timeout is 5s. For async agent tests, ensure cleanup() is called in afterEach.