Agnostic Prompt Standard (APS) v1.0 技能
一套参考框架,用于生成、编译和校验符合 Agnostic Prompt Standard v1.0 规范的全新提示词。
纯文档型技能,无脚本执行、无外部副作用、无敏感数据处理要求,MIT 许可;但元数据声称作者为 Christopher Buckley 并指向 chris-buckley/agnostic-prompt-standard 仓库,而宿主仓库是 jsburckhardt 的派生,来源归属链未经核实,且发布者未经验证;references/ 规范文档未在本次证据中提供,无法确认隐私与日志章节(06-logging-and-privacy)的实际内容,故中等偏上但不满分。
SKILL.md 是结构性入口文档,内部链接布局自洽,assets 示例(常量块、格式契约)语法一致、命名规范统一;但 skills 声称的 lint/compile 能力依赖 scripts/ 目录(声明为默认为空),核心 references/ 文档未提供,无法静态确认关键路径可复现;CI 测试仅覆盖 devcontainer features,与本技能无关。扣分点:关键规范文件缺失、无可执行的错误反馈路径。
目标场景清晰(生成、编译、检查符合 APS v1.0 的提示词),入口文档明确了规范性与非规范性材料的边界,提供多平台适配器与模板;但触发条件、不适用范围、中文支持情况均未声明,且实际可用性取决于未提供的 references/ 内容。扣分点:边界与触发精确度证据有限。
信息架构分层良好(入口→规范→资产→流程→指南→平台适配器),含版本元数据(spec_version、framework_revision)、模板骨架与许可声明;但 last_updated 标注为未来日期 2026-03-12,归属元数据与宿主仓库存在矛盾,无 CHANGELOG 或维护责任说明,scripts/ 为空占位。扣分点:元数据可信度瑕疵、版本治理与维护路径不完整。
作为提示词标准框架,其价值在于提供一致的提示词结构与格式契约,assets 中丰富的格式与常量示例具备直接参考价值;但静态审阅下无法验证按该标准生成的提示词是否确实优于手工编写,规范主体(references/)未提供,产出可用性无法确认。扣分点:核心价值主张缺少可验证证据,比较收益未证明。
仅能核对文件内部一致性(资产命名、版本号、布局声明相符);规范文档缺失、无测试、无第三方执行证据,README 徽章指向外部仓库的发布版本亦无法核实。扣分点:关键主张(规范内容、lint 能力)均不可独立验证,证据类型单一。
- 元数据归属(Christopher Buckley / chris-buckley 仓库)与宿主仓库 jsburckhardt/devcontainer-features 不一致,且 last_updated 为未来日期 2026-03-12,使用前请核实真实来源。
- 规范核心文档 references/ 与 lint 脚本未随证据提供或为空占位,本技能当前实质上只是入口索引,验证标准符合性的能力未被证实。
- 仓库 CI 仅测试 devcontainer features,与本技能无关;无针对 APS 规范的测试或第三方执行证据。
- 未声明中文支持与触发边界,语义调用可能产生误触发。
这个 Skill 能做什么,适合哪些场景?
这是 Agnostic Prompt Standard (APS) v1.0 的技能入口,托管于 jsburckhardt/devcontainer-features 仓库的 .github/skills/agnostic-prompt-standard/ 目录下。它将 APS 的八个规范性规范文档放在 references/ 目录中,涵盖结构、词汇、格式化与校验(linting)、代理控制、模式类型、语法、日志隐私和错误分类等内容。仓库还提供可复用的示例(格式块与常量块)、技能脚手架模板、非规范性的平台适配器(VS Code + GitHub Copilot、Claude Code、OpenCode 及通用工具),以及构建、创作和子代理架构指南。适合希望用统一标准编写可移植、可校验提示词的用户。注意:规范中提到 LSP/linter 可读取 references/ 目录,但仓库内的 scripts/ 目录默认为空,并未附带实际的 lint/编译工具。
作为技能入口,它不做任何计算,而是提供:1) references/ 中的八份 APS v1.0 规范性文档,定义提示词结构、词汇、校验与格式化、代理控制、模式与类型、语法、日志与隐私、错误分类;2) assets/ 中的可复用示例,包括三种常量块示例(JSON、文本、CSV)和十种格式块示例(代码变更、代码地图、文档索引、错误、层级大纲、创意列表、链接清单、Markdown 表格、SMEAC 计划、API 覆盖表),以及两个组合示例;3) _template/ 中的最小技能骨架用于脚手架新技能;4) processes/build-skill.md 流程文档、三份指南(技能创作、MCP 工具桥接、跨平台子代理架构);5) platforms/ 下的非规范性平台适配器,各自提供平台常量、工具注册表和格式契约。
- 提示词工程师希望按正式规范编写全新(greenfield)提示词,并保证结构、词汇和错误处理一致。
- 技能作者想为多个平台(VS Code Copilot、Claude Code、OpenCode、MCP 工具层)编写可移植的技能,需要参考现成的适配器契约。
- 团队需要通过 _template/ 骨架快速搭建结构统一的新技能。
- 开发者正在构建读取提示词规范的 LSP 或 linter,可直接摄入 references/ 目录。
- 需要跨平台协调者/工作者(coordinator/worker)子代理架构指南的代理应用开发者。
这个 Skill 有哪些优点和局限?
- 提供完整的八部分规范性规范,覆盖结构、词汇、校验、代理控制、模式、语法、隐私和错误分类。
- 附带十种格式块与三种常量块的可复用示例,降低上手成本。
- 包含四个平台适配器(VS Code Copilot、Claude Code、OpenCode、通用/MCP),支持跨平台编写。
- 提供技能脚手架模板和子代理架构指南,便于标准化团队产出。
- MIT 许可证,可自由使用与修改。
- scripts/ 目录默认为空:SKILL.md 描述的"编译和 lint"能力没有附带实际工具。
- README 描述的是 devcontainer features 集合,与该技能本身无关,文档定位略显混乱。
- SKILL.md 元数据指向 chris-buckley/agnostic-prompt-standard 仓库,与实际托管仓库不同,版本脉络需自行核实。
- last_updated 标注为 2026-03-12(未来日期),数据可信度需注意。
- 规范文档本身较重,轻量使用场景可能显得过度工程化。
如何安装这个 Skill?
将 .github/skills/agnostic-prompt-standard/ 整个文件夹复制到你的 Agent Skills 兼容客户端的技能目录中(例如 Claude Code 的 skills 文件夹)。SKILL.md 即为入口点。源材料未提供包管理器或一键安装命令。
如何使用这个 Skill?
阅读 SKILL.md 后按需查阅:references/ 中的规范文档定义如何撰写 APS 合规提示词;assets/ 提供格式块和常量块示例可直接复用;processes/build-skill.md 描述构建新 APS 合规技能的流程;使用 _template/ 脚手架新技能;查阅 platforms/<平台>/adaptor.md 获取特定平台的常量、工具注册表和格式契约。scripts/ 目录默认为空,没有可执行的编译/lint 命令。