lc4t/agents-init
v6.4.0
初始化或迁移 Agent 项目契约;同一分发包附带 project-orchestrator、agent-pack 与 opinion-manager。
更新记录
2026-10-08 — Agents Init 6.4.0 / Project Orchestrator 1.6.0
- 新项目默认 Case 工作目录,专属资料与交付物就近保存,子工作项留在 Case 内。
- Project Profile 增加 work.mode 与 Case 文件落位声明;既有项目保持原模式,显式迁移保留原配置和 legacy_task 指针。
- 提供 Case 元数据和文件名检索、全量盘点及已审阅目录映射的无损迁移;冲突与路径风险失败关闭,应用前后哈希核验,失败撤回本次移动。
- 初始化模板、迁移器、元数据及兼容测试同步升级。
2026-10-08 — Opinion Manager 0.4.0 / Agents Init 6.3.0 / Project Orchestrator 1.5.0 / Agent Pack 1.5.1
project-orchestrator与agent-pack改为在本仓库直接维护,移除scripts/export_plugins.py;原导出时的隐私扫描改为tests/test_public_privacy.py,对全部已跟踪文件生效。agent-pack1.5.1:文本输出中的操作目标在没有to时显示from。
opinion-manager
- 新增可选的分层加载:Profile 可声明常驻模板系列、按需规则束、交付信号与路由,声明随 Profile 一起预览、确认和锁定。带声明的 Profile 使用
schema_version2.1;不带声明的 Profile 仍为 2.0,指纹、锁与正文渲染不变。 - 新增只读
context命令:core输出常驻规则与规则束索引,bundle输出指定规则束,index给出各部分规模,check核对 Agent 声明的交付信号与已读取的规则束。核对失败、未声明或项目设为完整读取时返回fallback。 profile新增--loading-file与--remove-loading;compare与修订预览显示声明的前后差异。- 新增
lifecycle命令,在项目私有目录记录候选、证据快照、人工裁决与灰度使用;所有写入先预览再凭指纹确认,证据保留不可变副本。工具只记账,不发布规则,也不自动晋升。 use事件可记录逐条规则结果、读取的规则束与漏读;漏读记为阻断。status附带规则与规则束的覆盖视图。- 同一 Profile 的新版本沿用旧版本中规则指纹未变的使用记录;
queue --titles输出未裁决候选的标题清单。
agents-init
- 骨架增加
memory/;AGENT.RULES.md模板增加「记忆」一节,规定写入去向、不写入的内容、召回前核实、客户端私有记忆边界与收尾检查。 AGENTS.md的 Session 入口增加分层加载与记忆索引两步;chat-summary.md模板明确只保存未决事项与指针,三个固定小节名称不变。- Project Profile 增加可选的
memory段与opinion.loading_mode;既有 Profile 无需修改即可继续使用。体积预算、保留窗口与复核间隔等参数由各项目设定,不随模板分发。
project-orchestrator
- 新增只依赖标准库的条目式记忆工具
runtime/memory.py:一条记忆一个文件,索引实时生成;提供index、list、check、create、verify、retire,写入类动作默认只预览。 check报告结构问题、失效的来源路径、已晋升仍在用的条目,以及项目参数文件声明的索引、启动层与会话摘要预算;到期条目只标注,不计为失败。- Skill 增加记忆的读取、记录与收尾检查,以及 Opinion 分层加载时的读取与核对步骤。
2026-10-02 — Opinion Manager 0.3.0 / Agents Init 6.2.0
- 新增经内容批准的公开目录:五个系列、十个平行变体、31 条原子规则,规则与模板均精确为 1.0.0。
- 首次配置收敛为直接用模板、选择部分条目、从空白开始,另可在已授权范围由 Agent 提出记忆候选。
- Profile 与正文在正式保存前完整预览,用户一次确认,Agent 分别使用各自真实指纹;内容漂移与冲突继续阻断。
- 保持 0.2.0 Profile、锁和正文渲染兼容;登记新占位正文同时保留旧占位识别与人工编辑保护。
- 修正文档和界面旧空目录说明,明确实际 Skill 来源、桌面加载、部分选择的模板追踪及可见目录建议。
- 新增通用首次配置回归测试;公开目录依赖、安装、初始化、升级和修改保护继续核验。测试不代表长期学习效果。
2026-09-30
opinion-manager 0.2.0
- 支持模板系列的平行变体,使用
family/variant@major.minor.patch精确选择;规则与个人 Profile 同样维护独立版本。 - 新增
publish、profile、updates、compare、verify命令和compose --profile;发布版本不可覆盖,所有写入需确认完整预览指纹。 - 生成完整
OPINION.md和包含全部来源快照的opinion.lock.json;支持离线重建、内容指纹核验及人工修改保护。 - 提供个人 Profile 派生、三方升级冲突预览、明确的冲突处理和规则停用;查看更新不会改变项目内容。
- 新增版本契约、操作验收说明及真实文件命令测试。公开规则和模板目录保持空白。
2026-09-29
6.1.0
Added
- 新增随包安装的
opinion-manager,支持从用户说明生成 Opinion、组合已批准模板、逐条选择规则、预览并写入统一的OPINION.md。 - 新增模板版本、稳定规则编号和来源记录机制,为后续模板升级与差异检查提供依据。
- 新增公开模板准入流程。公开模板目录保持为空;只有经过内容检查、测试和用户逐文件明确同意的模板才能加入。
Changed
- 完整分发包由三个 Plugin 增加为四个 Plugin。
- 新项目的 Project Profile 默认声明
provider: opinion-manager;生成的OPINION.md仍为空白配置入口。 - 初始化完成后询问用户选择自定义生成、已批准模板组合、逐条引导或跳过 Opinion 配置。
2026-09-18
6.0.0
破坏性变更:project-runtime 已拆分为 project-orchestrator(生命周期编排)与 agent-pack(扩展能力管理),本包不再分发 project-runtime。
Changed
- Project Profile 路径改为
.agents/moe.sakanano.agent-pack/project.json,与agent-pack的读取路径一致。 - Profile
runtime区块改为skill/plugin = project-orchestrator,新增capability_manager = agent-pack;distribution变为可选。 AGENT.template.md升级到 v6.0:五类职责分离,生成的AGENTS.md、CLAUDE.md、AGENT.md路由到project-orchestrator与agent-pack。- 初始化器写入前校验随包的
plugins/project-orchestrator与plugins/agent-pack。 bootstrap_and_init.py用 agent-pack 依次安装agents-init、project-orchestrator、agent-pack三个 Plugin,新增--client claude。
Added
plugins/project-orchestrator/与plugins/agent-pack/:从可信源码白名单导出的独立 Plugin,名称与版本和源头一致,避免同机重复安装。scripts/export_plugins.py:导出时把plugin.json#repository改写为本公开仓库,并对改写后内容做隐私扫描。--mode migrate检测 v5 Profile:保留项目自定义字段并升级到新路径,旧文件移入项目外恢复目录;初始化模式遇到 v5 项目以migrate-required停止。--mode migrate遇到父目录为符号链接的骨架文件(如.agents/skills -> ../skills)时跳过并在skipped_symlinked_parents报告,永不穿过链接写入;对这类路径使用--replace会被拒绝。--skip <path>(仅 migrate):既有项目可显式不要某些骨架文件,例如不使用根级docs/的项目;Profile 不可跳过。
Removed
skills/project-runtime/、runtime/、根目录mcp.json/.mcp.json、scripts/export_project_runtime.py及其测试。
2026-08-13
5.2.2
- 首页移除正式域名与 Git 分支等发布运维信息,只保留 Plugin 版本和更新时间。
- 修复 GitHub Pages 部署清单,公开
llms.txt、INSTALL.md、Plugin manifest、runtime 与统一安装脚本。
5.2.1
- 新增
llms.txt、INSTALL.md与bootstrap_and_init.py,支持用户用一句自然语言请求触发完整 Plugin 安装与项目初始化。
5.2.0
- 仓库根目录升级为 Agent Plugins 1.0 安装单元,同时分发
agents-init与project-runtime。 - 新增统一
plugin.json、mcp.json、Codex adapter 与一键 bootstrap 安装入口。 - 初始化器改为从
AGENT.template.md具名中文区块生成 Markdown,并在零写入阶段验证同包 runtime。 - 新增白名单导出脚本、project-runtime 测试及“安装完整 Plugin → 初始化项目 → runtime doctor”端到端验收。
- Opinion 继续保持独立指导/审查能力;公开包不含个人规则、凭据与私有路径。
Added
- 新增显式
--mode migrate:保留未选择的碰撞文件,仅替换逐项指定路径,并要求把原文件备份到项目外恢复目录。 - Project Profile 新增
credential_env_file与mcp_client_policy空配置,供 project-runtime 安全加载本地凭据和按客户端投影 MCP。
Fixed
- 初始化 apply 改为全有或全无:任一冲突时零写入,写入中途失败只回滚本次已知文件。
- 使用 descriptor-bound 路径遍历拒绝父目录 symlink,避免骨架写出项目根目录。
- Project Profile 可声明
native_mcp_sources,供 project-runtime 纳管历史或 client-local MCP。
Changed
- 发布
agents-init v5,将职责收口为项目骨架初始化与版本迁移。 - 运行期 Task/Case、进度、验证、Git 与 Skill/MCP 管理统一交给外部
project-runtime。 - Opinion 保持独立指导/审查能力,公开模板不再内置个人或通用 Opinion 内容。
- Project Profile 使用
.agents/moe.sakanano.project-runtime/project.json,便携能力采用 Agent Plugins 1.0 目录。
Added
- 新增默认 dry-run、冲突不覆盖的
scripts/init_project.py及单元测试。 - 新增空的项目 Opinion 覆盖入口、Agent Plugin/MCP 占位及最小过程文档。
2026-07-02
Changed
- 将
agents-init元数据对齐到AGENT.template.md v4.0,skill 版本更新为4.0.0。 - 按模板内容补充 v4 核心变更、命令入口、治理层级、T1/T2 运行时检查器和初始化产物清单。
- 将
agents-init的SKILL.md精简为执行入口,完整治理规则保留在独立AGENT.template.md。 - 升级
skill.json元数据,补充schema_version、entrypoints、files和commands字段。 - 明确
assets/非必需目录,仅在存在图片、脚本、示例数据等资源时创建。 - 移除 workflow 中的分支级
CNAME写入,避免误导为单仓库可按分支自动切换自定义域名。 - 调整发布模型为仅
main分支发布到skill.sakanano.moe,test分支仅用于本地预览。
Added
- 新增 GitHub Pages 自动发布 workflow:
.github/workflows/pages.yml。 - 初始化云端 Skills 静态站点结构。
- 新增顶层浏览器首页
index.html。 - 新增顶层机器索引
index.json。 - 新增示例 skill:
agents-init。 - 新增
agents-init的 AI 执行入口、浏览器页面、结构化元数据和独立AGENT.template.md模板资源。 - 新增
.nojekyll,避免 GitHub Pages 对以下划线开头的路径或文件执行 Jekyll 处理。