菜单
Workflow for picking up and implementing a Linear issue for Context Keeper. Use when starting work on an FZ-* issue, creating a feature branch, or following the project's branching and issue workflow.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Add a new trait to context-keeper-core with a mock implementation. Use when adding a new abstraction, capability, or extension point to the core crate.
Add a new MCP tool to the Context Keeper server. Use when adding a tool, implementing a new MCP capability, or extending the server's tool surface.
Start the Context Keeper MCP server locally for testing. Use when the user wants to run the stack, test MCP tools end-to-end, verify a build, smoke-test changes, or needs a live server to interact with.
Run the full Context Keeper test suite and diagnose failures. Use when the user asks to run tests, check if tests pass, verify changes didn't break anything, or troubleshoot test failures.
| name | work-on-linear-issue |
| description | Workflow for picking up and implementing a Linear issue for Context Keeper. Use when starting work on an FZ-* issue, creating a feature branch, or following the project's branching and issue workflow. |
FZ-*feat/prototype-v1feat/prototype-v1Use the Linear MCP tools to fetch issue details:
linear: get_issue(issueId: "FZ-XX")
Read the issue description, acceptance criteria, and linked issues. Cross-reference with:
docs/internal/ROADMAP.md for sequencing contextdocs/internal/plans/ for detailed level plansdocs/internal/ADR-001-architecture-review.md for architectural guidancegit checkout feat/prototype-v1
git pull origin feat/prototype-v1
git checkout -b feat/fz-XX-short-description
Branch naming: feat/fz-XX-short-description (e.g., feat/fz-12-memory-updates).
Check the roadmap's "Touches" section for each issue. Common patterns:
| Issue area | Crates typically affected |
|---|---|
| Extraction quality | core (pipeline), rig (prompts/extraction) |
| Entity management | core (models), surreal (repository), rig (extraction) |
| Search improvements | core (search/engine), surreal (vector_store) |
| New MCP capability | mcp (tools), possibly core |
| Temporal features | core (temporal), surreal (repository) |
Follow the crate conventions from the project rules. Key files:
crates/context-keeper-core/src/ingestion/pipeline.rscrates/context-keeper-core/src/search/engine.rscrates/context-keeper-rig/src/extraction.rscrates/context-keeper-surreal/src/repository.rscrates/context-keeper-mcp/src/tools.rscargo test # Full suite
cargo test -p context-keeper-test # Integration tests
feat/prototype-v1Closes FZ-XX