feat(knowledge): 增加任务文档生命周期
This commit is contained in:
@@ -26,7 +26,7 @@ description: 初始化或更新项目的 AGENTS.md 与 .craftkit 项目资料;
|
||||
5. 展示拟创建或修改的文件及关键内容,取得确认后再写入。
|
||||
6. 从 [assets](assets/project.json) 中选择模板,生成或合并 `AGENTS.md`、`.craftkit/project.json`、目录说明、嵌套忽略规则和必要索引;存在前端能力时同时准备 `.craftkit/standards/frontend/components.md` 的最小索引。
|
||||
7. 已有文件必须先完整读取并做保守合并;不明确的用户章节和字段原样保留,不直接覆盖。
|
||||
8. 初始化后验证 JSON、索引链接,以及 `.craftkit/local/`、`.craftkit/cache/` 的 Git 忽略状态;按[文档目录配置](references/project-config.md#文档目录)验证过程、共享设计和归档路径的用途及解析结果,不创建示例文档。
|
||||
8. 初始化后验证 JSON、索引链接,以及 `.craftkit/local/`、`.craftkit/cache/` 的 Git 忽略状态;按[文档目录配置](references/project-config.md#文档目录)验证过程、共享设计、归档路径和生命周期策略,不创建示例任务或文档。
|
||||
9. 使用 `guidance` 对一个真实项目问题执行检索验证;未安装该 Skill 时改用相同的入口顺序手工验证。
|
||||
|
||||
框架版本写入 `technology.frameworks`。成熟项目优先从构建清单和锁文件探测;空项目根据用户选择或参考项目建议填写。只有公共 profile 已真实存在且版本范围匹配时才写入 `profile`,否则保留为空并记录待确认事项。
|
||||
|
||||
@@ -16,7 +16,13 @@
|
||||
"workRoot": ".craftkit/local/tasks",
|
||||
"designRoot": ".craftkit/designs",
|
||||
"archiveRoot": "docs/archive",
|
||||
"archiveRules": []
|
||||
"archiveRules": [],
|
||||
"lifecycle": {
|
||||
"onTaskComplete": "preview",
|
||||
"localRetentionDays": 7,
|
||||
"trackedFiles": "review-required",
|
||||
"personalConfig": "retain"
|
||||
}
|
||||
},
|
||||
"guidance": {
|
||||
"agentIndex": ".craftkit/agents/index.md",
|
||||
|
||||
@@ -23,12 +23,19 @@
|
||||
| `designRoot` | `.craftkit/designs` | 用户明确要求共享或正式交付的设计文档 |
|
||||
| `archiveRoot` | `docs/archive` | 用户按归档规则处理的历史或正式归档文档 |
|
||||
| `archiveRules` | `[]` | 归档匹配、目标、转换和校验规则 |
|
||||
| `lifecycle.onTaskComplete` | `preview` | 任务完成时生成关闭预览,不自动删除文件 |
|
||||
| `lifecycle.localRetentionDays` | `7` | 本地过程文档建议保留天数,超期仍需进入关闭预览 |
|
||||
| `lifecycle.trackedFiles` | `review-required` | 已跟踪文档必须逐项评审后才能删除 |
|
||||
| `lifecycle.personalConfig` | `retain` | 本地个人配置不属于任务清理范围 |
|
||||
|
||||
- 路径使用项目相对路径和正斜杠,不能包含 `..`、用户目录或其他个人机器绝对路径。
|
||||
- 初始化只写入配置,不预建空任务目录、设计目录或归档目录。
|
||||
- 成熟项目已有明确的过程文档或正式设计目录时优先延续,并展示证据;根目录中的 README、CHANGELOG 或总体工作流不能单独证明根目录是任务文档目录。
|
||||
- 用户未指定共享用途时,Skill 生成的过程文档使用 `workRoot`;用户明确要求共享或正式交付时使用 `designRoot`。
|
||||
- `archiveRoot` 不作为开发中内容的默认写入位置,归档必须按归档 Skill 的规则另行执行。
|
||||
- `workRoot/<task>/task.json` 记录任务状态、可见性和文件归属;字段结构及关闭规则由 `knowledge:document-output` 维护。
|
||||
- 生命周期配置缺失时按表中默认值解释,不为读取兼容性强制改写旧项目配置。
|
||||
- `localRetentionDays` 只用于提示,不构成删除授权;`personalConfig` 当前仅允许 `retain`。
|
||||
- 旧配置只有 `archiveRoot` 时继续兼容读取;初始化更新时展示新增字段及用途,确认后保守合并。
|
||||
|
||||
## 前端组件信息
|
||||
|
||||
Reference in New Issue
Block a user