菜单
Author SYSTEM.md or APPEND_SYSTEM.md for pi coding agent. Use when extending the default system prompt with custom principles, guidelines, or project rules.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| name | pi-prompt-authoring |
| topic | Pi Prompt Authoring |
| description | Author SYSTEM.md or APPEND_SYSTEM.md for pi coding agent. Use when extending the default system prompt with custom principles, guidelines, or project rules. |
| token_cost | 350 |
| keywords | ["prompt","system","guideline","rule","principle","authoring"] |
Authors custom system prompt additions for pi coding agent. Pi provides a default system prompt with identity, tools, and guidelines. This skill covers what to add via SYSTEM.md (replace default) or APPEND_SYSTEM.md (extend default).
Pi builds the system prompt dynamically: identity → tools → guidelines → docs → append → context → skills → metadata.
SYSTEM.md replaces the default. APPEND_SYSTEM.md extends it.
Locations: .pi/SYSTEM.md (project), ~/.pi/agent/SYSTEM.md (global), or --system-prompt (CLI).
See detailed prompt structure for full construction order, tool listing, skills format, and context file loading.
Define coding standards and architectural preferences. Common categories: simplicity, code quality, codebase health, build verification, security.
See example principles for working examples.
Enforce specific behaviors: debugging, architecture, testing, scope, error handling, documentation, user directives.
See example guidelines for working examples.
Add usage patterns for custom tools from extensions. Built-in tools are auto-documented.
See example tool guidelines for working examples.
Add project conventions not covered by AGENTS.md/CLAUDE.md.
See example project context for working examples.
Use APPEND_SYSTEM.md for extensions: Don't replace pi's default unless necessary. Append custom principles to preserve built-in functionality.
Use SYSTEM.md for replacements: Only if you need to fundamentally change pi's behavior.
XML tags for organization: Use <section_name> tags to organize principles logically.
Concise, value-based rules: "Scope is sacred" not "When asked to do X, only touch files that Y".
No procedural details: Avoid code snippets, variable names, or step-by-step scenarios.
Before finalizing:
SYSTEM.md (replace) or APPEND_SYSTEM.md (extend)Renders markdown to self-contained HTML with a custom dark stylesheet and opens in browser. Use when previewing markdown documents, generating styled HTML from README or report files.
Inform the user what is happening — skip passive lookups
Manage version control with Jujutsu (jj) — no staging area, immediate changes, smart rebasing. Use when navigating history, squashing, or pushing to Git remotes.
Programmatic hunk selection for Jujutsu — split, commit, or squash specific hunks without interactive prompts. Use when making partial commits or selective squashes.
Gather facts from the web using evidence-first approach with mandatory citations. Use when researching topics, answering factual questions, or any task requiring web-sourced evidence.
Model minimum-move problems as BFS over a state space. Use when solving bucket pouring puzzles, sliding tiles, or any problem asking for the shortest sequence of moves to reach a goal.