docs: develop task-guided Endor authoring skill and detailed handbook
This commit is contained in:
@@ -0,0 +1,33 @@
|
||||
# 2026-10-08 作者走查记录
|
||||
|
||||
对象:本次扩展的 endor-docs skill、任务入口、方法页与改写案例。方法:作者依据当前语言正文逐项阅读和推演;没有独立评估者或真人参与。
|
||||
|
||||
## 场景与产物
|
||||
|
||||
| 场景 | 本次实际走查 | 依据与产物 | 观察结果 |
|
||||
| --- | --- | --- | --- |
|
||||
| EVAL-01 局部术语 | 将草稿中的 InFlight 按阶段主定义改为 inflight,比较前后含义 | TASK-01、DOC-017、阶段章 | 可用局部路线完成,不需要全书重组 |
|
||||
| EVAL-02 身份指南 | 从聊天式原稿提取 handle、显示名、key 与权限边界 | EX-01、身份章、规范状态 | 成稿能区分两个名称及定位效果,没有补造注册接口 |
|
||||
| EVAL-03 导入修复 | 分别检查分隔符、选择性列表、组件来源和可见性 | EX-02、程序结构章、规范状态 | 仅改冒号不足;参考成稿处理了四种不同问题 |
|
||||
| EVAL-04 调用例子 | 从缺少声明的函数体补齐提供方、使用方、输入和结果 | EX-03、函数章 | 输入 100/10 得到 90/85;80/7 得到 73/68,均为作者手算 |
|
||||
| EVAL-05 新设计范围 | 阅读明确要求新增内置 get 的场景,核对处理方法 | TASK-06、EVAL-05 的边界说明 | 入口区分新决定与旧稿,不因旧稿未定而拒绝用户的新决定;仍需记录签名等缺口 |
|
||||
| EVAL-06 只读审查 | 对合成原稿中的建表、get、零值、授权和测试断言作审查 | EX-04、相关语言主定义 | 发现有具体依据和最小修正;未改语言正文 |
|
||||
| EVAL-07 章节重组 | 为身份、use、阶段和数据主题逐项安排位置 | EX-05、信息架构方法 | 有内容映射与关联入口检查,而非按字数拆页 |
|
||||
| EVAL-08 不可读来源 | 核对原有三个知乎来源的状态与引用方式 | SRC-10、12、13、DOC-020 | 未读来源未参与观点推导;本次没有重新访问外部页面 |
|
||||
| EVAL-09 跨电脑查阅 | 按包内链接与目标仓库路径逐项核对资源结构 | skill-usage、SKILL.md、任务表 | 手册可按 Markdown 查询;未在另一台电脑或客户端实际加载 |
|
||||
| EVAL-10 执行权限 | 核对入口、工作流、清单及协作约定中的执行要求 | AGENTS.md、SKILL.md、workflow、checklist | 默认人工核对,执行程序须用户明确要求;新增查询脚本和测试已撤回 |
|
||||
|
||||
## 本次修正
|
||||
|
||||
- 规则页补充具体应用与深读入口,减少原则和实际写作之间的断层。
|
||||
- 指南、参考、示例、重组和审查分别提供完整案例。
|
||||
- 将任务入口及主题定位保留为 Markdown 表格;去除新增查询程序与其测试,不将脚本作为使用前提。
|
||||
- 执行权限写入项目约定、skill 和维护流程。用户明确要求的 commit/push 不附带执行测试或项目 hook。
|
||||
|
||||
## 验证限制
|
||||
|
||||
最终版本未运行程序、自动检查、测试或 skill 验证器。文件入口、元信息、链接安排和示例结果由作者人工核对;不报告自动检查通过。
|
||||
|
||||
这些记录是作者走查,不能证明不同作者或真实读者都能完成任务。自动 skill 发现、跨客户端加载和独立行为测试没有验证,后续需在用户明确要求的范围内进行。
|
||||
|
||||
[评估场景](scenarios.md) · [手册入口](../README.md)
|
||||
@@ -0,0 +1,34 @@
|
||||
# Skill 行为评估场景
|
||||
|
||||
本页用于修改 skill 后验证它是否支持真实写作。场景是评估任务,成功标准不是要求所有文档都包含的固定内容。格式验证与行为验证分别记录。
|
||||
|
||||
## 使用方法
|
||||
|
||||
选择与本次变更相关的场景,把输入交给作者或评估者,只提供 skill 与必要的当前主定义。需要检验独立理解时,不先给成功标准或已知问题。生成产物放在隔离目录,避免进入语言正文。
|
||||
|
||||
记录输入、实际读取资源、产物、发现和验证方式。作者自评不能称为独立代理或真人测试。案例答案页可供学习,但评估不得仅比较措辞是否相同。
|
||||
|
||||
## 场景矩阵
|
||||
|
||||
| 编号 | 输入任务 | 观察的行为 | 失败信号 |
|
||||
| --- | --- | --- | --- |
|
||||
| EVAL-01 | 把一处 inflight 的大小写改正确 | 选择 edit,查术语与相关句子,局部修正 | 无关全书重构,或要求阅读全部来源 |
|
||||
| EVAL-02 | 详细写一下用户身份 | 选择 guide + identity,区分 handle/显示名/归属/操作身份,并保留生命周期未定项 | 用注册实现或权限装饰器补篇幅 |
|
||||
| EVAL-03 | 修复 use alice.shop.ui::{Column, Text} 这个例子 | 选择 example + imports,处理 key、选择性列表、官方组件来源和可见性四类问题 | 只改冒号,其他问题保留 |
|
||||
| EVAL-04 | 给跨 namespace 定价补完整示例 | 给出依赖声明、归属、假设、输入与结果,明确验证等级 | 没有函数声明却宣称完整或已运行 |
|
||||
| EVAL-05 | 把 get 写成每个 class 的内置方法 | 识别这是新设计要求;区分明确要求变更与普通润色,落实其明确定义部分并指出签名等缺口 | 默默补造数据库、返回类型和错误关键字 |
|
||||
| EVAL-06 | 只审查一篇把 use 写成授权的草稿 | 选择 review,指出位置、依据、影响与修正;保持目标文件未改 | 自动提交修复,或只评论措辞 |
|
||||
| EVAL-07 | 重排一章混合身份、调用、部署讨论的草稿 | 给出主题职责与移动映射,更新入站链接,保留语义状态 | 删除重要前提,或仅按字数切分 |
|
||||
| EVAL-08 | 用无法读取的网页补充权威建议 | 记录不可读,不归纳未见观点,继续可读来源工作 | 将摘要当正文、虚构作者结论 |
|
||||
| EVAL-09 | 在另一电脑只有 Markdown 的情况下使用 skill | 从入口选择任务、读取对应方法,再定位目标仓库主定义 | 依赖运行脚本或某台电脑的固定路径 |
|
||||
| EVAL-10 | 用户要求完成文档,但没有要求执行代码 | 通过阅读和编辑完成;明确请求 commit/push 时只完成必要 Git 流程 | 自行启动测试、程序、安装依赖或项目 hook |
|
||||
|
||||
EVAL-05 的措辞包含明确变更意图,不能机械拒绝用户的新决定。skill 应确认已改变的设计范围,并将尚未决定的参数、失败与阶段边界准确记录,而不是把旧文档当作永远不可改变的禁令。
|
||||
|
||||
## 产物审查
|
||||
|
||||
检查选定路线是否足够、成稿是否可独立阅读、关键断言是否有依据、例子是否可推演、所报告的验证是否真实。允许不同的正确组织与措辞,不要求与示范答案相同。
|
||||
|
||||
若失败来自任务表漏项,修订任务入口;来自方法不明确,修订相关方法页;来自实例不充分,补充有针对性的示范。只有共同工作约束缺失时才扩大 SKILL.md。
|
||||
|
||||
[最近评估记录](results-2026-10-08.md) · [手册维护任务](../tasks/TASK-08.md)
|
||||
Reference in New Issue
Block a user