city-life-line/AGENTS.md

城市生命线项目协作规则

记忆库入口

本项目的持续上下文保存在 memory/。开始处理新任务前，先读取：

1. memory/index.md：项目状态和记忆索引。
2. memory/long-term.md：稳定的架构事实、长期决策和用户约定。
3. 最近相关的 memory/sessions/YYYY-MM-DD.md：了解近期工作和未完成事项。

每次任务结束时

• 在当天的 memory/sessions/YYYY-MM-DD.md 追加目标、结论、文件变更、验证结果、风险和后续行动。
• 如果项目状态、入口或会话索引发生变化，更新 memory/index.md。
• 用户明确确认且预计长期有效的决策，整理到 memory/long-term.md。
• 即使没有代码改动，也记录简短的结论或“无变更”说明，避免上下文断裂。

定期整理

每累计 5 次会话，或当天会话文件超过约 20 KB，检查并整理长期记忆：合并仍然有效的信息，标记过期决策，必要时将旧会话移动到 memory/archive/。整理后同步更新 memory/index.md。

隐私和安全

记忆库只保存可复用的项目上下文。禁止写入密码、Token、API 密钥、地图密钥、内部账号、个人隐私或完整的敏感接口响应。需要描述配置时只记录变量名、用途和是否已配置。

变更边界

遵循用户当前任务范围，保留已有用户修改；修改前先阅读相关文件，完成后运行与风险相称的验证。记忆库文档不参与前端运行时，不应改变 src/、Vite 或 npm 行为，除非用户明确要求。

Agent skills

Issue tracker

Issues are tracked infrequently in the internal Gogs Issues through its web interface. See docs/agents/issue-tracker.md.

Triage labels

Use the five default triage labels. See docs/agents/triage-labels.md.

Domain docs

Use the single-context layout. See docs/agents/domain.md.