@netpilot/skills 0.3.2

package/skills/wayfinder/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "Wayfinder"
+  short_description: "把模糊的大型想法逐步收敛为可执行、可验证的项目路线"
+  default_prompt: "请使用 $wayfinder 将这个模糊想法收敛成阶段清楚、风险可控的执行路线。"
+policy:
+  allow_implicit_invocation: true

package/skills/writing-great-skills/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: writing-great-skills
+description: 当用户要创建、改写、本地化、拆分、合并或评估一个供 Codex 与 Claude Code 使用的 skill 时使用。它设计清晰触发边界、渐进式说明、宿主 metadata 和真实场景测试；普通文档写作不使用。
+---
+
+# Writing Great Skills
+
+高质量 skill 不是知识文章，而是一组在正确场景自动触发、能稳定约束行动并具有可验证完成条件的工作说明。
+
+## 1. 定义行为契约
+
+先收集 3 至 5 个应触发请求和 2 至 3 个不应触发请求，明确：
+
+- skill 解决的重复问题；
+- 使用前提和允许的写入范围；
+- 必须遵循的步骤与可调整部分；
+- 完成证据；
+- 容易出现的失败模式。
+
+如果两个 skill 的触发条件和主要产物高度重叠，优先合并或建立明确的“入口 + 内部引擎”关系，不创建同义别名。
+
+## 2. 设计名称与描述
+
+- 目录名和 `name` 使用小写英文 kebab-case，简短表达能力。
+- `description` 同时说明做什么、何时使用和关键的不使用边界，因为它决定模型是否能正确触发。
+- 面向中文用户时，正文、描述、`short_description` 和 `default_prompt` 使用中文；`display_name` 使用由 canonical name 派生的英文可读标题，代码、路径、命令和标准技术标识保持英文。
+- 去除个人名字、组织暗语和只有原作者才理解的语境。
+
+## 3. 用官方脚手架创建
+
+新 skill 优先使用当前宿主提供的 skill 初始化脚本，生成标准 `SKILL.md` 与 `agents/openai.yaml`。不要手工复制一个包含残留内容的旧目录。
+
+`SKILL.md` frontmatter 至少包含：
+
+```yaml
+---
+name: example-skill
+description: 清楚说明能力、触发时机和不适用边界。
+---
+```
+
+Codex 的 `agents/openai.yaml` 应包含与 canonical name 一一对应的英文 `display_name`、25 至 64 字符的中文 `short_description`，以及显式提到对应 skill（本 skill 为 `$writing-great-skills`）的中文 `default_prompt`。例如 `code-review` 显示为 `Code Review`，不要另造中文名称。跨宿主共用一份正文时保持可组合调用，并用正文门禁控制动作；只有先建立可验证的宿主专用生成层后，才能为某个宿主单独禁用隐式调用。
+
+## 4. 编写最小充分说明
+
+推荐结构：概述、工作流、完成标准、反模式。根据任务需要增加输出模板、安全门禁和宿主差异。
+
+- 使用命令式、可观察的指令。
+- 解释会影响判断的“为什么”，不解释常识。
+- 能由 agent 根据上下文决定的细节不要硬编码。
+- 大段参考资料放入 `references/`，确定性重复操作放入 `scripts/`，输出用模板或静态文件放入 `assets/`。
+- 引用只深入一层，并清楚说明何时读取资源。
+- skill 调用其他 skill 时，写明触发条件和返回关系，避免循环调用。
+
+跨宿主兼容时以通用 Agent Skills 结构为核心，把 Codex 专用 metadata 放在 `agents/`，把插件级差异放在各宿主 manifest；不要在正文复制两套流程。
+
+## 5. 测试与迭代
+
+1. 运行结构验证器，检查 frontmatter、名称、描述和资源引用。
+2. 用真实请求进行前向测试：观察 skill 是否触发、是否遵循门禁、是否产出预期证据。
+3. 用反例测试误触发和职责重叠。
+4. 对高风险指令做压力测试，例如用户要求跳过验证、越权写入或把推断当事实。
+5. 依据失败修改最小必要指令，再重复测试；不要为了单个例子堆叠大量例外。
+
+## 上游改编
+
+可以吸收上游方法，但应重新表达并适配本地安全规则、工具能力和语言。复制或实质改编受许可证约束的内容时，在仓库级 `THIRD_PARTY_NOTICES.md` 保留必要版权与许可证声明；不需要为每个 skill 建立复杂来源注册表。
+
+## 完成标准
+
+- 名称唯一，触发描述能区分相邻 skill。
+- 正文包含可执行工作流、完成标准和反模式。
+- metadata 与正文一致，内部引用能解析。
+- 结构验证、正向场景、反向场景和至少一个压力场景有真实结果。
+- 上游改编满足许可证要求且没有残留个人化符号。
+
+## 反模式
+
+- 不要把长篇教程直接包装成 skill。
+- 不要创建职责相同、名称不同的入口。
+- 不要只翻译词句而保留不适合本地环境的权限假设。
+- 不要在没有运行验证时声称 skill 可用。
+- 不要把所有知识塞进 `SKILL.md`，造成每次触发都加载无关上下文。

package/skills/writing-great-skills/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "Writing Great Skills"
+  short_description: "设计、编写、测试并持续迭代高质量、可触发且可靠的技能"
+  default_prompt: "请使用 $writing-great-skills 创建或改进一个 skill，并用真实场景验证其触发和行为。"
+policy:
+  allow_implicit_invocation: true