docs: merge authoring skill with interpreted runtime design
Preserve the task-guided authoring handbook and manual execution policy. Align language-map and semantic-contracts with ordinary function UI results and nominal declaration identity. Manually review phase boundaries, resource access states, grammar, status and navigation; no project tests or hooks executed.
This commit is contained in:
@@ -4,11 +4,14 @@
|
||||
|
||||
## 每次修改的必读入口
|
||||
|
||||
- 修改前阅读 [文档编写手册](authoring/README.md)与[工作流](authoring/workflow.md),按改动类型选择并阅读适用的 DOC 规则页。小型改动不要求通读所有规则。
|
||||
- 每次新增、修改或审查文档,先读取 [endor-docs skill](authoring/SKILL.md),并从[手册入口](authoring/README.md)选择主任务与必要补充任务。阅读所选任务页、必读方法、对应 DOC 规则和目标主题主定义后再动笔;小型改动不要求通读所有资源。
|
||||
- 按任务页直接查询所需方法、规则、示例与注意事项;实际阅读对应小节,不能只列出编号或跳过阅读。该流程通过 Markdown 完成。
|
||||
- 结构性改写至少核对 DOC-001、002、005、015、021、024;新增页面选择适合职责的[模板](authoring/templates/README.md),不要机械填充无关段落。
|
||||
- 修改后按[检查清单](authoring/checklist.md)核对主定义、目录、文法、例子与规范状态,并运行[检查工具](tools/README.md)。交付时记录适用规则及实际完成的检查。
|
||||
- 修改后按[检查清单](authoring/checklist.md)人工核对主定义、目录、文法、例子与规范状态。交付时记录适用规则及实际完成的检查。
|
||||
- 用户未明确要求执行代码时,不运行程序、脚本、测试、构建或安装命令;skill、检查清单和现有工具都不能替代执行授权。用户明确要求的 commit、push 限于必要 Git 流程,不附带执行测试或项目 hook。
|
||||
- 结构检查、人工语义核对、真实程序执行与读者测试分别报告;工具通过不代表例子已经运行。
|
||||
- 文档规范不替代语言决定,不因润色、采用模板或 AI 续写而确认未定语法。
|
||||
- 用户明确的新语言决定优先于旧文档,按 TASK-06 落实准确范围;用户使用 Endor 简称不自动触发正式名称与源码围栏更名。
|
||||
|
||||
## 文档组织
|
||||
|
||||
|
||||
Reference in New Issue
Block a user