用途:帮助用户为 Claude.ai 上的指令选择正确格式——项目指令(Project instructions)、技能(Skill)还是独立提示词(standalone prompt),并按所选格式给出对应的结构建议。该技能负责“格式决策”,而 writing-instructions 负责“在某一格式内如何写好”;两者描述相近,按用户问的是哪类问题来路由。
主要能力:提供决策框架,通过信号判断格式归属。项目指令适用于上下文需在工作区所有对话中持续、多人协作共享知识、特定项目的背景知识或仅限单个项目的定制行为,信号如“for this project”“team workspace”。技能适用于跨多个上下文/项目复用的能力、广泛适用的程序性知识、应自动激活的指令、可按需加载的可移植专长,信号如“every time I”“reusable”“across projects”。独立提示词适用于带即时上下文的一次性请求、临时指令、对话式细化、无需持久化,信号如“for this task”“just this once”。还支持组合方式:项目指令+技能(持久上下文+可复用方法)、技能+提示词(通用专长+即时方向)。
核心优化原则:命令式表述(直接动作指令而非建议);正面指令表述(说明要做什么而非不做什么);给上下文和原因;策略优先于流程(给目标、成功标准、决策框架,仅当某一步骤是唯一安全路径如破坏性命令、鉴权流程、合规步骤时才写细步骤);信任基础行为(系统提示已覆盖引用、版权、安全、通用工具使用、对话语气、拒绝处理等,仅写项目/领域特有的偏离)。
格式专属:项目指令为系统提示的追加、聚焦工作区特定行为、命名需深入思考的领域、结构简单;技能采用渐进式披露(元数据→完整指令→打包资源),frontmatter 含 name 与触发模式 description,SKILL.md 保持在 500 行以内,详细领域内容放 references/;独立提示词需明确期望输出、必要时给上下文与示例、复杂度按需、允许表达不确定。
其他要点:示例质量需审计每个细节,宁缺毋滥;结构默认用标题和留白,仅复杂场景、内容边界需绝对确定或 API 工作流需结构化解析时才用 XML/JSON;思考深度不由提示词开关控制,模型默认自适应,深度由配置(API 的 effort 设置、Claude.ai 的 UI 控件)决定,指令只能指出哪些领域值得深入思考;复杂度和指令密度应随任务需求缩放。提供交付前的质量检查清单和常见错误清单。附带参考文件:references/creating-skills.md、references/project-instructions.md、references/standalone-prompts.md、references/skill-vs-project.md。限制:资料未提供收费、价格、平台支持范围等信息。