STARSHARD BUILDER KIT v1.0 FORKABLE ARCHITECTURE HUMANS.md + AGENTS.md

搭建你自己的个人 Agent 操作系统：三模块映射与记忆代谢指南

基于 6 个月真实生产运行经验提炼。不推销中心化 SaaS 平台，只提供可独立 Fork 的「持久记忆层 + 多模块协同调度 + 双向人机契约（HUMANS.md）」工程脚手架。

核心入口与开源仓库：
• StarShard 规范与 Constraint Manifest (C1–C7)：https://starshard.clawishmacheng.com/
• 最小参考实现（Reference Impl）：https://github.com/starshard-ai/reference-impl
• 架构与多 Agent 协调协议：architecture-v1 · fleet-coordination-protocol
• 能力网络与验证合约设计蓝图：decentralized-capability-network-v1

01. 如何把你的「三大个人业务模块」映射到统一 Agent OS？

很多创作者与独立实践者希望同时运行三个看似独立的个人模块（例如：M1 身心状态与日常节律、M2 内容创作与认知研究、M3 交易/投研与外部协作）。最常见的踩坑是「建了三个互不相通的 Bot，最后靠人肉复制粘贴当路由」。StarShard 的解法是底层共享单一持久记忆总线（Memory Hub），上层按权限与验证等级拆分为三个受控工作流：

模块 M1 · 身心与内省节律

核心特征：高隐私、长期纵向时间线、严禁外泄。
架构映射：遵守 Constraint Manifest C3 & C6（只做认知镜像，不越权替人做价值判断；私有语料库与公开发布层物理隔离）。由夜间睡眠整合（autoDream）自动提炼周期规律。

模块 M2 · 认知研究与内容引擎

核心特征：跨文献/跨历史对话的高密度语义综合。
架构映射：所有日常语音思考自动打上 provenance 标签写入 Memory Hub；写稿时先由多模型检索历史观点自洽性，产出带真实案例的复盘草稿，由本人把关最后 20% 品味。

模块 M3 · 交易决策与外部协作

核心特征：高风险、真金白银、需强验证门控。
架构映射：严格接入 Non-Builder Verifier Gate 与 owner-stop 红线。Agent 负责全天候信号扫描、回测与证据核验，但任何触及资金、发帖或对外承诺的动作必须停在人类审批门前。

02. 模块间如何互动？——「记忆总线 + 睡眠代谢（Memory Metabolism）」

[日常语音 / 笔记 / 交易日志]
        │
        ▼ (实时写入 + Provenance 置信度标记)
┌──────────────────────────────────────────────────────────┐
│  Shared Memory Hub (SQLite/FTS + Typed Relations)        │
│  • 永不静默覆写历史：新认知通过 supersede 指向旧记录       │
│  • 严格区分：user-stated (本人钦定) vs agent-inferred     │
└───────┬──────────────────┬──────────────────┬────────────┘
        │                  │                  │
        ▼                  ▼                  ▼
  [M1 身心节律]      [M2 内容共创]      [M3 交易/协作]
  生理/精力低谷预警 ──► 自动调低日间排程 ──► 锁定高风险交易确认门

03. 为什么你需要一份 HUMANS.md（给人类自己写的说明书）？

大多数系统只给 AI 写 AGENTS.md，结果人类自己成了 24 小时待命的审批机器。StarShard 提出对称的 HUMANS.md 协议：

条款	核心规则	工程效果
1. 注意力最稀缺	常规「术」层细节由 Agent 自主闭环并附回滚方案；「道」层方向每天最多打包问一轮选择题。	把人类从琐碎运维与 A/B/C 选项轰炸中解放出来。
2. 红线零豁免	花钱、删库、对外发消息、第三方平台写操作、凭证变更，100% 停在人类指尖确认。	防止 Agent 幻觉或自动化脚本触发平台风控与社交翻车。
3. 昼夜节律保护	凌晨产生的冲动重构或高风险指令，系统自动进入「仅做沙箱预备、次日清醒复核」模式。	模块 M1（身心状态）直接保护模块 M3（交易与架构安全）。

04. 30 分钟快速上手（Fork & Run）

# 1. 克隆最小参考实现与协调协议
git clone https://github.com/starshard-ai/reference-impl.git
git clone https://github.com/starshard-ai/architecture-v1.git

# 2. 先写你自己的 10 条 HUMANS.md 边界（定义什么绝不允许 AI 替你做）
# 3. 挑一个最小模块（例如 M2 语音笔记沉淀或 M3 每日信号简报）跑通第一条带 Receipt 的闭环