用途
project-tiny-context-harness 是一个面向 AI 编程代理的极简项目记忆与验证工具。它帮助编程代理在项目中找到项目特定的需求，并让代理在不被强加工程工作流的前提下维护这些需求。
该工具安装一个简短的开发契约到 AGENTS.md，并保留持久的项目事实。源代码版本为 0.12.1，配置架构版本为 5，schema-4 安装需要以 update mode upgrade-required 进行升级。
主要能力
- 安装 AGENTS.md 作为受管理的启动入口。
- 安装 project_context/ 目录中的项目上下文文件。
- 提供角色 Skill（Role Skills）。
- 提供 validate-context 门禁，用于检查结构。
- 保留持久项目事实，例如目标与非目标、所有权与依赖边界、已确认决策及原因、项目约束、可重复操作/源入口点。
- 引用真实源中的精确值，而不是复制代码。
- 默认不安装架构、Area、设计系统、角色 Skill、Hook、Makefile、tools 目录或 CI 工作流。
- 使用 context-mutation-journal-v3 记录 Context 变更，兼容读取 context-mutation-journal-v2。
- 提供可选的 design-resource Skill，使用 Stitch 进行视觉生成和设计修订。
使用方式
需要 Node.js 24 或更高版本。安装你打算使用的包版本，然后运行其本地 CLI。
普通 init 只创建 AGENTS.md、.agent/config.yaml、project_context/global.md 和 project_context/context.toml。它会保留现有文件，并将项目事实留为 TODO 直到已知。临时的文件维护锁可能创建 tmp/ty-context，它们不是任务状态。对已有项目使用 --adopt。显式指定 --harness-folder .codex 会将该可选位置存储到 package.json；更改已有安装的根目录需要单独迁移。
对于未发布的源代码检出，应构建并安装其实际 tarball，而不是假设已发布的包包含这些更改。
AGENTS.md 是受管理的启动入口。根目录的 AGENTS.override.md 可以遮蔽它；doctor 会报告该可观察条件。宿主和嵌套指令范围可能不同：文件安装并不证明当前模型已加载或遵循契约。不会修改全局宿主设置。
读取默认项，然后读取相关所有者。新默认项包含 project_context/global.md 以及显式项目选择。在 schema 5 中，architecture.md 没有特殊默认状态。context.toml 是路由元数据，不是默认正文。查询会显示路径、原因、诊断以及集合是否完整。无效清单返回非成功状态；部分结果永远不会是完整的空集。
CLI 对读取是可选的。离线时，读取 global.md 并使用清单中的直接 default_files、默认 Area、read_policy = "default" 节点及其传递 default_children。直接文件和默认 Area 本身不会播种子遍历。子边保留现有语义，包括被引用的 never-default 节点。旧版 always、optional 和 never-default 名称不意味着新的选择行为；诊断会解释旧版元数据。当集合已知且未变更时，不要重新安装 CLI 或重复查询。
适用场景
适用于使用 Codex、Claude Code、Cursor、Gemini CLI、OpenCode 或类似 AI 编程代理的项目，希望在多个新会话中恢复项目意图、边界和验证路径。
适用于需要保留长期项目事实、确认决策和依赖边界的项目。
适用于需要可选的资源创建和采用能力（design-resource Skill）的项目，该能力使用 Stitch 进行视觉生成和设计修订，优先使用官方 MCP，在 MCP 不可用时使用已认证的官方 Stitch 网站。
适用于已将资源 Skill 组合进项目的场景，保留项目入口并组合打包能力，项目入口可添加目标平台处理、参考约定、导出/集成流程和项目特定检查。
限制
- 需要 Node.js 24 或更高版本。
- 默认 init 不安装架构、Area、设计系统、角色 Skill、Hook、Makefile、tools 目录或 CI 工作流。
- 没有强制标题、任务进度字段、稳定 Fact ID 或源行限制。
- TODOs 和历史测试记录是允许的。
- 临时导出和可选交接说明不是另一个长期事实来源。
- 多个文件系统替换不是一个原子事务；不要覆盖冲突文件以让恢复通过。
- Sync 只替换受管理的启动块并保留周围用户文本。Schema 不匹配、未完成的升级/Context 事务和冲突写入会停止相关维护。
- 结构成功既不证明采用、代理查看、美学，也不证明生产正确性。
- 资源可用性和运行时检查是显式任务工作。
- 现有声明检查仓库相对的本地 UTF-8 入口；它不会递归检查链接资产或该入口内的声明，不加载图像、不访问外部链接，也不将资源添加到默认 Context。
- 同一目标的重复声明会被诊断，即使在同一域中。
- Skill 不安装服务器、不获取凭据、不编辑全局设置。复制或读取 Skill 本身不会使其 MCP 可用。
- 项目 Skill 和复制的 Skill 归项目所有：init、sync 和 upgrade 不会安装或更新它们。
- 不会自动创建设计目录或资源模板。
- 如果引用的包不可用，应报告缺失的基础，而不是假装已读取。
- 未提供具体收费、价格或平台支持范围的详细信息。
