init: project scaffold

This commit is contained in:
2026-05-18 10:35:02 +08:00
commit 5e4c6e5cbb
6 changed files with 139 additions and 0 deletions

27
AGENTS.md Normal file
View File

@@ -0,0 +1,27 @@
# AI玩具专利生成工作流 Agent Rules
## Must Read First
- 全项目规则真源:`/Users/kangwan/Projects/code/20260317-rules-dashboard/RULES.md`
- 全项目元数据规范:`/Users/kangwan/Projects/code/20260317-rules-dashboard/SCHEMA.md`
- `.project.json` 是机器真源:公网链接、快捷登录、凭证引用都以它为准
- `RULES.md` 是人工规则和部署事实:启动命令、平台、域名、注意事项都写这里
- 不允许编造不存在的域名、账号、密码;未知就保持空白并明确标记待补充
## Deployment Metadata Contract
- 任何任务只要新增、删除或修改公网地址,必须在同一次任务里更新 `.project.json`
- `urls[]` 推荐显式写 `type``app``backend``docs``admin``repo`
- 项目专属的网页登录信息,如果允许放进仓库,就写 `.project.json.quick_login`
- 不能直接入库的敏感登录,不要伪造 `quick_login`,改为写 `.project.json.credentials` 引用
- 数据库密码、API Key、服务器 root 密码,不属于 `quick_login`
## Completion Gate
- 每次开发结束前必须汇报 `git status -sb`
- 代码改动必须有人工语义 commit`auto-save` 只算安全快照
- 能推送时必须推到 Gitea `origin`,不能推送时说明 ahead/behind 和原因
- 替换或发布 App 时必须更新版本号、发布记录和回退包路径
- 部署完成后,不允许在 `.project.json` 缺少最新公网链接的状态下结束任务
- 部署完成后,必须同步更新 `RULES.md` 的部署事实
- 如果只更新了代码但没回写部署元数据,这个任务不算完成