3.1 KiB
Skill 使用与跨电脑接续
本手册同时是名为 endor-docs 的 skill 包。SKILL.md是机器入口，README.md是人工查阅入口，两者使用同一组任务页、规则、方法与示例。查询与使用通过 Markdown 完成。
每次开始写作
先读目标仓库的 AGENTS.md 和本 skill 入口，从八类任务中选择主任务，再选择必要补充任务。打开任务页的必读方法、DOC 规则和案例，结合语言核对地图找到本次主题的主定义与规范状态。
例如，“完善函数章节并补例子”使用 guide + example；“只检查一篇草稿的问题”使用 review；“统一已经确认的 use 写法”同时涉及 semantics + example。记录所选路线与实际读到的依据即可，不需另外执行查询程序。
表格是起点。若写作中发现会改变规则的词句，补充语义路线；若出现章节移动，补充结构路线。每个任务页解释选择条件和完成标准。
项目级入口
仓库的 .agents/skills/endor-docs 是指向 authoring 的相对符号链接，避免维护两份手册。支持项目 skill 发现的客户端可以读取该入口；当前会话的 skill 列表是否刷新由客户端决定，不把文件创建成功称为自动加载已经验证。
无论客户端是否发现 skill，仓库 AGENTS.md 都要求文档任务读取 authoring/SKILL.md 并选择路线。也可以直接请求“按 authoring/SKILL.md 修改函数章节”。
换电脑
完整克隆本仓库可以同时获得语言文档、手册与维护约定。阅读和编写手册不需要 Python 或其他程序环境。
若检出环境不能保留符号链接，直接通过 AGENTS.md 读取 authoring/SKILL.md；不要把符号链接的文本文件误当作目录。若希望单独安装，可将 authoring 目录作为一个完整包放入支持的 skill 目录，目录名使用 endor-docs，保留内部相对结构。
独立安装时先明确语言文档仓库的位置。手册包中的规则、方法和案例可独立阅读；真实写作需读取目标仓库的 AGENTS.md、语言正文和状态。实际语言定义始终由目标仓库维护，不能拿手册快照代替当前主定义。
执行权限
默认只阅读和编辑文件，人工核对规则、链接、例子和关联页面。只有用户明确要求执行代码时才运行程序、脚本、测试、构建或安装；skill 本身、已有检查工具和“完成验证”目标都不授予执行权限。
用户明确要求的 Git commit 和 push 可以按该授权执行，操作限于必要 Git 流程，不附带启动测试或项目 hook。未进行自动检查时如实记录，不能把人工核对写成自动通过。
使用边界
文档站点一般通过 authoring 路径访问，符号链接仅用于 skill 发现。手册中的“文件、章节、仓库”指文档维护载体，不引入语言源码文件模块。
本 skill 不绑定某台电脑、网络服务或模型。来源研究页只在查证写作方法时加载；源码示例需要的语言条件由相关页面明确说明。