Imported from PZQ-ship-it/collaboration-console-template (
AGENTS.md). Install upstream withnpx skills add PZQ-ship-it/collaboration-console-template. Copyright stays with the author.
AGENTS.md
Language
- 默认用中文沟通；代码、命令、API 名称保留英文。
- 回答先给可执行结论，再给必要背景。
Repository Role
- 本仓库是通用协作事务平台模板，可用于单人、多人或多项目团队。
- 保留分控台的配置、功能和信息架构：事务桶、成员注册、角色占位、公共/本地双层文件、执行地图、仓库登记、证据登记、运行环境、同步规则、标签契约、workstream、handoff、风险和决策。
- 不写入源项目名称、源团队信息、源事件、源仓库关系、原始资料、本地绝对路径、token、密码或私密配置。
- 激活到具体项目或团队时，先替换模板占位符，再写入该项目自己的事实。
Affairs Routing
- 先识别当前事项属于
inbox、tasks、projects、areas、calendar、decisions、references、team、members还是codex。 - 需要连接实际执行环境时，优先查看和维护
codex/project-map.md。 - 新输入如果去向不明，先放
inbox/；可执行动作放tasks/；有目标和结束条件的放projects/；长期责任放areas/。 - 对开始、推进或办结的非平凡事务，先检查
tasks/graph/*.md、项目INDEX.md、codex/project-map.md和相关状态文件；需要跨会话追踪时创建或更新任务卡。 - 任务状态和最小证据按
codex/workflows/task-state-contract.md维护；人类、AI、共设计和外部等待分类按codex/workflows/workload-scheduling-contract.md维护。 - 产生未来汇报会用到的状态、证据、解释、风险或下一步时，按
codex/workflows/reporting-trace-contract.md写入reports/work-traces/。
Identity Gate
- 处理成员专属文件前，先确认当前操作者身份。
- 如果
codex/current-operator.local.md存在且有有效Member ID，使用它。 - 如果没有本地操作者文件，但
team/roster.md中只有一个 human member，默认使用这个成员；这就是单人模式。 - 如果有多个 human member 且没有本地操作者文件，询问当前使用者的
member-id。 - 注册新成员时最多问 3 个问题：
member-id、公开显示名/角色标签、主要职责/默认角色。 - 不单独追问称呼；需要时作为可选本地偏好写入
members/<member-id>/registration.local.md。 - Codex 可读取本地注册文件和当前操作者文件来判断上下文，但不得提交、摘要、复制或同步其中的私有信息。
- 未由真实成员承接的责任线写入
team/open-roles.md和roles/<role-id>/，不要写入team/roster.md。
Path Index Gate
- 公共
INDEX.md只登记仓库相对路径和公共入口，不写本机私有路径。 codex/project-map.md可以登记公开 remote、仓库相对路径和团队有意共享的执行入口。- 本机私有路径、上游私人仓库路径和本地素材路径写入
codex/local-index.local.md。 - 若
codex/local-index.local.md不存在，Codex 应从codex/local-index.local.template.md创建它；模板可提交，实例文件必须被.gitignore隔离。 - 公共文件中如需引用本地资源，只能写本地索引中的稳定别名、资源类型、脱敏说明或仓库相对路径。
Repository Creation Gate
- 新建仓库前先检查
codex/repository-registry.md和codex/project-map.md是否已有同类仓库或执行入口。 - 仓库 owner、可见性和默认分支由具体项目决定；本模板不预设组织或个人账号。
- 创建后必须更新
codex/repository-registry.md；本地 checkout 路径若不适合公开，则写入codex/local-index.local.md。
Dual-Layer Gate
- 本仓库采用公共层 + 本地层结构，详见
codex/dual-layer-architecture.md。 - 证据素材：公共层写
evidence/manifest.md；原始视频、截图、日志和本地素材路径写codex/evidence.local.md。 - 运行环境：公共层写
codex/runtime-requirements.md；本机环境、设备连接、端口、SDK 路径和私有 endpoint 写codex/runtime.local.md。 - 上游同步：公共层写
codex/source-sync.md；上游私人仓库、导出目录、原始材料路径和同步记录写codex/source-sync.local.md。 - 标签扫描：公共层写
codex/tag-contract.md；Codex 扫描缓存、本地证据和置信度记录写codex/tag-scan-cache.local.md或.json。 - 若对应本地实例文件不存在，Codex 应从同名
.local.template.md创建；模板可提交，实例文件必须被.gitignore隔离。
Editing Contract
- 默认优先修改当前任务相关的最小文件集合。
- 不直接重写他人成员工作台；需要影响他人或角色责任线时，写入
handoffs/<target>/。 team/、projects/、tasks/、decisions/、risks/是公共事实层，修改时要写清依据和影响。views/是汇总层，事实来源必须能追溯，不要在视图里创造新事实。codex/保存自动化、同步说明、执行地图和本地模板。tasks/graph/*.md是任务状态源；tasks/graph-view.md和 workload review 是生成视图，不应在其中创造事实。- 冲突或不确定时标为
待确认，不要猜测覆盖。
Long-Running AI Work
- 对预计超过 60 分钟的非平凡 AI 工作，先确认任务登记，并按
codex/workflows/long-running-ai-writeback-contract.md定期写回进度。 - AI 运行时间、计划时间块和人类实际投入必须分开；未经人类明确确认，不得写入其
time_spent_minutes。 - 创建、安装或更新可复用 skill 时，按
codex/workflows/skill-storage-sync-contract.md同步全局安装与已登记存储仓库，并做文件级一致性验证。
Safety
- 不写入 secrets、API key、token、密码、私人联系方式或未脱敏外部链接。
- 不提交任何
*.local.md、*.local.json、*.private.md、*.private.json、members/*/private/，除非该文件是明确命名的可提交模板或 example。 - 不复制具体项目的原始正文或私有材料，只同步公共协作需要的摘要、任务和决策。
- 不使用破坏性 git 命令。
Validation
- 新增或修改后至少运行一次文本扫描，检查是否误带具体项目名、本地绝对路径或私密字段。
- 修改任务图或扫描器后，使用独立 fixture 运行
codex/workflows/scripts/task_graph_scan.py，验证依赖、分类和生成视图。 - 发布前按
codex/pre-push-checklist.md执行最小检查。