engineering-workflow / rules
Cursor rule0 starsChanged 36 days agoMITView on GitHub
关键约束:只有用户明确确认验证通过的功能才能标记为"已完成"。 当处于「务必完成模式」时,本规则调整为: - 模块开发完毕后标记为 waiting_verification(而非直接 completed) - 不中断执行流程等待用户逐一验证 - 所有模块完成后,统一输出验证清单,请用户批量确认 - 用户批量确认后再将状态改为 completed
In this repository11 other files it gives its agents.
- .cursor/rules/00-workflow-entry.mdCursor rule
- .cursor/rules/01-first-principles.mdCursor rule
- .cursor/rules/02-ask-before-act.mdCursor rule
- .cursor/rules/03-goal-alignment.mdCursor rule
- .cursor/rules/05-must-complete-mode.mdCursor rule
- .cursor/rules/06-topic-tracing.mdCursor rule
- .cursor/rules/07-dialogue-execute-mode.mdCursor rule
- project-indexSkill
- project-surveySkill
- tts-notifySkill
- version-backupSkill
The file
Files
更新日志管理
核心规则
CHANGELOG.md 位于项目根目录,记录每个版本完成的功能模块。
关键约束:只有用户明确确认验证通过的功能才能标记为"已完成"。
触发条件
- 用户确认某个模块/功能已完成时
- 发布新版本时
日志格式
# Changelog
## [版本号或日期] - [版本描述]
### 已完成(用户已验证)
- ✅ 用户登录 — 支持邮箱+密码登录,session 管理
- ✅ 权限管理 — RBAC 模型,中间件守卫
### 进行中
- 🔧 数据导出 — CSV 格式导出,进度 60%
### 待开始
- ⏳ 报表生成执行流程
标记完成的流程
- agent 完成某模块开发
- agent 向用户播报:"[模块名] 开发完毕,请验证"
- 用户验证并明确回复"确认完成"或类似表述
- agent 才将该模块在 CHANGELOG 和 project-index 中标为 ✅ 已完成
- 同步更新 project-profile.json 中该模块的 status
务必完成模式下的豁免
当处于「务必完成模式」时,本规则调整为:
- 模块开发完毕后标记为
waiting_verification(而非直接completed) - 不中断执行流程等待用户逐一验证
- 所有模块完成后,统一输出验证清单,请用户批量确认
- 用户批量确认后再将状态改为
completed
禁止行为
- 禁止 agent 自行判定功能已完成(务必完成模式下改为 waiting_verification)
- 禁止跳过用户验证直接标 completed
- 禁止将"代码写完了"等同于"功能完成"
模板文件
首次生成 CHANGELOG.md 时使用:
# Changelog
## [日期] - 项目初始化
### 已完成(用户已验证)
(暂无)
### 进行中
[从 project-profile.json modules 列出]
### 待开始
[从 project-profile.json modules 列出]Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

