Project Steward
角色与路由
Project Steward 保存跨项目可复用的治理方法。项目自己的产品决定、架构事实和长期约束留在项目现有真源中；用户和机器的可变工具事实留在项目与 Skill 之外的环境档案中。
先按用户要得到的结果选择主路径；同一请求中的独立结果分别建账：
- 历史对话、纠正、完整实施过程或目标 Skill 职能边界：对话学习与自我进化。
- 功能、重构、迁移或跨层改动开始前消除返工：改动前预防。
- 缺陷、半迁移、重复修补、真实链路失效，或内聚、耦合、重复、上帝模块检查：根因治理。
- 检查、接入或修复项目与外部 CLI、执行工具或协议的兼容关系：外部工具兼容性。
- 看懂仓库、目录或源码包的用途、架构和能力，或研究参考项目：项目研究与讲解。
- 盘点或整理项目目录，判断真实使用、生成状态、忽略、移动、归档与删除边界：项目目录治理。
- 建立、采用、升级或检查项目模板：项目基线与模板。
- 把稳定默认写入模板：模板演进。
- 定义、审查、重建或实施产品体验与界面：产品体验与界面治理。
- 审计、重写 README 或制作 GitHub 主页视觉：README 与主页。
- 治理项目日志、LLM 记录、长期记忆、TTS 或日志查看结果：人性化日志。
- 初始化 Git、创建仓库、提交、推送、改变可见性或验证远端：仓库建立与发布。
- 选择、应用或批量治理许可证与第三方授权：许可证治理。
- 建立或消费用户环境档案，检查工具、缓存、SDK、终端或长任务：用户环境档案与执行环境。
- 按实施计划逐项核对完成度，或全面检查、判断项目健康状况和排列项目级风险：项目综合审计。
只点名本 Skill 时按现有材料选择最匹配路径；材料不足时给出一个贴近上下文的直接请求示例并停下。
主路径选定后，在任何项目写入或专项实施前建立路由账本：用户最终结果、主路径、固定必读方法、条件专项及其触发证据、动作门槛、正式消费者、验收和停止位置。固定必读方法不能因为局部修改看起来明显而跳过；条件专项只有取得适用证据才叠加。同一请求后来增加验收项时更新原账本，不用最新症状替换仍有效的范围。
共同边界
- 普通业务功能仍由当前开发任务负责；用户只要求解释单条报错、单个函数或局部行为时，在回答该结果后停止，不升级为项目级改造。只有请求本身要求预防、治理、迁移、自我进化或项目级结果时才进入相应路径。
- 选择路径后立即冻结范围、写入权限和停止位置。检查、审计、诊断、评估、分析、复盘或报告默认只读；同一请求明确要求修复、治理、实施、修改、更新或自我进化时才获得相应写入权限。
- 用户提供源码归档并要求看懂、审计或研究项目，或只点名本 Skill 并附上源码归档时，解压是进入只读研究所需的材料准备，不是项目正式写入。直接按“项目研究与讲解”确定目标根，运行既有脚本解压到独立避重名目录，读取脚本返回的项目根并继续只读研究，无需额外取得解压确认。该动作只授权创建研究副本和读取其内容；运行项目、安装依赖或解压工具、修改项目、移动或删除原文件、提交和发布仍分别授权。
- 联网、下载、安装、运行、生成、写入、移动、归档、删除、提交、推送和发布分别授权；只有本节随后明确列出的默认完成合同可以把同一用户结果内的写入、提交、推送和远端验收合并授权。运行或生成不等于获得项目写入权限；默认完成合同之外，提交、推送或发布只授权处理已存在且准确核对的改动，不追溯授权先前写入，也不包含无关工作树变化。
- 用户在请求中明确点名 Project Steward（包括调用
$project-steward），并明确要求对现有 Git 项目实施修改、修复、治理、更新或优化时，若当前分支存在已配置 upstream 且用户没有要求只改本地、不要提交、不要推送或指定更早停止位置，本轮实施默认完成到：按获准依赖闭包验证、精确提交、非强制推送当前跟踪分支，再核对远端 HEAD 与关键消费者；本地验证后不再第二次询问是否推送。只读请求、隐式路由、无 upstream、创建远端、改变可见性、删除、强制推送、改写历史、打包、部署和无关工作树变化不由该默认获得授权；按references/repository-publication.md在分叉、来源不明变化、未获授权删除、凭据、验证或认证失败时停止。 - 用户确认 Project Steward 自我进化方案且未要求只改本地时，当前跟踪远端存在即默认把整个当前工作区作为一个不可拆分的发布范围：验证全部已跟踪修改、未跟踪文件和现有删除，使用
git add -A一起提交并推送当前跟踪分支；任何一项不能共同发布时保留完整工作区并停止。该默认不授权创建远端、强制推送、改变可见性或实施新的删除。 - 用户明确要求为现有 GitHub 仓库接入、修复或替换 Star History 时，确认合同默认包含本轮获准依赖闭包的提交、推送和远端验收；除非用户明确要求只改本地，否则写入验证后不再等待第二次发布授权。该默认不包含创建远端、强制推送、改变可见性、删除或无关工作树变化。
- 每个用户回合、内部轮次、自动续跑和上下文压缩恢复开始时，任何工具调用或状态改变前都先从最近一次明确用户动作恢复尚未完成的结果、范围、权限和停止位置。只有同一结果仍未交付且范围、受影响链与权限未变时才继续；只读结果已经交付、没有新的明确动作、用户改变结果、出现无关问题或需要新增权限时停止并等待确认。审计发现、助手建议、内部计划、目标名称、待办清单和自动提示都不能补造新结果或写入权限。
- 工作从短动作扩展为多阶段、进入等待或证据状态发生变化时，主动说明扩展原因、已完成检查点、当前状态、下一项可观察结果和所需输入；状态不变时不重复刷屏，也不能用流程说明掩盖范围扩张。
- 新的独立请求替换尚未完成的结果时，先交接已经写入或改变的对象、已有证据、尚未验证的用户承诺、运行进程、残留、原权限和停止位置；新请求不授权继续、回退或清理旧结果。
- 先冻结准确项目根、材料范围、活动文件和真实消费者。Git 只在准确项目根直接存在 .git 且当前路径确需历史、工作树或发布证据时使用。
- 来源必须读到明确末尾；长文件先取得行数、字节数或分页能力，再按稳定区间完整读取。并发变化触及行为合同、影响文件、消费者、验证或用户结果时，旧确认失效，重新规划并确认。
- 多项相互独立的探测只有在编排器能逐项保留输出、错误和退出状态时才并行；任何一项会让整批提前中止时改为独立执行。批次失败后保留仍新鲜的成功证据，只把被遮蔽、未执行或状态未知的项目单独补跑。
- 项目事实写回项目现有唯一真源；环境事实写入独立用户档案；可迁移治理方法才进入本 Skill；模板只接收某类项目每次都应执行的稳定默认。
- 判断历史或外部材料中的能力是否已经存在时，先完成独立结果拆分和必要的因果排序，再遮住来源检查目标能否认出同一条件、保留同一构成性细节并作出同一具体处理；只有上位治理框架算部分具备。完成逐项比较后才提炼共同机制和特殊维度。
- 验证按改动风险选择层级：先运行直接覆盖本次改动和验收主张的目标检查；只改文档、许可证、致谢或纯元数据时在相应维护入口通过后停止，不启动无关浏览器或端到端链路；公共合同、核心运行时、跨仓库边界、发布或目标检查暴露系统性影响时，才升级为完整回归和真实用户链。
- 状态改变后直接回读权威目标。完成验证必须沿正式生产者、传输或存储边界、消费者和用户可观察结果；不能让消费端手写假数据或 mock 掉正在验证的核心链路。
- 测试结果用于关闭承诺或宣告完成前，预期关键测试身份必须与测试框架实际收集的唯一身份一致；缺失或非唯一身份都只能标为未覆盖。
- 诊断读取设置、运行报告、结构化制品或日志时，按
references/log-audit-standard.md先投影当前判断需要的允许字段；未知结构不得整份递归输出，凭据必须在进入工具输出、对话或诊断导出前脱敏。
对话学习与自我进化
先完整读取 references/conversation-learning-and-self-evolution.md。
任一用户结果含失败、纠正、保护拦截、临时绕行或残留时，再读取 references/root-cause-remediation.md。读取顺序固定为：按结果恢复完整过程，沿因果层级确定主要学习主题和独立次级结果，再恢复其中会改变未来治理的具体细节并按共同边界逐项比较目标能力，之后才提炼共同机制和特殊维度、判断可迁移性、职能边界和正式所有者，最后判断历史责任。绕行与残留不得覆盖更早且证据成立的可控根因；后续纠正改变主要原因时，现有方案与确认立即失效。只有成功结果且不存在这些信号时，不加载根因方法。
能力比较必须先区分“方法缺失”和“已有方法没有被路由、执行或验收”。前者只原位强化唯一方法所有者；后者只修最早失效的主路由、动作门槛、正式消费者或验证，不在其它文件增加同义规则。方案按所有者和消费链组织，不按对话出现顺序堆叠补丁。
用户只要求分析时保持只读。明确要求吸收、自我进化、更新、优化或迭代 Project Steward 时，先交付未来行为、职能边界、代表性输出、影响文件和验证方式并停下；用户确认该方案后才修改活动 Skill。确认方案未声明只改本地时，同时读取 references/repository-publication.md；当前跟踪远端存在时，把整个工作区按实际影响验证，使用 git add -A 将已跟踪修改、未跟踪文件和现有删除一起提交并推送当前跟踪分支，核对远端 HEAD 和工作区无遗漏后才完成。远端、认证、分支保护、分叉、验证失败或任何一项不能共同发布时保留完整工作区并停在准确边界，不退回选择性提交。
Project Steward 自我进化时必须执行主文件约束：
- 写入前记录 SKILL.md 的行数、字符数和直接 reference 集合，并给每条新增规则指定唯一活动所有者。
- SKILL.md 只拥有路由、触发条件、读取顺序、权限、输出和停止位置；完整方法、表格、检查清单与例外由对应 reference 唯一拥有，主文件只保留直达链接。
- 写入后 SKILL.md 不得超过 220 行或 14,000 个字符，并保持全部活动能力可直接到达。新路由使预算超限时，必须在同一次改动中迁移或合并旧细节。
- 无法在预算内保留既有能力、正式消费者和验证时，停止写入、重新规划，不得宣称完成。
改动前预防
先读取 references/change-prevention.md，由它负责目标行为、唯一真源、影响图、最终接口、旧路径退出和真实用户链验收。按问题叠加：
- 持久操作、队列或调度器的有界批次与积压排空、恢复、重启、成组产物，或常驻有状态服务中可发现会话与共享资源的并发准入、释放和关闭：
references/durable-operation-governance.md - 任务状态、进度或自动续跑：
references/task-progress-governance.md - 高成本结果需要分阶段展示、确认、连续自动执行或按上游变化失效：
references/staged-result-governance.md - 同一结果由多份规格、计划、任务或研究产物表达且需决定演化关系，或涉及派生产物、语义缓存、工作单元切分、资源池利用或重复 Agent 编排：
references/derived-artifact-governance.md - 项目级 CI 的验证计划、执行环境缓存、测试资源分层、耗时分片、早失败和精准重跑：
references/ci-execution-governance.md - 运行中配置会重建共享服务、provider、存储根或组合图：
references/runtime-generation-governance.md - 难复现、时序、并发、背压或昂贵完整链：
references/hard-to-reproduce-diagnostics.md - 外部、持久化、模型、网络或进程 JSON 存在多处解析、容量、原子分片、重放游标或合同歧义：
references/structured-data-boundary.md - 模型参与任务判断、状态表达、运行时事件或结构化回复，需要核对消息来源、角色、路由、线请求与呈现职责：
references/model-mediated-operation-governance.md - 以外部源码为一次性起点建立独立产品，或选择性吸收其扩展生态：
references/source-fork-and-ecosystem-adoption.md；实际复制代码时同时读取references/license-governance.md - 产品体验或界面：
references/product-experience-governance.md；需要设计或交互方法时再读references/ux-design.md
只有用户明确授权实施时修改项目；只要求计划则停在影响图、目标边界、迁移顺序和验收合同。
根因治理
先读取 references/root-cause-remediation.md。诊断停在证据、影响范围与最终修法；实施才一次迁移全部生产者、边界和消费者，并退出旧架构。按问题叠加：
修复承接本任务先前的综合审计，或用户明确要求修复该审计中的全部问题时，原审计交接账本继续作为结项合同；写入前固定读取 references/change-prevention.md，最后一次相关修改后返回 references/project-audit.md，从原覆盖范围和当前已接受合同重新生成覆盖与发现账本。单点缺陷不会仅因历史中存在无关审计而扩张到这条链。
- 持久操作、队列或调度器的有界批次与积压排空、恢复，或常驻有状态服务的会话准入与释放竞争：
references/durable-operation-governance.md - 任务进度或持续状态：
references/task-progress-governance.md - 返工来自阶段确认缺失、确认对象漂移或变化被错误扩散：
references/staged-result-governance.md - 返工来自多份产物关系不明、理由在重新生成时丢失、全量重算、错误缓存失效、危险切分、资源误判或编排往返：
references/derived-artifact-governance.md - 项目级 CI 反复慢测、环境准备浪费、分片失衡、跨平台预检过晚或失败后无差别重跑：
references/ci-execution-governance.md - 运行时操作跨越服务代次、热配置事务或物理根切换：
references/runtime-generation-governance.md - 难复现或低可观测问题：
references/hard-to-reproduce-diagnostics.md - 结构化 JSON 的编码、资源预算、逻辑消息容量、原子分片、重放游标、数值、schema 或错误语义分叉：
references/structured-data-boundary.md - 模型回复、任务状态或结果呈现与真实运行时不一致，或需要定位实际发送给模型的请求：
references/model-mediated-operation-governance.md - 可视层级、变换或动效所有权：
references/interaction-motion.md；需要实际运行画面验收时再读references/implementation-review.md - 工具、路径别名、执行环境或长任务：
references/user-environment-governance.md - 事件、版本、历史或缓存把计划影响范围误当成实际变更事实：
references/change-prevention.md的“计划范围与实际变更事实分离”合同 - 局部状态、心跳或遥测更新覆盖、清空了未声明字段，或者消费者无法区分完整快照与局部补丁：
references/change-prevention.md的活动投影更新合同 - 源码、README、脚本、测试或配置硬编码本机与部署事实：
references/change-prevention.md的项目运行配置边界；用户机器事实同时读取references/user-environment-governance.md - 内聚、耦合、语义重复或上帝模块：
references/architecture-cohesion-governance.md
外部工具兼容性
读取 references/external-tool-compatibility.md。兼容关系涉及跨项目根的公共合同、派生快照或复合交付包时，同时读取 references/change-prevention.md 的公共合同、合同采用闭包与跨根交付边界。兼容性检查保持只读，并按明确适配器逐层报告可执行产物、能力合同、调用与隔离、临时输入、上游线协议、结构化结果、宿主独立核验和用户链；只有明确授权修复或接入时才修改获准项目根。
项目研究与讲解
先读取 references/project-research.md。只读取回答当前问题所需的项目表面；用户明确要求完整研究或能力采用时才扩展覆盖，并同时读取 references/source-fork-and-ecosystem-adoption.md，先追溯原始上游并区分直接复用与方法学习；确认会直接复用代码或资源时再读取 references/license-governance.md，把第三方资源与致谢写入目标项目 README。需要衡量效果、失败样本和置信度时读取 references/project-effectiveness-review.md；需要保存可复核报告时读取 references/project-research-report.md。源码归档先用 scripts/extract_project_archive.ps1 和 -DestinationRoot <目标根> 解压到独立目录；没有另行指定目标根时使用 E:\Work\BaiduSyncdisk\Code\Example。脚本返回项目根后立即读取 references/archive-safety-screening.md 并运行 scripts/inspect_extracted_project_safety.py；只有该方法确认重大隐患时才进入用户输出，否则静默继续原研究。
项目目录治理
读取 references/repository-directory-governance.md。先用 scripts/inspect_project_tree.py 取得只读物理与 Git 证据，再核对每个候选目录的正式生产者、路径真源、消费者和生命周期；检查、解释与计划停在证据账本，只有明确授权整理、移动或归档时才改变准确路径，删除继续遵守单独授权。移动触及活动源码、模型、数据、素材、构建或运行入口时同时读取 references/change-prevention.md；已经存在旧路径、双读、同步副本或半迁移时再读取 references/root-cause-remediation.md，一次迁移消费者并退出旧入口。
项目基线与模板
读取 references/project-template-system.md。只读请求停在 inspect、plan 或 verify；adopt、upgrade 或项目配置写入需要明确授权，并验证正式消费者。
模板演进
读取 references/template-evolution.md。先证明候选是稳定默认而非仍需临场判断的方法，再同步模板版本、注册表、哈希、文档和消费者测试。
产品体验与界面治理
先读取 references/product-experience-governance.md，再按以下固定入口和条件专项执行：
- 界面诊断、评价、优化或重建固定读取：
references/ux-design.md、references/interface-experience-quality.md、references/interface-problem-patterns.md、references/implementation-review.md。修改前先冻结全部相关窗口、页面、面板、覆盖层、主要状态和用户旅程；不能把截图中最醒目的局部问题当成完整审查范围。 - 从零设计或改变视觉方向：
references/design-method.md、references/visual-direction.md、references/surface-registers.md - 布局、设计系统、交互和动效：
references/layout-responsive.md、references/design-system-alignment.md、references/interface-guidelines.md、references/interaction-motion.md - 参考界面忠实重建：
references/reference-interface-reconstruction.md - 已确认是桌面、Tauri/Vue 或本地文件工作区时，对应读取
references/desktop-app-governance.md、references/tauri-vue-governance.md、references/local-file-workspace-governance.md；项目形态已经成立时不得因当前反馈只提到颜色、间距或文案而省略平台外壳。 - 任务状态或进度：
references/task-progress-governance.md
依赖既有定位或设计系统时，每个任务最多运行一次 scripts/context.mjs；忠实重建参考界面时由 assets/reference-reconstruction/component-spec.md 承担组件规格。
仓库建立与发布
读取 references/repository-publication.md。区分初始化、提交、远端创建、推送、可见性、检查与部署；每一步只执行已经授权的停止位置，并在状态改变前后核对准确仓库身份、索引、分支、远端和并发变化。
README 与主页
先读取 references/readme-delivery.md，用一份交付账本检查 Git 边界、README、正文、视觉、多语言、许可证、Star History、GitHub Topics、仓库元数据、验证与停止位置；只读请求停在同一账本，明确要求优化、重写或完整处理时才实施。随后读取 references/content-architecture.md；完整优化或涉及 Logo、hero 时读取 references/visual-direction.md，先完成代码优先的正式身份源调查，再按需读取 references/project-native-hero.md 和 references/github-readme-canvas.md。需要多语言、个人入口或仓库状态区时读取 assets/readme-profile/profile.json，由 scripts/readme_header.py 消费真实文件、仓库身份、许可证和明确解析的项目导航。已有公开 GitHub 仓库的完整 README 优化把 Star History 与 Topics 都作为默认交付项：Star History 读取 references/github-star-history.md 和 references/repository-publication.md，Topics 通过 scripts/github_topics.py 写入并回读；除非用户明确退出或目标客观不适用，缺少任一真实消费者的成功结果都不能完成整项交付。按需选择：
- SVG 与混合视觉：
references/svg-production.md、references/hybrid-svg-production.md - 动效：
references/motion-production.md - 平台边界：
references/platform-guidelines.md - 自托管 Star History 的专项诊断或接入：
references/github-star-history.md；只问失效原因或现状时保持只读，实施时精确提交并推送调用仓库改动，手动运行工作流，再沿 API、生成器、输出分支、raw SVG 和 README 消费端的真实链路验收
README 不作为每项内部治理规则的第二份活动真源；自我进化只有改变公开身份、读者路径、主要入口或维护导航时才更新 README。完成后运行 scripts/audit_readme.py，并在实际渲染表面核对。
许可证治理
先读取 references/license-governance.md。用户确认具体方案后再读取 references/license-rollout.md 并实施；只读请求停在内容边界、第三方依赖与方案比较。
人性化日志
读取 references/log-audit-standard.md。沿一次真实操作检查生产、上下文、存储、读取和最终查看结果；不以一条漂亮示例替代完整事件链。
用户环境档案与执行环境
读取 references/user-environment-governance.md。档案 schema 由 assets/user-environment/profile.schema.json 负责，确定性操作由 scripts/user_environment_profile.py 负责。inspect、plan、verify 和 resolve 保持相应只读或消费边界；apply --write 需要明确档案写入授权，且不自动授权安装、下载或系统设置修改。
项目综合审计
读取 references/project-audit.md。用户询问实施计划完成度时，先从原计划建立逐项符合性账本；获准修复后必须从原计划和当前已接受合同重新生成一次全新复查，不沿用旧完成标记，也不从现有测试反推计划范围。全面检查则先按项目形态建立全部适用维度的覆盖账本，再加载这些维度要求的专项；不得只根据已经发现的问题回填审查范围。只读审计不自动治理。需要评估用户效果时追加 references/project-effectiveness-review.md，需要检查任务体验时追加 references/task-experience-audit.md。
平台模板资源
处理对应项目类型时按需读取：
- 桌面应用：
references/desktop-app-governance.md - Tauri v2 + Vue：
references/tauri-vue-governance.md - 本地文件工作区：
references/local-file-workspace-governance.md
这些资源是活动方法，不等于项目已经采用模板；只有明确采用并由正式消费者读取的 .project-steward/project.json 才构成项目模板状态。
输出与完成
输出先给结论，再说明范围、证据、未知项和下一动作。分析不得写成已经实施；结构检查不得写成真实用户链成立；当前任务行为核对不得写成独立冷启动已经证明。
有影响图时至少包含生产者、传输或存储边界、消费者、最终用户结果、唯一真源、旧路径退出条件和验收入口。涉及多个历史结果时逐个报告主要原因、成功机制、能力缺口、正式所有者和验证等级。
只有活动路由、对应方法、正式消费者、确定性测试以及本轮获准的真实用户链都一致后，才报告完成。