本书架包含结构化写作规范、包复用生态模型和 MoonBit 包发现工具书。07 号书定义书写结构规则;08 号书定义通用包复用生态;09 号书定义 SeekMoon 的 MoonBit 包发现工作台;10 号书把 SeekMoon 实现材料分解为可执行和可审核的 WBS 工作包。

书籍入口

书籍 对象

07 结构化书写约定

定义标题层级、stable ID、xref、rel、字段、索引词和附录等结构规则。

08 包复用生态

定义 Package Discovery 与 Package Management 的对象模型、生命周期、证据源、变量体系、安全治理和评价尺度。

09 SeekMoon:MoonBit 包发现工作台

定义消费者侧 MoonBit 包发现 CLI 的证据来源边界、canonical 数据模型、命令契约、输出契约、行动轨迹和验收条件。

10 SeekMoon:WBS 工作包分解书

定义 SeekMoon Go implementation 的全局必读上下文、工作包依赖图、工作包边界、测试责任、审核尺子和完成证据。

按任务进入

任务 入口 获得的判断

维护 AsciiDoc 书稿结构

07 结构化书写约定

标题、xref、rel、role、附录、术语表和索引的源文档规则。

理解包复用生态

读者路径包级评价

候选包是否适合当前项目,以及哪些硬约束不能被下载量、Star 或文档质量抵消。

设计 registry、index 或评价模型

对象模型证据与度量结构词表

Registry、Index、Resolver、Discovery Surface、Audit Surface 和评价输出的职责边界。

让源码项目成为可消费的包

Manifest、Registry 与 Index生命周期

源码项目如何成为别人能发现、理解、信任、安装和维护的包。

执行 MoonBit 包发现调查

Library Discovery JourneyCommand Map

从 query 到候选、证据下钻、本地验证、采纳记录和报告的完整动作链。

实现 SeekMoon CLI

Architecture PremisesGo Module LayoutEngineering Quality Toolchain附录 F:Go 实现依赖图附录 G:Go 工程工具链

Go module layout、package 边界、依赖方向、运行时组合、数据流、输出管线、依赖选择和工程质量门。

分配和审核 SeekMoon 实现工作

全局必读上下文WBS 依赖图Black-box Acceptance and Quality Gates

每个执行者应读取的公共上下文、每个工作包的输入输出边界、审核依据和质量门。

书籍关系

关系 说明

07 → 08 / 09

07 给出源文档结构规则。08 和 09 的标题、xref、rel、role、附录和索引都按这些规则维护。

08 → 09

08 讨论通用包复用生态。09 讨论 MoonBit 生态中的具体消费者侧工具 SeekMoon。09 可以独立阅读,不要求先读 08。

09 → SeekMoon 实现

09 的命令契约、输出契约、数据字典、行动轨迹和验收条件共同定义 SeekMoon 的公共行为。

09 → 10

10 不重新定义 SeekMoon 公共行为;10 把 09 的对象、架构、依赖、质量门和验收材料投影为 WBS 工作包。

10 → SeekMoon 实现

10 的工作包章节定义实现协作中的交付边界、依赖顺序、测试责任、审核尺子和完成证据。

维护参考

维护本书架中的 AsciiDoc 书稿时,使用 07 结构化书写约定 检查以下规则:

  • 标题层级必须连续。

  • 被交叉引用且标题文本不稳定或不唯一的节点需要 stable ID。

  • 跨越书名、部、章等大跨度的显式指代需要 xref。

  • 关系谓词必须同时进入正文和结构词表。

  • 后置附录、术语表、参考文献和索引需要承担查阅功能。

工作区地图

包复用生态书架结构