AgentSkillsCN

better-context

通过扫描依赖项、推荐资源、创建 btca.config.jsonc、更新 AGENTS.md 并讲解使用方式，在项目中配置 btca（Better Context）。当被要求为某个仓库配置 btca/better-context 时使用。

SKILL.md
--- frontmatter
name: better-context
description: Set up btca (Better Context) in a project by scanning dependencies, proposing resources, creating btca.config.jsonc, updating AGENTS.md, and explaining usage modes. Use when asked to configure btca/better-context for a repo.

Better Context (btca) Setup

Set up btca for a project by scanning dependencies, proposing resources, and creating btca.config.jsonc with the approved list. Follow the confirmation steps exactly and update AGENTS.md based on the chosen usage mode.

Step 1: Scan dependencies

  • •Inspect the project root package.json (and lockfiles if needed) to identify frameworks, libraries, and tools worth adding as btca resources.
  • •Look for frameworks, backends, styling, tooling, and major libraries.

Step 2: Present the full resource list

  • •Show the complete list at once.
  • •Ask the user to confirm additions/removals.
  • •Use camelCase resource names (no hyphens).
  • •Wait for confirmation before preparing the config.

Step 3: Prepare the config (do not write yet)

  • •Draft btca.config.jsonc with $schema and all approved resources.
  • •Use sensible defaults for URL, branch, and searchPath/searchPaths when known.
  • •Show the full config to the user and ask for approval before writing.

Step 4: Create files after approval

  • •Create btca.config.jsonc in the project root.
  • •Add .btca to .gitignore (create the file if it does not exist).

Step 5: Ask for usage mode

Ask which mode the agent should follow:

  • •eager: use btca automatically when needed
  • •ask: ask the user before using btca
  • •lazy: only use btca when explicitly requested

Wait for the response before editing AGENTS.md.

Step 6: Update AGENTS.md

  • •If AGENTS.md exists, update or add a ## btca section without duplication.
  • •If it does not exist, create it with the btca section.
  • •Use the template that matches the chosen mode.
  • •Include the approved resource list and usage examples.

Step 7: Provide a summary

Include:

  1. •Configured resources (name, type, URL/path)
  2. •Config location (absolute path)
  3. •AGENTS.md status and chosen mode
  4. •Example btca commands for this project
  5. •Next steps:
    • •Resources clone to ~/.local/share/btca/resources/ on first use
    • •Use btca clear to remove cached repos
    • •If using Cursor: mkdir -p .cursor/rules && curl -fsSL "https://btca.dev/rule" -o .cursor/rules/better_context.mdc && echo "Rule file created."

Behavior rules

  • •Work in batches, not one-by-one.
  • •Only two confirmations: the resource list, then the prepared config.
  • •Do not write files before explicit approval.
  • •Do not add unapproved resources.
  • •Ask if any required detail (URL, branch, search path) is missing or ambiguous.