bstack
Install or upgrade the bundled bstack collection when the user asks to set up or update bstack in a project.
- License 许可
- MIT
- 最近更新
- 2026-11-11
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- bstack
- metadata
- { "package": "bstack" }
- description
- Install or upgrade the bundled bstack collection when the user asks to set up or update bstack in a project.
02 资源文件 270
- 资产文件assets/compatibility.svg5.9 KB
- 资产文件assets/workflow.svg2.1 KB
- 参考文档ATTRIBUTION.md9.3 KB
- 参考文档engineering/architect/agents/openai.yaml43 B
- 参考文档engineering/architect/INSTRUCTIONS.md5.6 KB
- 参考文档engineering/architect/references/design-red-flags.md2.3 KB
- 参考文档engineering/architect/references/rationale-template.md3.4 KB
- 参考文档engineering/architect/references/runner-prompt.md3.4 KB
- 参考文档engineering/arena/agents/openai.yaml43 B
- 参考文档engineering/arena/INSTRUCTIONS.md4.9 KB
- 参考文档engineering/automate-me/agents/openai.yaml42 B
- 参考文档engineering/automate-me/INSTRUCTIONS.md2.0 KB
- 参考文档engineering/blast-radius/agents/openai.yaml43 B
- 参考文档engineering/blast-radius/INSTRUCTIONS.md4.3 KB
- 参考文档engineering/bro/agents/openai.yaml43 B
- 参考文档engineering/bro/INSTRUCTIONS.md659 B
- 参考文档engineering/control-cli/agents/openai.yaml43 B
- 参考文档engineering/control-cli/INSTRUCTIONS.md4.6 KB
- 参考文档engineering/control-ui/agents/openai.yaml43 B
- 参考文档engineering/control-ui/INSTRUCTIONS.md5.1 KB
- 参考文档engineering/create-verification-skill/agents/openai.yaml42 B
- 参考文档engineering/create-verification-skill/computer-use/DRIVERS.md2.3 KB
- 参考文档engineering/create-verification-skill/computer-use/README.md8.7 KB
- 参考文档engineering/create-verification-skill/computer-use/templates/HANDOFF.md2.4 KB
- 参考文档engineering/create-verification-skill/computer-use/templates/PROBES.md1.9 KB
- 参考文档engineering/create-verification-skill/computer-use/templates/REPORT.md1.0 KB
- 参考文档engineering/create-verification-skill/computer-use/templates/TOOL-SCRIPT.md2.0 KB
- 参考文档engineering/create-verification-skill/INSTRUCTIONS.md4.9 KB
- 脚本engineering/create-verification-skill/scripts/bind.py3.5 KB
- 脚本engineering/create-verification-skill/scripts/evidence.py3.8 KB
- 参考文档engineering/deslop/agents/openai.yaml43 B
- 参考文档engineering/deslop/INSTRUCTIONS.md1.1 KB
- 参考文档engineering/figure-it-out/agents/openai.yaml43 B
- 参考文档engineering/figure-it-out/INSTRUCTIONS.md4.7 KB
- 参考文档engineering/how/agents/openai.yaml42 B
- 参考文档engineering/how/INSTRUCTIONS.md3.1 KB
- 参考文档engineering/how/references/explainer-prompt.md3.4 KB
- 参考文档engineering/how/references/explorer-prompt.md3.0 KB
- 参考文档engineering/implement/agents/openai.yaml43 B
- 参考文档engineering/implement/INSTRUCTIONS.md4.0 KB
- 参考文档engineering/interrogate/agents/openai.yaml43 B
- 参考文档engineering/interrogate/INSTRUCTIONS.md5.2 KB
- 参考文档engineering/interrogate/references/code-quality-review.md5.6 KB
- 参考文档engineering/interrogate/references/lead-judgment.md3.8 KB
- 参考文档engineering/interrogate/references/reviewer-prompt.md3.1 KB
- 参考文档engineering/interrogate/references/rubric.md5.4 KB
- 参考文档engineering/maintain-verification-skill/agents/openai.yaml43 B
- 参考文档engineering/maintain-verification-skill/INSTRUCTIONS.md2.6 KB
- 参考文档engineering/no-comments/agents/openai.yaml43 B
- 参考文档engineering/no-comments/INSTRUCTIONS.md1.6 KB
- 参考文档engineering/poteto-mode/agents/openai.yaml43 B
- 参考文档engineering/poteto-mode/INSTRUCTIONS.md1.1 KB
- 参考文档engineering/poteto-mode/playbooks/authoring-a-skill.md1.2 KB
- 参考文档engineering/poteto-mode/playbooks/autonomous-run.md2.2 KB
- 参考文档engineering/poteto-mode/playbooks/bug-fix.md2.7 KB
- 参考文档engineering/poteto-mode/playbooks/eval.md2.9 KB
- 参考文档engineering/poteto-mode/playbooks/feature.md3.3 KB
- 参考文档engineering/poteto-mode/playbooks/hillclimb.md4.4 KB
- 参考文档engineering/poteto-mode/playbooks/investigation.md1.3 KB
- 参考文档engineering/poteto-mode/playbooks/pause-safely.md1.5 KB
- 参考文档engineering/poteto-mode/playbooks/perf-issue.md3.4 KB
- 参考文档engineering/poteto-mode/playbooks/refactoring.md3.6 KB
- 参考文档engineering/poteto-mode/playbooks/runtime-forensics.md1.6 KB
- 参考文档engineering/poteto-mode/playbooks/session-pickup.md2.0 KB
- 参考文档engineering/poteto-mode/playbooks/trace-forensics.md2.2 KB
- 参考文档engineering/poteto-mode/playbooks/visual-parity.md1.6 KB
- 参考文档engineering/poteto-mode/WORKFLOW.md15.9 KB
- 参考文档engineering/principles/principle-attack-the-premise/WORKFLOW.md2.3 KB
- 参考文档engineering/principles/principle-boundary-discipline/WORKFLOW.md2.2 KB
- 参考文档engineering/principles/principle-build-the-lever/WORKFLOW.md2.8 KB
- 参考文档engineering/principles/principle-encode-lessons-in-structure/WORKFLOW.md2.5 KB
- 参考文档engineering/principles/principle-exhaust-the-design-space/WORKFLOW.md1.5 KB
- 参考文档engineering/principles/principle-experience-first/WORKFLOW.md1.5 KB
- 参考文档engineering/principles/principle-fix-root-causes/WORKFLOW.md1.6 KB
- 参考文档engineering/principles/principle-foundational-thinking/WORKFLOW.md1.9 KB
- 参考文档engineering/principles/principle-guard-the-context-window/WORKFLOW.md1.4 KB
- 参考文档engineering/principles/principle-laziness-protocol/WORKFLOW.md1.7 KB
- 参考文档engineering/principles/principle-make-operations-idempotent/WORKFLOW.md1.7 KB
- 参考文档engineering/principles/principle-migrate-callers-then-delete-legacy-apis/WORKFLOW.md1.5 KB
- 参考文档engineering/principles/principle-minimize-reader-load/WORKFLOW.md2.4 KB
- 参考文档engineering/principles/principle-model-the-domain/WORKFLOW.md2.4 KB
- 参考文档engineering/principles/principle-never-block-on-the-human/WORKFLOW.md1.7 KB
- 参考文档engineering/principles/principle-outcome-oriented-execution/WORKFLOW.md1.5 KB
- 参考文档engineering/principles/principle-prove-it-works/WORKFLOW.md2.2 KB
- 参考文档engineering/principles/principle-redesign-from-first-principles/WORKFLOW.md1.2 KB
- 参考文档engineering/principles/principle-separate-before-serializing-shared-state/WORKFLOW.md1.9 KB
- 参考文档engineering/principles/principle-sequence-verifiable-units/WORKFLOW.md2.4 KB
- 参考文档engineering/principles/principle-subtract-before-you-add/WORKFLOW.md1.5 KB
- 参考文档engineering/principles/principle-test-behavior-not-implementation/WORKFLOW.md2.9 KB
- 参考文档engineering/principles/principle-type-system-discipline/WORKFLOW.md5.2 KB
- 参考文档engineering/prototype/agents/openai.yaml42 B
- 参考文档engineering/prototype/INSTRUCTIONS.md1.6 KB
- 参考文档engineering/prototype/references/logic.md976 B
- 参考文档engineering/prototype/references/ui.md1.2 KB
- 参考文档engineering/prototype/WORKFLOW.md4.7 KB
- 参考文档engineering/recall/agents/openai.yaml42 B
- 参考文档engineering/recall/INSTRUCTIONS.md1.4 KB
- 参考文档engineering/reflect/agents/openai.yaml42 B
- 参考文档engineering/reflect/INSTRUCTIONS.md1.5 KB
- 参考文档engineering/research/agents/openai.yaml43 B
- 参考文档engineering/research/INSTRUCTIONS.md2.1 KB
- 参考文档engineering/resolve-pr/agents/openai.yaml42 B
- 参考文档engineering/resolve-pr/INSTRUCTIONS.md5.2 KB
- 参考文档engineering/resolve-pr/references/github.md2.8 KB
- 脚本engineering/resolve-pr/scripts/feedback.py15.8 KB
- 参考文档engineering/review-pr/agents/openai.yaml42 B
- 参考文档engineering/review-pr/INSTRUCTIONS.md8.0 KB
- 参考文档engineering/review-pr/references/adjudicator.md6.2 KB
- 参考文档engineering/review-pr/references/reviewer.md3.6 KB
- 参考文档engineering/review-pr/references/rubric.md5.1 KB
- 参考文档engineering/review-pr/references/running.md14.2 KB
- 参考文档engineering/review-pr/references/security.md6.5 KB
- 脚本engineering/review-pr/scripts/artifacts.py3.6 KB
- 脚本engineering/review-pr/scripts/browsing_eval.py11.8 KB
- 脚本engineering/review-pr/scripts/budget.py1.6 KB
- 脚本engineering/review-pr/scripts/contracts.py10.2 KB
- 脚本engineering/review-pr/scripts/host.py11.9 KB
- 脚本engineering/review-pr/scripts/models.py15.8 KB
- 脚本engineering/review-pr/scripts/preflight.py10.3 KB
- 脚本engineering/review-pr/scripts/publication.py25.0 KB
- 脚本engineering/review-pr/scripts/repo_browser.py19.5 KB
- 脚本engineering/review-pr/scripts/restricted_cli.py5.7 KB
- 脚本engineering/review-pr/scripts/review.py32.1 KB
- 脚本engineering/review-pr/scripts/runtime_verification.py12.6 KB
- 脚本engineering/review-pr/scripts/security_eval.py5.6 KB
- 脚本engineering/review-pr/scripts/security.py7.6 KB
- 脚本engineering/review-pr/scripts/shared.py8.3 KB
- 脚本engineering/review-pr/scripts/worker_canary.py1.2 KB
- 参考文档engineering/show-me-your-work/agents/openai.yaml43 B
- 参考文档engineering/show-me-your-work/INSTRUCTIONS.md5.7 KB
- 其他engineering/show-me-your-work/references/decision-log-template.tsv38 B
- 脚本engineering/show-me-your-work/scripts/log.sh1.2 KB
- 参考文档engineering/swarm/agents/openai.yaml43 B
- 参考文档engineering/swarm/INSTRUCTIONS.md2.5 KB
- 参考文档engineering/tdd/agents/openai.yaml43 B
- 参考文档engineering/tdd/INSTRUCTIONS.md3.8 KB
- 参考文档engineering/teach/agents/openai.yaml43 B
- 参考文档engineering/teach/INSTRUCTIONS.md5.9 KB
- 参考文档engineering/technical-writing/agents/openai.yaml43 B
- 参考文档engineering/technical-writing/INSTRUCTIONS.md11.1 KB
- 参考文档engineering/to-pr/agents/openai.yaml42 B
- 参考文档engineering/to-pr/INSTRUCTIONS.md10.5 KB
- 参考文档engineering/to-pr/references/publishing.md10.4 KB
- 参考文档engineering/to-pr/references/visuals.md4.6 KB
- 参考文档engineering/typescript-best-practices/agents/openai.yaml43 B
- 参考文档engineering/typescript-best-practices/INSTRUCTIONS.md3.0 KB
- 参考文档engineering/typescript-best-practices/references/patterns.md9.1 KB
- 参考文档engineering/why/agents/openai.yaml42 B
- 参考文档engineering/why/INSTRUCTIONS.md10.1 KB
- 参考文档engineering/why/references/epistemics.md8.0 KB
- 参考文档engineering/why/references/investigator-prompt.md7.2 KB
- 参考文档engineering/why/references/source-playbook.md1.7 KB
- 参考文档engineering/why/references/sources/code-archaeology.md3.8 KB
- 参考文档engineering/why/references/sources/databricks.md7.2 KB
- 参考文档engineering/why/references/sources/datadog.md5.6 KB
- 参考文档engineering/why/references/sources/incident-postmortem.md2.3 KB
- 参考文档engineering/why/references/sources/linear.md3.3 KB
- 参考文档engineering/why/references/sources/notion.md3.2 KB
- 参考文档engineering/why/references/sources/sentry.md5.2 KB
- 参考文档engineering/why/references/sources/slack.md3.4 KB
- 参考文档engineering/why/references/synthesizer-prompt.md8.2 KB
- 参考文档engineering/worktree-cleanup/agents/openai.yaml42 B
- 参考文档engineering/worktree-cleanup/INSTRUCTIONS.md1.2 KB
- 脚本engineering/worktree-cleanup/scripts/audit.py2.5 KB
- 脚本github/pr.py43.9 KB
- 参考文档github/pull_request_template.md1.8 KB
- 参考文档index.json7.9 KB
- 参考文档layers.json20.7 KB
- 许可证LICENSE1.0 KB
- 参考文档manifest.json120.6 KB
- 参考文档README.md17.7 KB
- 脚本runtime/amp-plugin.ts2.1 KB
- 脚本runtime/opencode-plugin-v2.js2.1 KB
- 脚本runtime/opencode-plugin.js2.3 KB
- 脚本runtime/reminder.py9.0 KB
- 参考文档runtime/reminder.txt407 B
- 脚本scripts/bstack.py62.5 KB
- 参考文档sdlc/domain-modeling/ADR-FORMAT.md1.4 KB
- 参考文档sdlc/domain-modeling/agents/openai.yaml43 B
- 参考文档sdlc/domain-modeling/CONTEXT-FORMAT.md1.2 KB
- 参考文档sdlc/domain-modeling/INSTRUCTIONS.md2.0 KB
- 参考文档sdlc/grill-me/agents/openai.yaml43 B
- 参考文档sdlc/grill-me/INSTRUCTIONS.md514 B
- 参考文档sdlc/grill-with-docs/agents/openai.yaml43 B
- 参考文档sdlc/grill-with-docs/INSTRUCTIONS.md694 B
- 参考文档sdlc/grilling/agents/openai.yaml43 B
- 参考文档sdlc/grilling/INSTRUCTIONS.md2.6 KB
- 参考文档sdlc/to-questionnaire/agents/openai.yaml43 B
- 参考文档sdlc/to-questionnaire/INSTRUCTIONS.md1.6 KB
- 参考文档sdlc/to-spec/agents/openai.yaml43 B
- 参考文档sdlc/to-spec/INSTRUCTIONS.md2.6 KB
- 参考文档sdlc/to-tickets/agents/openai.yaml43 B
- 参考文档sdlc/to-tickets/INSTRUCTIONS.md3.1 KB
- 参考文档sdlc/triage/AGENT-BRIEF.md1.5 KB
- 参考文档sdlc/triage/agents/openai.yaml42 B
- 参考文档sdlc/triage/INSTRUCTIONS.md4.0 KB
- 参考文档sdlc/triage/OUT-OF-SCOPE.md1.6 KB
- 参考文档sdlc/wayfinder/agents/openai.yaml43 B
- 参考文档sdlc/wayfinder/INSTRUCTIONS.md5.5 KB
- 脚本shared/adr.py13.6 KB
- 参考文档shared/bstack-auto/agents/openai.yaml43 B
- 参考文档shared/bstack-auto/INSTRUCTIONS.md1.6 KB
- 参考文档shared/bstack-guide/agents/openai.yaml42 B
- 参考文档shared/bstack-guide/assets/overview.html83.7 KB
- 参考文档shared/bstack-guide/INSTRUCTIONS.md2.7 KB
- 参考文档shared/bstack-guide/references/routes.md2.1 KB
- 参考文档shared/bstack-guide/references/walkthrough.md3.4 KB
- 参考文档shared/configure-pr/agents/openai.yaml42 B
- 参考文档shared/configure-pr/INSTRUCTIONS.md2.4 KB
- 脚本shared/github/attribution_hosts.py7.6 KB
- 脚本shared/github/attribution.py6.1 KB
- 脚本shared/github/pr_guard.py6.5 KB
- 参考文档shared/handoff/agents/openai.yaml43 B
- 参考文档shared/handoff/INSTRUCTIONS.md3.1 KB
- 参考文档shared/memory/policy.md1.2 KB
- 参考文档shared/memory/references/installation.md3.4 KB
- 参考文档shared/memory/references/native-interfaces.md13.6 KB
- 脚本shared/memory/scripts/activation.py10.6 KB
- 脚本shared/memory/scripts/cursor_context.py3.8 KB
- 脚本shared/memory/scripts/cursor_hooks.py3.4 KB
- 脚本shared/memory/scripts/cursor_projection.py3.2 KB
- 脚本shared/memory/scripts/layout.py2.1 KB
- 脚本shared/memory/scripts/memory_files.py6.2 KB
- 脚本shared/memory/scripts/native_backends.py17.7 KB
- 脚本shared/memory/scripts/portable.py24.8 KB
- 脚本shared/memory/scripts/sync.py9.7 KB
- 参考文档shared/memory/WORKFLOW.md8.6 KB
- 脚本shared/model_cli.py19.1 KB
- 脚本shared/pr_policy.py6.2 KB
- 参考文档shared/references/architecture-decisions.md7.1 KB
- 参考文档shared/references/baseline-agents.md1.7 KB
- 参考文档shared/references/decision-authority.md5.6 KB
- 参考文档shared/references/pr-policy-template.md108 B
- 参考文档shared/references/pr-standards.md5.2 KB
- 参考文档shared/references/setup-requirements.md4.5 KB
- 参考文档shared/references/verification-policy.md2.3 KB
- 参考文档shared/references/work-adapters.md2.8 KB
- 参考文档shared/references/workspace-requests.md6.6 KB
- 参考文档shared/references/workspace.md3.7 KB
- 参考文档shared/router/references/capabilities.md4.1 KB
- 参考文档shared/router/WORKFLOW.md14.2 KB
- 脚本shared/session_history.py10.5 KB
- 参考文档shared/setup-bstack/agents/openai.yaml43 B
- 参考文档shared/setup-bstack/INSTRUCTIONS.md7.4 KB
- 参考文档shared/unslop/agents/openai.yaml42 B
- 参考文档shared/unslop/INSTRUCTIONS.md8.1 KB
- 参考文档shared/verify-bstack/agents/openai.yaml43 B
- 参考文档shared/verify-bstack/INSTRUCTIONS.md3.0 KB
- 脚本shared/verify-bstack/scripts/codex_hooks.py4.7 KB
- 脚本shared/verify-bstack/scripts/compact.py7.6 KB
- 脚本shared/verify-bstack/scripts/fallback.py11.6 KB
- 脚本shared/verify-bstack/scripts/installation.py35.0 KB
- 脚本shared/verify-bstack/scripts/policy.py24.1 KB
- 脚本shared/verify-bstack/scripts/test_policy.py7.2 KB
- 脚本shared/verify-bstack/scripts/verify.py14.2 KB
- 脚本shared/workflow.py10.8 KB
- 脚本workspace/assets/app.js410.8 KB
- 参考文档workspace/assets/app.js.LEGAL.txt1.7 KB
- 参考文档workspace/assets/index.html368 B
- 其他workspace/assets/style.css47.5 KB
- 参考文档workspace/assets/THIRD_PARTY_NOTICES.txt19.6 KB
- 脚本workspace/cli.py3.9 KB
- 参考文档workspace/OPERATIONS.md16.3 KB
- 参考文档workspace/README.md8.1 KB
- 脚本workspace/wayfinder/__init__.py81 B
- 脚本workspace/wayfinder/core.py38.6 KB
- 脚本workspace/wayfinder/kanban.py29.9 KB
- 脚本workspace/wayfinder/migration.py2.1 KB
- 脚本workspace/wayfinder/requests.py9.3 KB
- 脚本workspace/wayfinder/server.py6.3 KB
03 SKILL.md 正文
Install bstack
This folder is the complete bstack 3.4.0 release. Keep its scripts, workflows, references, manifest, and license notices together. Bundled workflow bodies use INSTRUCTIONS.md, so only this installer appears before setup creates the project skills. It needs Python 3.11 or newer; no archive extraction or upstream download is required.
Target the Git repository containing the work. Resolve it with git rev-parse --show-toplevel, even if this installer lives elsewhere. Resolve scripts/bstack.py relative to this skill folder, choose an available Python 3.11+ interpreter, then run:
<python3.11-or-newer> <installed-bstack>/scripts/bstack.py install --project <project-root>
For a new installation, pass --hosts with the requested or available tools, including the current host: codex, claude, cursor, grok, amp, copilot, opencode. The default selects the first four. On upgrade, omit the flag to preserve the existing selection. New projects default to --auto on and --verification ask; upgrades preserve those settings unless explicitly changed.
Setup validates the complete manifest and selected interpreter before installing a private copy at .bstack/package/. It saves that interpreter for generated hooks. Keep the interpreter available; rerun setup with another supported interpreter to repair or change it. Respect ownership conflicts. Do not move or delete another installer's skills to force setup through. The installed package works after this distributor-owned folder is removed.
Run the installed controller's doctor with the same supported interpreter:
<python3.11-or-newer> <project-root>/.bstack/package/scripts/bstack.py doctor --project <project-root>
Doctor checks package integrity, owned bindings, and actual hook command startup. Native host loading, Codex trust, and delivery still need a fresh session in the target checkout. Follow the setup result's fresh_session_required and notice; a later status check does not clear that requirement. In Claude desktop, open a new Code chat rooted in the project. Installing in a parent repository does not configure a child repository.
Every developer runs setup in their own checkout. Commit portable AGENTS.md, CLAUDE.md, .gitignore, and a newly created PR template if desired. Generated skills, runtime state, and adapters belong to the checkout. The stable .bstack/ block and shared generated-path policy have separate ownership. Shared visibility exceptions survive setup, and uninstall preserves that policy. Review sharing for policy maintenance and visible or tracked generated paths; preserve unrelated configuration in mixed host settings.
Report auto, verification, pr_template, and any recovery_warning from setup. Existing PR templates stay unchanged; only replace a chosen template when requested. Codex's explicit hooks-off setting blocks automatic setup; the user can enable hooks or choose --auto off, which leaves its native guard unavailable. After successful doctor, suggest bstack-guide in the fresh session. Optional user-wide memory setup remains separate and requires its own request. Use the installed setup instructions for later configuration and optional setup.
04 同仓库更多 Skills
why
Use for 'why does X work this way', 'why we picked Y', design rationale, regressions, postmortems, or data-backed thresholds. Discovers available MCPs and queries each evidence category (source control, issue tracker, long-form docs, real-time chat, infrastructure observability, error tracking, product analytics warehouse) in parallel, then returns a cited read on decisions and tradeoffs. Use how for runtime behavior.
unslop
Cut AI tells from any writing. Must always apply.
typescript-best-practices
TypeScript best practices. Use when reading or editing any .ts or .tsx file.
technical-writing
Layered technical-writing standard: Diátaxis structure, Google developer style sentences, STE instruction rules, Global English syntax. Use for /technical-writing or when writing or reviewing docs, RFCs, readmes, PR descriptions, or commit messages.
teach
Explain a body of work plainly so a person actually understands it. Runs the `how` and `why` skills and weaves what they find into one clear explanation. Use for 'teach me this', 'help me really understand X', 'explain this change or subsystem to me'.
tdd
Use only when the user explicitly asks for TDD, a failing test, or a regression test, OR when the bug has an obvious cheap local test target. Skip when the test path is unclear, expensive, integration-heavy, or not requested.