skill_swift_cycle: Instructions file for Codex

AGENTS.md

本规则适用于skill_swift_cycle仓库。

Swift Cycle

• 本仓库持续采用 Swift Cycle；维护时读取仓库内的规范入口，按任务加载参考，不依赖已安装副本代表当前源码。
• 复用 README.zh-CN.md 的用途、用户、能力与边界作为既有项目意图；已确认工程要求及栏目依据在 docs/engineering_standard.md，不为本次自用新增重复 BLUEPRINT、PRD 或计划。
• 每包同步受影响的用户说明、设计及既有 TODO；有效经验用 DEVLOG 紧凑条目保留。保留已有事实、记录和授权边界，不自动更新安装或发布版本。

仓库用途

• 维护一个可移植的 Agent Skill，用于轻量项目治理。
• 规范包保存在skills/swift-cycle/。
• 除非经过验证的兼容性需求确有必要，否则不新增脚本、依赖、生成资产或特定厂商副本。

命名规则

• 项目名、仓库名和项目根目录名中的单词使用_分隔；除所选项目名自身的大小写外，不另加强制大小写规则。
• 标准规定的 Skill 标识、包目录和调用名保持为swift-cycle；Agent Skills 名称不允许下划线。
• 外部语法限制作为明确例外处理，不因此改变仓库命名规则。
• 固定专业文档名属于明确的文件名例外：docs/PRD.md、docs/SAD.md、docs/BLUEPRINT.md、docs/ROADMAP.md、docs/MANUAL.md，以及采用稳定正整数 N 的 docs/milestones/M{N}_PLAN.md。其他普通 docs 文件及多词目录保持小写 snake_case；未获迁移授权时，保留已有完整等价来源。

修改规则

• 编辑前读取README.md、DESIGN.md、规范SKILL.md及相关兼容性文档。
• 保留用户修改，每一项变更都应能追溯到当前请求。
• 优先对共享核心做小范围修改，避免复制面向不同 Agent 的实现。
• Skill 正文保持精简、使用指令式表述，并少于 500 行。
• 知识沉淀与状态分离指引应轻量且不绑定具体项目；不写入项目专属流程、强制状态字段或固定状态结构。
• 场景路由与文档档位保持渐进：minimal不依赖standard或runtime_integration产物也能使用。
• Swift Cycle 只负责单个项目的工程循环。不加入跨项目统筹路由、审查者创建、容量管理、组织验收、外部注册表或跨项目运行授权。
• 模板是可选结构，正文按已解析的文件语言调整。不创建按语言重复的模板树。
• BLUEPRINT 是唯一共享、受 Git 跟踪的项目意图依据：新项目默认使用docs/BLUEPRINT.md，默认禁止根级 BLUEPRINT 文件；已有项目的完整等价来源只映射，不复制。
• 按要求生成的审查快照必须冻结并绑定日期或里程碑，不能变成可持续改写的当前事实文档。
• 可写项目任务必须有本地根级 tmp/ 目录及生效的 /tmp/ 忽略规则。必要且可控的新临时工作放在其中。用户已退役本仓库的 .superpowers/ 与 docs/superpowers/ 目录；不得重建，也不得将原辅助程序或快照树迁到别处。历史引用只记录过去事实，不是当前执行路径。只读任务仅检查。通过工具参数或子进程临时设置减少额外的 C 盘写入，不修改全局环境或缓存设置，也不把 tmp 内容视为可自动丢弃。
• 不添加缺乏依据的宿主支持声明；当前行为须对照第一方文档验证。

项目治理

• 本项目保留一名项目负责人（L1）；原固定审查者已退役。
• 仅当用户、部门负责人或当前项目规则明确要求时，才设立独立审查者。
• 该角色调整不授予 Git 推送、发布、部署、运行、凭据、费用或删除权限。

语言同步

• README.md是英文用户入口。
• README.zh-CN.md是简体中文用户入口。
• 安装、调用、功能或仓库布局变化时，同步更新两个入口。
• 中文术语或文档职责变化时，更新skills/swift-cycle/references/zh-CN.md。
• 不把完整规范 Skill 正文复制到本地化文件中。
• 不把英语定义为目标文档唯一有效的语言。保留仓库现有双语入口，由规范 Skill 统一解析会话语言和文件语言。