instructions update

This commit is contained in:
John Lancaster
2026-08-27 18:54:49 -05:00
parent 8a994ff47b
commit 0638fe2fd7
+7 -4
View File
@@ -3,12 +3,15 @@
This repository is resource-first. This repository is resource-first.
- Canonical skill guidance lives in `docs/skills/<skill-id>/SKILL.md`. - Canonical skill guidance lives in `docs/skills/<skill-id>/SKILL.md`.
- The machine-facing skill contract is FastMCP's native `skill://` resource family. - Skills are exposed through FastMCP's native `skill://` resource family.
- Prompts are exposed through native MCP prompt operations (`prompts/list`, `prompts/get`).
- General documentation pages are exposed through `resource://docs/{path*}`.
- The server intentionally does not provide compatibility tool projections for resources or prompts.
When a task appears to match a documented implementation pattern in `personal-mcp`, use this sequence: When a task appears to match a documented implementation pattern in `personal-mcp`, use this sequence:
1. Prefer an already attached native skill resource. 1. Prefer an already attached native skill resource.
2. Otherwise browse native MCP resources and compare `skill://<name>/SKILL.md` descriptions. 2. Otherwise browse native MCP resources and compare available `skill://<name>/SKILL.md` descriptions.
3. Read the best matching main skill file, or at most 2 candidate main files. 3. Read the best matching main skill file, or at most 2 candidate main files.
4. Read `skill://<name>/_manifest` only when supporting material may be useful. 4. Read `skill://<name>/_manifest` only when supporting material may be useful.
5. Fetch only the relevant supporting paths from that manifest. 5. Fetch only the relevant supporting paths from that manifest.
@@ -29,7 +32,7 @@ Selection rules:
Repository-specific guidance: Repository-specific guidance:
- For tasks about adding or modifying a skill, use `skill://copilot-customization/SKILL.md` when relevant. - For tasks about adding or modifying a skill, use `skill://copilot-customization/SKILL.md` when relevant.
- Keep skills provider-native; do not add custom skill catalogs, per-skill resource modules, or skill-specific discovery tools. - Keep skills provider-native; do not add tool projections for resource or prompt access.
## Python Checks ## Python Checks
@@ -37,7 +40,7 @@ Repository-specific guidance:
After changes run these commands to confirm functionality. Resolve any errors After changes run these commands to confirm functionality. Resolve any errors
```python ```python
uv run ruff check uv run ruff check .
``` ```
```python ```python