Agent Skill 蓝图模板
为上下文工程技能提供可复用的结构、边界和质量检查框架。
模板要求明确所有权边界、激活条件、禁止激活范围、依赖引用及限制说明，并提示数值声明需有来源；因此主要安全与范围风险可见。但它没有提供具体权限、敏感数据处理、用户确认、外部副作用、回滚或数据流控制，故扣分。
结构和写作要求内部基本一致，且包含可执行指导、示例和故障陷阱等栏目。但正文充满占位符，引用文件也是存根，没有针对任何真实技能的可复现关键路径、异常输入处理或失败反馈；按静态评估限制仅给低分。
模板明确面向创建上下文工程 Agent Skill，并要求写明受众、触发条件及相邻技能的非适用范围，支持较准确的语义触发。但实际能力边界、输入输出契约、平台适配以及中文和中国大陆网络环境均未定义，故扣分。
信息架构较完整，包含渐进披露、实践指导、示例、指南、陷阱、集成、引用和元数据栏目；仓库还提供 MIT 许可证。模板本身仍有大量占位内容，版本、日期、作者、维护责任、变更记录和更新路径未落实，引用存根也要求后续替换，故未给高分。
作为写作脚手架，它能指导作者补齐技能的触发、内容、示例和维护信息，具有一定直接价值。但当前文件不是可直接执行或完成用户任务的真实技能，输出仍需大量填充和验证，且没有证明相对手工编写的增益，故低分。
文件给出了可检查的结构性要求，例如行数限制、元数据、示例、引用和 claim ID；仓库上下文还展示了测试与 CI，但这些并未覆盖该模板作为技能的关键行为。没有第三方执行证据或独立复现材料，因此仅给有限分数。
- 这是未填充的技能模板，不应直接安装或当作可执行技能使用。
- 引用文件仍是存根；创建真实技能时必须替换或移除链接，并补充可核查来源。
- 模板没有规定具体权限、敏感数据、外部调用、用户确认或回滚策略，使用者必须为实际技能单独设计这些控制。
- 仓库 README 中的测试、基准和性能声明不等同于该模板已通过对应验证。
这个 Skill 能做什么，适合哪些场景？
这是一个用于创建新 Agent Skill 的 Markdown 模板，面向上下文工程相关技能集合。它规定了技能描述、激活条件、核心概念、实践指导、示例、指南、陷阱、集成和元数据等章节。模板强调明确技能所有权边界、渐进式披露，以及将详细内容移入 references/目录。它适合希望按统一格式编写技能的人，但本身不提供具体领域能力。
提供带有 name 和 description YAML 前置元数据的 SKILL.md 章节骨架；指导作者定义激活条件、相邻技能的排除范围、核心概念、详细主题、实践工作流、示例、可验证指南、常见陷阱、集成关系、引用和版本元数据；提醒将技能正文控制在 500 行以内，并在需要时使用 references/目录。
- 负责维护技能集合的开发者，需要按统一结构新增上下文工程技能时。
- 需要为新技能定义明确激活边界并避免与相邻技能重叠的作者。
- 希望把复杂参考材料从主技能正文中拆分出去的维护者。
- 需要为技能补充示例、可执行检查清单和失败模式说明的技术作者。
这个 Skill 有哪些优点和局限？
- 结构完整，覆盖从发现和激活到集成、引用和版本管理的主要章节。
- 强调技能边界、渐进式披露和可执行指导，有助于保持技能集合的一致性。
- 明确要求提供示例、指南和 gotchas，便于编写可检查的技能内容。
- 模板本身不包含具体上下文工程方法或可直接执行的脚本。
- SKILL.md 仍是占位式骨架，作者必须自行补充全部主题、示例、引用和元数据。
- 源材料没有提供 template/技能的独立测试结果或专属安装流程。
如何安装这个 Skill？
README 说明该仓库按目录形式安装技能，而不是将 SKILL.md 展平成单文件；可将目标技能目录复制到宿主的技能目录，例如 .codex/skills/ 或 .agents/skills/。仓库没有提供专门安装 template/技能的命令；集合级 Claude Code 安装方式是先添加 marketplace，再安装 context-engineering 插件。
如何使用这个 Skill？
将 template/目录作为新技能目录的起点，填写名称、描述和各章节内容。触发示例：创建一个用于某项上下文工程任务的新 Agent Skill，并定义它的激活条件、相邻技能排除范围、实践指南和常见陷阱。模板要求使用第三人称描述，并明确技能拥有的工作范围。