mcpField
S
skill-source-citations

skill-source-citations

github.com/arenukvernAgent 工作流39444 次安装2 周前更新
代码仓库

关于 skill-source-citations

Skill Steward 中用于记录创建或修改技能时所依据资料的指南，供技能作者和审查者使用。它要求将来源链接保存在各技能的 references 中，而非只留在对话里。

主要功能

  1. 01为每个技能维护 sources.md
  2. 02研究前后记录来源链接
  3. 03为不明显的主张添加行内链接
  4. 04PR 中提醒更新来源
  5. 05来源引用范围指引

适用场景

  1. 01编写技能时记录参考资料
  2. 02审查 PR 中的流程性主张
  3. 03跨对话保存研究链接

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/arenukvern/mcp_flutter --skill skill-source-citations

安装后在 Claude Code 中输入/skill-source-citations确认已加载。

附带文件references/citation-template.mdreferences/sources.md

详细介绍

技能来源引用

规则： 从文档、论文、其他代码库或聊天研究中借鉴的知识，必须以链接形式保存在技能目录树中，不能只留在对话里。

适用场景

  • 创建或编辑任何 skills/{name}/SKILL.md
  • 编写技能前研究 harness/MCP/市场模式
  • 审查包含无来源流程性声明的 PR

每项技能的文件（skill_steward 中必需）

维护 skills/{name}/references/sources.md：

# Sources

| Topic | URL | Used for |
|-------|-----|----------|
| Agent Skills spec | https://agentskills.io/ | Frontmatter rules |
| … | … | … |

## Changelog

- 2026-05-29: initial citations

模板：citation-template.md。

工作流（创建或更新技能）

  1. 编写前 — 将要依赖的 URL 列入 references/sources.md（可以先简略填写）。
  2. 在 SKILL.md 中 — 对不明显的内容，直接链接到规范/文档；长篇材料优先放在 references/ 中。
  3. 研究后 — 追加新行和变更日志条目；不要只在聊天中留下“我们读过 X”。
  4. 在 PR 中 — 在描述中写一行：“已更新 references/sources.md 中的来源。”
  5. 验证 — 如果缺少 sources.md，pnpm run validate 会发出警告。

应引用的来源

引用示例
官方规范agentskills.io、Cursor/Claude/Codex 文档
论文/研究SkillOpt、SkillsBench arXiv
参考实现产品 MCP、Codex plugin-eval
博客/指南仅当流程不明显时引用；优先使用一手文档

不要引用临时聊天 URL 或私有令牌。

跨技能索引

Guild 范围的参考资料：docs/STANDARDS.mdx、DESIGN_FAQ.mdx。

相关技能

任务技能
搭建技能脚手架skill-authoring-lifecycle
评估/改进skill-eval-improve
规范审计skill-authoring-lifecycle

来源规范（本技能）

参见 references/sources.md。

安装

npx skills add arenukvern/skill_steward --skill skill-source-citations

评论

支持 Markdown