# ASL Harness 开发项目约定

本仓库负责协议实现、CLI/桌面管理、验证与宿主投影；技能内容由 agent-skill-library 维护。先读 README、相关架构说明及本次实际调用链，不自动加载用户级共享试点或业务项目方法。

- 在现有实现上做目标所需的最小修改，不自发重构、换架构或增加第二调度器、重复真源。确需大改，先说明必要性、影响与回退，再等用户确认。
- 动手前核对当前文件、调用者和用户未提交修改。只改责任路径，不顺手格式化或清理旁边代码；有用的现成接口先复用。编码按宿主已有本地上游原版Ponytail执行，不定制其正文。
- 按改动风险运行现有必要检查，提供实际命令、结果、具体产物及限制。协议/引用校验、原生渲染、磁盘投影、宿主发现和业务执行分开证明；版本号、读过说明或窗口打开不代替相应验收。低影响文字修改不扩成全部业务测试。
- 解释实现或架构时给具体触发、前后行为和材料；需要图示时呈现真实关系与简短说明，不用抽象概括代替当前调用链。Mode/Mermaid或其它架构本身的改动需具体批准，本次项目方法维护不包含它们。
- 保留现有协议、相对引用和来源边界；改引用后核对实际目标。写前比较基线，写后读回，回退只针对本次改动，先保留用户后来编辑，不能整库reset或覆盖。
- 交付指出改了什么、为何改、实际如何验证和未决缺口。业务进度、GTM偏好及原始聊天不沉淀为开发仓库的人格规则。不混入其它Git改动，不自行commit或push。

依据与范围见[开发项目方法依据](docs/project-work-methods.md)；架构真源仍是[现有架构说明](docs/asl-architecture-views.md)，不另建一套执行框架。