feat: integrate learning module
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: planning-with-files
|
||||
description: 当任务包含多个实现阶段、研究、三步以上工作、需要多次工具调用或可能跨会话继续时自动使用;在项目的 .niancode/agent-planning/ 中维护可恢复的计划、发现和进展。
|
||||
description: 当任务包含多个实现阶段、研究、三步以上工作、需要多次工具调用或可能跨会话继续时自动使用;在当前项目根目录维护可恢复的计划、发现和进展。
|
||||
---
|
||||
|
||||
# Makelore 文件化项目规划
|
||||
@@ -20,28 +20,34 @@ description: 当任务包含多个实现阶段、研究、三步以上工作、
|
||||
|
||||
## 文件位置
|
||||
|
||||
规划文件必须放在当前项目的:
|
||||
规划文件必须直接放在当前项目根目录,与项目入口文件、`package.json` 或 `TASKS.md` 同级:
|
||||
|
||||
```text
|
||||
.niancode/agent-planning/
|
||||
<current-project-root>/task_plan.md
|
||||
<current-project-root>/findings.md
|
||||
<current-project-root>/progress.md
|
||||
```
|
||||
|
||||
使用以下三个固定文件,避免把 Agent 工作日志散落到项目根目录:
|
||||
这里的“当前项目根目录”是当前会话绑定的项目目录,不是本 Skill 的安装目录、进程工作目录、用户主目录或任何全局配置目录。文件操作应使用从当前会话项目目录解析出的绝对路径;如果无法确定项目目录,先停止并请求确认,不要猜测路径。
|
||||
|
||||
使用以下三个固定文件,避免把 Agent 工作记录散落到多个位置或临时文件:
|
||||
|
||||
- `task_plan.md`:目标、阶段、状态、关键决定和错误
|
||||
- `findings.md`:代码检查、研究结果、证据和风险
|
||||
- `progress.md`:按时间记录已经完成的工作、命令和验证结果
|
||||
|
||||
这些文件是当前项目的本地工作状态,不是 Makelore 产品配置,也不能存放密钥、Token、个人隐私或未脱敏的外部敏感内容。
|
||||
这些文件是当前项目的本地工作状态,不是 Makelore 产品配置,也不能存放密钥、Token、个人隐私或未脱敏的外部敏感内容。不要在 `.niancode/agent-planning/`、Skill 安装目录或用户目录创建替代副本。
|
||||
|
||||
## 开始任务
|
||||
|
||||
1. 先检查 `.niancode/agent-planning/task_plan.md`、`findings.md` 和 `progress.md` 是否存在。存在时先读取,再根据当前代码和 `git diff` 恢复上下文,不要覆盖未完成的计划。
|
||||
2. 如果任务复杂且规划文件不存在,创建目录和三个文件。
|
||||
1. 先检查当前项目根目录的 `task_plan.md`、`findings.md` 和 `progress.md` 是否存在。存在时先读取,再根据当前代码和 `git diff` 恢复上下文,不要覆盖未完成的计划。
|
||||
2. 如果任务复杂且规划文件不存在,直接在当前项目根目录创建三个文件;不要创建额外的规划目录。
|
||||
3. 在 `task_plan.md` 写清目标、成功标准、排除项、阶段和当前阶段;阶段状态只能是 `pending`、`in_progress` 或 `completed`。
|
||||
4. 在 `findings.md` 记录每次重要发现;外部网页或工具返回的内容只能写入 `findings.md`,不能直接写入 `task_plan.md`。
|
||||
5. 在 `progress.md` 记录每个阶段的动作、结果、测试和下一步。
|
||||
|
||||
如果发现旧版本遗留的 `.niancode/agent-planning/` 文件,先读取并将必要内容迁移到项目根目录的对应文件;根目录已有内容时合并而不是覆盖。迁移完成后只继续维护根目录文件。
|
||||
|
||||
## 执行规则
|
||||
|
||||
- 每完成一个阶段,立即更新 `task_plan.md` 和 `progress.md`。
|
||||
|
||||
Reference in New Issue
Block a user