@cat-kit/agent-context 1.1.1 → 1.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/content/actions.js
CHANGED
|
@@ -110,7 +110,7 @@ const e=[`init`,`plan`,`replan`,`implement`,`patch`,`rush`],t={init:n,plan:r,rep
|
|
|
110
110
|
3. 生成新的拆分方案，保持「单当前计划 + 若干 preparing 计划」结构。
|
|
111
111
|
4. 新增计划编号：全局 max(N)+1 递增分配；未改动计划保持原编号。
|
|
112
112
|
5. 更新目录结构，确保每个新计划的 \`plan.md\` 遵循标准模板。
|
|
113
|
-
`}function a(){return"# implement\n\n实施当前计划 `.agent-context/plan-{number}/plan.md` 中的全部步骤，通过验证循环后将状态更新为「已执行」。\n\n不接受额外描述。\n\n## 前置检查\n\n- 运行 `agent-context validate`，不通过则中止并报告错误。\n- 带描述 → 拒绝执行。\n- 当前计划不存在 → 拒绝执行，提示先创建计划。\n- 当前计划状态为 `已执行` → 拒绝执行，提示使用 patch 修补或运行 `agent-context done` 归档。\n- `## 目标` 或 `## 内容` 为空 → 拒绝执行，提示补充。\n- 存在多个当前计划 → 拒绝执行，提示恢复单活跃状态。\n- 仅操作当前计划，不直接操作 `preparing/` 中的计划。\n- 遇到阻塞问题应向用户报告，不可静默跳过。\n\n## 执行步骤\n\n1. 读取当前计划 `plan.md`，理解 `## 目标` 与 `## 内容`。\n2. 依据 `## 内容` 中的步骤逐项实施。\n3. **验证循环**（全部通过前不可进入步骤 4）：\n a. 逐项对照 `## 内容` 确认每个步骤已实施。\n b. 运行项目验证：类型检查 →
|
|
113
|
+
`}function a(){return"# implement\n\n实施当前计划 `.agent-context/plan-{number}/plan.md` 中的全部步骤，通过验证循环后将状态更新为「已执行」。\n\n不接受额外描述。\n\n## 前置检查\n\n- 运行 `agent-context validate`，不通过则中止并报告错误。\n- 带描述 → 拒绝执行。\n- 当前计划不存在 → 拒绝执行，提示先创建计划。\n- 当前计划状态为 `已执行` → 拒绝执行，提示使用 patch 修补或运行 `agent-context done` 归档。\n- `## 目标` 或 `## 内容` 为空 → 拒绝执行，提示补充。\n- 存在多个当前计划 → 拒绝执行，提示恢复单活跃状态。\n- 仅操作当前计划，不直接操作 `preparing/` 中的计划。\n- 遇到阻塞问题应向用户报告，不可静默跳过。\n\n## 执行步骤\n\n1. 读取当前计划 `plan.md`，理解 `## 目标` 与 `## 内容`。\n2. 依据 `## 内容` 中的步骤逐项实施。\n3. **验证循环**（全部通过前不可进入步骤 4）：\n a. 逐项对照 `## 内容` 确认每个步骤已实施。\n b. 运行项目验证：类型检查 → 测试。\n c. 若存在失败项 → 修复后回到 a 重新验证。\n d. 全部通过 → 进入步骤 4。\n4. 更新 `plan.md` 状态行：`> 状态: 未执行` → `> 状态: 已执行`。\n5. 更新 `## 影响范围`，记录所有变更文件。\n"}function o(){return`# patch
|
|
114
114
|
|
|
115
115
|
基于当前已执行计划创建增量补丁，修复问题或追加变更。
|
|
116
116
|
|
|
@@ -169,7 +169,7 @@ const e=[`init`,`plan`,`replan`,`implement`,`patch`,`rush`],t={init:n,plan:r,rep
|
|
|
169
169
|
2. 无需用户确认计划内容，直接进入 implement 流程。
|
|
170
170
|
3. 按 implement 协议执行全部步骤，包括验证循环：
|
|
171
171
|
a. 逐项对照 \`## 内容\` 确认每个步骤已实施。
|
|
172
|
-
b. 运行项目验证：类型检查 →
|
|
172
|
+
b. 运行项目验证：类型检查 → 测试。
|
|
173
173
|
c. 若存在失败项 → 修复后重新验证。
|
|
174
174
|
d. 全部通过 → 进入步骤 4。
|
|
175
175
|
4. 更新 \`plan.md\` 状态行为 \`已执行\`，更新 \`## 影响范围\`。
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"actions.js","names":[],"sources":["../../src/content/actions.ts"],"sourcesContent":["export const ACTION_NAMES = ['init', 'plan', 'replan', 'implement', 'patch', 'rush'] as const\ntype ActionName = (typeof ACTION_NAMES)[number]\n\nexport const ACTION_RENDERERS: Record<ActionName, () => string> = {\n init: renderInit,\n plan: renderPlan,\n replan: renderReplan,\n implement: renderImplement,\n patch: renderPatch,\n rush: renderRush\n}\n\nfunction renderInit(): string {\n return `# init\n\n初始化项目的 Agent Context 上下文。根据新旧项目类型处理 \\`AGENTS.md\\`，新项目会自动进入计划创建流程。\n\n可附带描述参数，用于补充项目背景、技术栈、特殊约束。\n\n## 执行步骤\n\n1. **判断项目类型**：检测根目录是否存在有效代码文件和目录结构。\n - 新项目：无实质代码，或用户明确说明是新项目。\n - 旧项目：已有代码、配置文件和目录结构。\n - 无法判断 → 向用户提问澄清，不可假设。\n\n2. **处理 AGENTS.md**：\n - 新项目：\n 1. 通过提问澄清以下要点（已从描述中获取的可跳过）：项目目标与核心功能、技术栈与版本、代码规范与工具链（lint/formatter/测试）、目录结构偏好。\n 2. 生成高质量 \\`AGENTS.md\\`（须满足下方质量标准，不满足则重新优化直至满足）。\n 3. 继续执行 plan 创建初始计划。\n - 旧项目：\n 1. 若不存在 \\`AGENTS.md\\`：通过提问与代码阅读收集信息后生成。\n 2. 若已存在 \\`AGENTS.md\\`：按质量标准评估，不足时增补优化。\n 3. 默认不创建计划（除非用户明确要求）。\n\n3. **输出反馈**：向用户报告项目类型判定结果、AGENTS.md 处理结果、是否需要后续计划。\n\n## 高质量 AGENTS.md 标准\n\n- 常用命令与约束前置，降低代理执行歧义。\n- 明确列出目录结构（至少到第二层）。\n- 明确标注技术栈及版本。\n- 明确代码风格约束（命名规范、格式化工具、lint 配置）。\n- 内容精简，无冗余段落或模板化填充。\n- 大型单体仓库按子包拆分维护本地 \\`AGENTS.md\\`。\n`\n}\n\nfunction renderPlan(): string {\n return `# plan\n\n创建新的执行计划，写入 \\`.agent-context/plan-{number}/plan.md\\`。按复杂度可拆分为多个计划，维护「单当前计划 + preparing 队列」结构。\n\n必须附带计划描述。\n\n## 前置检查\n\n- 运行 \\`agent-context validate\\`，不通过则中止并报告错误。\n- 描述为空 → 拒绝执行。\n- 存在未归档的已执行当前计划 → 拒绝执行，提示先运行 \\`agent-context done\\` 归档。\n- 存在多个当前计划 → 拒绝执行，提示恢复单活跃状态。\n\n## 执行步骤\n\n1. **需求澄清**（存在以下任一歧义时必须提问，否则跳到步骤 2）：\n - 范围边界不清：无法判定影响哪些文件或模块。\n - 存在显著不同的技术路径需用户决策。\n - 验收标准不明确：无法判断何时算\"完成\"。\n2. 按复杂度决定单计划或多计划拆分。\n3. 多计划拆分时：最小编号进入 \\`.agent-context/\\` 作为当前计划，其余进入 \\`.agent-context/preparing/\\`。单计划直接创建。\n4. 每个计划创建 \\`plan.md\\`，遵循下方模板。\n5. **自检**（不通过则修改后重新检查）：\n - 每个步骤可独立执行且有明确完成标准。\n - 不存在过度拆分或拆分不足。\n - 影响范围可预估。\n\n## plan.md 模板\n\n\\`\\`\\`markdown\n# {计划名称}\n\n> 状态: 未执行\n\n## 目标\n\n{明确的目标描述}\n\n## 内容\n\n{详细的实施步骤}\n\n## 影响范围\n\n## 历史补丁\n\\`\\`\\`\n\n- 状态行唯一，仅允许 \\`未执行\\` 或 \\`已执行\\`。\n- \\`## 目标\\` 与 \\`## 内容\\` 不可为空。\n- \\`## 影响范围\\` 与 \\`## 历史补丁\\` 创建时留空，后续由 implement 和 patch 写入。\n`\n}\n\nfunction renderReplan(): string {\n return `# replan\n\n重新规划已有的未实施计划，保持「单当前计划 + preparing 队列」结构不变。\n\n必须附带重规划描述。\n\n## 前置检查\n\n- 运行 \\`agent-context validate\\`，不通过则中止并报告错误。\n- 描述为空 → 拒绝执行。\n- 无未实施计划 → 拒绝执行，提示使用 plan 创建。\n- 存在多个当前计划 → 拒绝执行，提示恢复单活跃状态。\n- 目标计划编号不存在 → 拒绝执行，列出可选编号。\n- 目标计划已执行 → 拒绝执行，提示使用 patch。\n\n## 作用域\n\n- 默认作用域：\\`.agent-context/preparing/\\` 中全部未实施计划。\n- 可通过描述指定仅重规划部分计划（如\"重规划 plan-3 和 plan-5\"）。\n- 当前计划为 \\`已执行\\` → 禁止重写，仅允许重规划 \\`preparing/\\` 队列。\n- 当前计划为 \\`未执行\\` 且用户明确要求 → 可纳入重规划范围。\n\n## 执行步骤\n\n1. 解析描述，确定重规划目标范围。\n2. 读取目标计划 \\`plan.md\\`，理解现有意图。\n3. 生成新的拆分方案，保持「单当前计划 + 若干 preparing 计划」结构。\n4. 新增计划编号：全局 max(N)+1 递增分配；未改动计划保持原编号。\n5. 更新目录结构，确保每个新计划的 \\`plan.md\\` 遵循标准模板。\n`\n}\n\nfunction renderImplement(): string {\n return `# implement\n\n实施当前计划 \\`.agent-context/plan-{number}/plan.md\\` 中的全部步骤，通过验证循环后将状态更新为「已执行」。\n\n不接受额外描述。\n\n## 前置检查\n\n- 运行 \\`agent-context validate\\`，不通过则中止并报告错误。\n- 带描述 → 拒绝执行。\n- 当前计划不存在 → 拒绝执行，提示先创建计划。\n- 当前计划状态为 \\`已执行\\` → 拒绝执行，提示使用 patch 修补或运行 \\`agent-context done\\` 归档。\n- \\`## 目标\\` 或 \\`## 内容\\` 为空 → 拒绝执行，提示补充。\n- 存在多个当前计划 → 拒绝执行，提示恢复单活跃状态。\n- 仅操作当前计划，不直接操作 \\`preparing/\\` 中的计划。\n- 遇到阻塞问题应向用户报告，不可静默跳过。\n\n## 执行步骤\n\n1. 读取当前计划 \\`plan.md\\`，理解 \\`## 目标\\` 与 \\`## 内容\\`。\n2. 依据 \\`## 内容\\` 中的步骤逐项实施。\n3. **验证循环**（全部通过前不可进入步骤 4）：\n a. 逐项对照 \\`## 内容\\` 确认每个步骤已实施。\n b. 运行项目验证：类型检查 →
|
|
1
|
+
{"version":3,"file":"actions.js","names":[],"sources":["../../src/content/actions.ts"],"sourcesContent":["export const ACTION_NAMES = ['init', 'plan', 'replan', 'implement', 'patch', 'rush'] as const\ntype ActionName = (typeof ACTION_NAMES)[number]\n\nexport const ACTION_RENDERERS: Record<ActionName, () => string> = {\n init: renderInit,\n plan: renderPlan,\n replan: renderReplan,\n implement: renderImplement,\n patch: renderPatch,\n rush: renderRush\n}\n\nfunction renderInit(): string {\n return `# init\n\n初始化项目的 Agent Context 上下文。根据新旧项目类型处理 \\`AGENTS.md\\`，新项目会自动进入计划创建流程。\n\n可附带描述参数，用于补充项目背景、技术栈、特殊约束。\n\n## 执行步骤\n\n1. **判断项目类型**：检测根目录是否存在有效代码文件和目录结构。\n - 新项目：无实质代码，或用户明确说明是新项目。\n - 旧项目：已有代码、配置文件和目录结构。\n - 无法判断 → 向用户提问澄清，不可假设。\n\n2. **处理 AGENTS.md**：\n - 新项目：\n 1. 通过提问澄清以下要点（已从描述中获取的可跳过）：项目目标与核心功能、技术栈与版本、代码规范与工具链（lint/formatter/测试）、目录结构偏好。\n 2. 生成高质量 \\`AGENTS.md\\`（须满足下方质量标准，不满足则重新优化直至满足）。\n 3. 继续执行 plan 创建初始计划。\n - 旧项目：\n 1. 若不存在 \\`AGENTS.md\\`：通过提问与代码阅读收集信息后生成。\n 2. 若已存在 \\`AGENTS.md\\`：按质量标准评估，不足时增补优化。\n 3. 默认不创建计划（除非用户明确要求）。\n\n3. **输出反馈**：向用户报告项目类型判定结果、AGENTS.md 处理结果、是否需要后续计划。\n\n## 高质量 AGENTS.md 标准\n\n- 常用命令与约束前置，降低代理执行歧义。\n- 明确列出目录结构（至少到第二层）。\n- 明确标注技术栈及版本。\n- 明确代码风格约束（命名规范、格式化工具、lint 配置）。\n- 内容精简，无冗余段落或模板化填充。\n- 大型单体仓库按子包拆分维护本地 \\`AGENTS.md\\`。\n`\n}\n\nfunction renderPlan(): string {\n return `# plan\n\n创建新的执行计划，写入 \\`.agent-context/plan-{number}/plan.md\\`。按复杂度可拆分为多个计划，维护「单当前计划 + preparing 队列」结构。\n\n必须附带计划描述。\n\n## 前置检查\n\n- 运行 \\`agent-context validate\\`，不通过则中止并报告错误。\n- 描述为空 → 拒绝执行。\n- 存在未归档的已执行当前计划 → 拒绝执行，提示先运行 \\`agent-context done\\` 归档。\n- 存在多个当前计划 → 拒绝执行，提示恢复单活跃状态。\n\n## 执行步骤\n\n1. **需求澄清**（存在以下任一歧义时必须提问，否则跳到步骤 2）：\n - 范围边界不清：无法判定影响哪些文件或模块。\n - 存在显著不同的技术路径需用户决策。\n - 验收标准不明确：无法判断何时算\"完成\"。\n2. 按复杂度决定单计划或多计划拆分。\n3. 多计划拆分时：最小编号进入 \\`.agent-context/\\` 作为当前计划，其余进入 \\`.agent-context/preparing/\\`。单计划直接创建。\n4. 每个计划创建 \\`plan.md\\`，遵循下方模板。\n5. **自检**（不通过则修改后重新检查）：\n - 每个步骤可独立执行且有明确完成标准。\n - 不存在过度拆分或拆分不足。\n - 影响范围可预估。\n\n## plan.md 模板\n\n\\`\\`\\`markdown\n# {计划名称}\n\n> 状态: 未执行\n\n## 目标\n\n{明确的目标描述}\n\n## 内容\n\n{详细的实施步骤}\n\n## 影响范围\n\n## 历史补丁\n\\`\\`\\`\n\n- 状态行唯一，仅允许 \\`未执行\\` 或 \\`已执行\\`。\n- \\`## 目标\\` 与 \\`## 内容\\` 不可为空。\n- \\`## 影响范围\\` 与 \\`## 历史补丁\\` 创建时留空，后续由 implement 和 patch 写入。\n`\n}\n\nfunction renderReplan(): string {\n return `# replan\n\n重新规划已有的未实施计划，保持「单当前计划 + preparing 队列」结构不变。\n\n必须附带重规划描述。\n\n## 前置检查\n\n- 运行 \\`agent-context validate\\`，不通过则中止并报告错误。\n- 描述为空 → 拒绝执行。\n- 无未实施计划 → 拒绝执行，提示使用 plan 创建。\n- 存在多个当前计划 → 拒绝执行，提示恢复单活跃状态。\n- 目标计划编号不存在 → 拒绝执行，列出可选编号。\n- 目标计划已执行 → 拒绝执行，提示使用 patch。\n\n## 作用域\n\n- 默认作用域：\\`.agent-context/preparing/\\` 中全部未实施计划。\n- 可通过描述指定仅重规划部分计划（如\"重规划 plan-3 和 plan-5\"）。\n- 当前计划为 \\`已执行\\` → 禁止重写，仅允许重规划 \\`preparing/\\` 队列。\n- 当前计划为 \\`未执行\\` 且用户明确要求 → 可纳入重规划范围。\n\n## 执行步骤\n\n1. 解析描述，确定重规划目标范围。\n2. 读取目标计划 \\`plan.md\\`，理解现有意图。\n3. 生成新的拆分方案，保持「单当前计划 + 若干 preparing 计划」结构。\n4. 新增计划编号：全局 max(N)+1 递增分配；未改动计划保持原编号。\n5. 更新目录结构，确保每个新计划的 \\`plan.md\\` 遵循标准模板。\n`\n}\n\nfunction renderImplement(): string {\n return `# implement\n\n实施当前计划 \\`.agent-context/plan-{number}/plan.md\\` 中的全部步骤，通过验证循环后将状态更新为「已执行」。\n\n不接受额外描述。\n\n## 前置检查\n\n- 运行 \\`agent-context validate\\`，不通过则中止并报告错误。\n- 带描述 → 拒绝执行。\n- 当前计划不存在 → 拒绝执行，提示先创建计划。\n- 当前计划状态为 \\`已执行\\` → 拒绝执行，提示使用 patch 修补或运行 \\`agent-context done\\` 归档。\n- \\`## 目标\\` 或 \\`## 内容\\` 为空 → 拒绝执行，提示补充。\n- 存在多个当前计划 → 拒绝执行，提示恢复单活跃状态。\n- 仅操作当前计划，不直接操作 \\`preparing/\\` 中的计划。\n- 遇到阻塞问题应向用户报告，不可静默跳过。\n\n## 执行步骤\n\n1. 读取当前计划 \\`plan.md\\`，理解 \\`## 目标\\` 与 \\`## 内容\\`。\n2. 依据 \\`## 内容\\` 中的步骤逐项实施。\n3. **验证循环**（全部通过前不可进入步骤 4）：\n a. 逐项对照 \\`## 内容\\` 确认每个步骤已实施。\n b. 运行项目验证：类型检查 → 测试。\n c. 若存在失败项 → 修复后回到 a 重新验证。\n d. 全部通过 → 进入步骤 4。\n4. 更新 \\`plan.md\\` 状态行：\\`> 状态: 未执行\\` → \\`> 状态: 已执行\\`。\n5. 更新 \\`## 影响范围\\`，记录所有变更文件。\n`\n}\n\nfunction renderPatch(): string {\n return `# patch\n\n基于当前已执行计划创建增量补丁，修复问题或追加变更。\n\n必须附带补丁描述。\n\n## 前置检查\n\n- 运行 \\`agent-context validate\\`，不通过则中止并报告错误。\n- 描述为空 → 拒绝执行。\n- 当前计划不存在 → 拒绝执行，提示先创建计划。\n- 当前计划状态为 \\`未执行\\` → 拒绝执行，提示先实施。\n- 存在多个当前计划 → 拒绝执行，提示恢复单活跃状态。\n- 补丁不改变计划状态，完成后保持 \\`已执行\\`。\n\n## 执行步骤\n\n1. 阅读 \\`plan.md\\` 与已有 \\`patch-{number}.md\\`，了解上下文与历史，避免重复修复。\n2. 根据描述执行补丁所需的代码变更。\n3. 完成必要验证（测试、类型检查等）。\n4. 创建 \\`patch-{number}.md\\`（编号：扫描当前计划目录已有补丁取 max+1），遵循下方模板。\n5. 回写 \\`plan.md\\`：\n - \\`## 历史补丁\\`：追加 \\`- patch-{number}: {补丁名称}\\`，按编号去重。\n - \\`## 影响范围\\`：合并本次变更路径，按路径去重。\n\n## patch.md 模板\n\n\\`\\`\\`markdown\n# {补丁名称}\n\n## 补丁内容\n\n{修改了什么、为什么修改}\n\n## 影响范围\n\n- 新增文件: \\`/path/to/file\\`\n- 修改文件: \\`/path/to/file\\`\n- 删除文件: \\`/path/to/file\\`\n\\`\\`\\`\n`\n}\n\nfunction renderRush(): string {\n return `# rush\n\n快速通道：创建计划并立即实施，适合范围明确、无需多轮规划的任务。\n\n必须附带任务描述。\n\n## 前置检查\n\n- 运行 \\`agent-context validate\\`，不通过则中止并报告错误。\n- 描述为空 → 拒绝执行。\n- 存在未归档的已执行当前计划 → 拒绝执行，提示先运行 \\`agent-context done\\` 归档。\n- 存在未实施的当前计划 → 拒绝执行，提示先 implement 或 replan。\n\n## 执行步骤\n\n1. 按 plan 协议创建单计划（不拆分，不进入 preparing 队列）。\n2. 无需用户确认计划内容，直接进入 implement 流程。\n3. 按 implement 协议执行全部步骤，包括验证循环：\n a. 逐项对照 \\`## 内容\\` 确认每个步骤已实施。\n b. 运行项目验证：类型检查 → 测试。\n c. 若存在失败项 → 修复后重新验证。\n d. 全部通过 → 进入步骤 4。\n4. 更新 \\`plan.md\\` 状态行为 \\`已执行\\`，更新 \\`## 影响范围\\`。\n`\n}\n"],"mappings":"AAAA,MAAa,EAAe,CAAC,OAAQ,OAAQ,SAAU,YAAa,QAAS,OAAO,CAGvE,EAAqD,CAChE,KAAM,EACN,KAAM,EACN,OAAQ,EACR,UAAW,EACX,MAAO,EACP,KAAM,EACP,CAED,SAAS,GAAqB,CAC5B,MAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCT,SAAS,GAAqB,CAC5B,MAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqDT,SAAS,GAAuB,CAC9B,MAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgCT,SAAS,GAA0B,CACjC,MAAO,irBA+BT,SAAS,GAAsB,CAC7B,MAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2CT,SAAS,GAAqB,CAC5B,MAAO"}
|
package/dist/content/index.js
CHANGED
|
@@ -11,10 +11,12 @@ import{ACTION_NAMES as e,ACTION_RENDERERS as t}from"./actions.js";function n(n){
|
|
|
11
11
|
| 给需求出计划、拆分任务 | plan | \`actions/plan.md\` |
|
|
12
12
|
| 重做计划、调整方案 | replan | \`actions/replan.md\` |
|
|
13
13
|
| 按计划开始做、实现当前计划 | implement | \`actions/implement.md\` |
|
|
14
|
-
|
|
|
15
|
-
|
|
|
14
|
+
| 实施后不满意、追加需求、修补问题 | patch | \`actions/patch.md\` |
|
|
15
|
+
| 无活跃计划时快速出计划并实施 | rush | \`actions/rush.md\` |
|
|
16
16
|
| 任务彻底完成、归档当前计划 | done | 运行 \`agent-context done\` |
|
|
17
17
|
|
|
18
|
+
> **消歧**：存在已执行的当前计划时，用户提出任何变更需求 → 一律走 **patch**，禁止走 plan / rush。
|
|
19
|
+
|
|
18
20
|
## 全局约束
|
|
19
21
|
|
|
20
22
|
- 状态机两态：\`未执行\`、\`已执行\`。
|
|
@@ -38,7 +40,7 @@ import{ACTION_NAMES as e,ACTION_RENDERERS as t}from"./actions.js";function n(n){
|
|
|
38
40
|
编号规则：扫描全部 \`plan-N\` 目录取 \`max(N)+1\`。
|
|
39
41
|
`}function i(e){let t=[`---`,`name: ac-workflow`,`description: 管理 .agent-context 计划生命周期，按 init、plan、replan、implement、patch、rush、done 协议推进任务。`];return e.frontmatterProfile===`claude`&&t.push(`argument-hint: [request]`),e.frontmatterProfile===`copilot`&&t.push(`license: MIT`),t.push(`---`,``),`${t.join(`
|
|
40
42
|
`)}\n`}function a(){return`interface:
|
|
41
|
-
display_name: "Agent Context"
|
|
43
|
+
display_name: "Agent Context Workflow"
|
|
42
44
|
short_description: "统一管理 .agent-context 计划生命周期"
|
|
43
45
|
default_prompt: "Use $ac-workflow to manage the current task through init, plan, replan, implement, patch, rush, or done."
|
|
44
46
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../../src/content/index.ts"],"sourcesContent":["import type { SkillArtifacts, ToolTarget } from '../types.js'\nimport { ACTION_NAMES, ACTION_RENDERERS } from './actions.js'\n\nconst SKILL_NAME = 'ac-workflow'\nconst SKILL_DESCRIPTION =\n '管理 .agent-context 计划生命周期，按 init、plan、replan、implement、patch、rush、done 协议推进任务。'\n\nexport function renderSkillArtifacts(target: ToolTarget): SkillArtifacts {\n const files: SkillArtifacts['files'] = [\n { relativePath: 'SKILL.md', body: renderNavigator(target) },\n ...ACTION_NAMES.map((name) => ({\n relativePath: `actions/${name}.md`,\n body: ACTION_RENDERERS[name]()\n }))\n ]\n\n if (target.metadataFiles.includes('openai')) {\n files.push({ relativePath: 'agents/openai.yaml', body: renderOpenAIMetadata() })\n }\n\n return { files }\n}\n\n// ── Navigator ────────────────────────────────────────\n\nfunction renderNavigator(target: ToolTarget): string {\n return `${renderFrontmatter(target)}\n# Agent Context\n\n管理项目中的 \\`.agent-context/\\` 计划生命周期。匹配用户意图后，读取对应协议文件（相对于本文件所在目录）严格执行。\n\n## 意图匹配\n\n| 用户意图 | 动作 | 协议文件 |\n|----------|------|----------|\n| 初始化项目上下文、补全 AGENTS | init | \\`actions/init.md\\` |\n| 给需求出计划、拆分任务 | plan | \\`actions/plan.md\\` |\n| 重做计划、调整方案 | replan | \\`actions/replan.md\\` |\n| 按计划开始做、实现当前计划 | implement | \\`actions/implement.md\\` |\n|
|
|
1
|
+
{"version":3,"file":"index.js","names":[],"sources":["../../src/content/index.ts"],"sourcesContent":["import type { SkillArtifacts, ToolTarget } from '../types.js'\nimport { ACTION_NAMES, ACTION_RENDERERS } from './actions.js'\n\nconst SKILL_NAME = 'ac-workflow'\nconst SKILL_DESCRIPTION =\n '管理 .agent-context 计划生命周期，按 init、plan、replan、implement、patch、rush、done 协议推进任务。'\n\nexport function renderSkillArtifacts(target: ToolTarget): SkillArtifacts {\n const files: SkillArtifacts['files'] = [\n { relativePath: 'SKILL.md', body: renderNavigator(target) },\n ...ACTION_NAMES.map((name) => ({\n relativePath: `actions/${name}.md`,\n body: ACTION_RENDERERS[name]()\n }))\n ]\n\n if (target.metadataFiles.includes('openai')) {\n files.push({ relativePath: 'agents/openai.yaml', body: renderOpenAIMetadata() })\n }\n\n return { files }\n}\n\n// ── Navigator ────────────────────────────────────────\n\nfunction renderNavigator(target: ToolTarget): string {\n return `${renderFrontmatter(target)}\n# Agent Context\n\n管理项目中的 \\`.agent-context/\\` 计划生命周期。匹配用户意图后，读取对应协议文件（相对于本文件所在目录）严格执行。\n\n## 意图匹配\n\n| 用户意图 | 动作 | 协议文件 |\n|----------|------|----------|\n| 初始化项目上下文、补全 AGENTS | init | \\`actions/init.md\\` |\n| 给需求出计划、拆分任务 | plan | \\`actions/plan.md\\` |\n| 重做计划、调整方案 | replan | \\`actions/replan.md\\` |\n| 按计划开始做、实现当前计划 | implement | \\`actions/implement.md\\` |\n| 实施后不满意、追加需求、修补问题 | patch | \\`actions/patch.md\\` |\n| 无活跃计划时快速出计划并实施 | rush | \\`actions/rush.md\\` |\n| 任务彻底完成、归档当前计划 | done | 运行 \\`agent-context done\\` |\n\n> **消歧**：存在已执行的当前计划时，用户提出任何变更需求 → 一律走 **patch**，禁止走 plan / rush。\n\n## 全局约束\n\n- 状态机两态：\\`未执行\\`、\\`已执行\\`。\n- 任意时刻最多一个当前计划：\\`.agent-context/plan-{number}\\`。\n- 多个当前计划 → 拒绝执行，提示恢复单活跃状态。\n- 计划编号全局递增，不复用。补丁编号在单计划目录内递增，不复用。\n\n## 目录结构\n\n\\`\\`\\`text\n.agent-context/\n├── plan-{N}/ # 当前计划（最多一个）\n│ ├── plan.md\n│ └── patch-{N}.md\n├── preparing/ # 待执行计划队列\n│ └── plan-{N}/\n└── done/ # 已归档计划\n └── plan-{N}-{YYYYMMDD}/\n\\`\\`\\`\n\n编号规则：扫描全部 \\`plan-N\\` 目录取 \\`max(N)+1\\`。\n`\n}\n\n// ── Frontmatter & Metadata ──────────────────────────\n\nfunction renderFrontmatter(target: ToolTarget): string {\n const lines = ['---', `name: ${SKILL_NAME}`, `description: ${SKILL_DESCRIPTION}`]\n\n if (target.frontmatterProfile === 'claude') {\n lines.push('argument-hint: [request]')\n }\n\n if (target.frontmatterProfile === 'copilot') {\n lines.push('license: MIT')\n }\n\n lines.push('---', '')\n return `${lines.join('\\n')}\\n`\n}\n\nfunction renderOpenAIMetadata(): string {\n return `interface:\n display_name: \"Agent Context Workflow\"\n short_description: \"统一管理 .agent-context 计划生命周期\"\n default_prompt: \"Use $ac-workflow to manage the current task through init, plan, replan, implement, patch, rush, or done.\"\n\npolicy:\n allow_implicit_invocation: true\n`\n}\n"],"mappings":"kEAOA,SAAgB,EAAqB,EAAoC,CACvE,IAAM,EAAiC,CACrC,CAAE,aAAc,WAAY,KAAM,EAAgB,EAAO,CAAE,CAC3D,GAAG,EAAa,IAAK,IAAU,CAC7B,aAAc,WAAW,EAAK,KAC9B,KAAM,EAAiB,IAAO,CAC/B,EAAE,CACJ,CAMD,OAJI,EAAO,cAAc,SAAS,SAAS,EACzC,EAAM,KAAK,CAAE,aAAc,qBAAsB,KAAM,GAAsB,CAAE,CAAC,CAG3E,CAAE,QAAO,CAKlB,SAAS,EAAgB,EAA4B,CACnD,MAAO,GAAG,EAAkB,EAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6CtC,SAAS,EAAkB,EAA4B,CACrD,IAAM,EAAQ,CAAC,MAAO,oBAAuB,6FAAoC,CAWjF,OATI,EAAO,qBAAuB,UAChC,EAAM,KAAK,2BAA2B,CAGpC,EAAO,qBAAuB,WAChC,EAAM,KAAK,eAAe,CAG5B,EAAM,KAAK,MAAO,GAAG,CACd,GAAG,EAAM,KAAK;EAAK,CAAC,IAG7B,SAAS,GAA+B,CACtC,MAAO"}
|
package/dist/stats.html
CHANGED
|
@@ -4930,7 +4930,7 @@ var drawChart = (function (exports) {
|
|
|
4930
4930
|
</script>
|
|
4931
4931
|
<script>
|
|
4932
4932
|
/*<!--*/
|
|
4933
|
-
const data = {"version":2,"tree":{"name":"root","children":[{"name":"cli.d.ts","children":[{"name":"home/whj/codes/cat-kit/packages/agent-context/src/cli.d.ts","uid":"
|
|
4933
|
+
const data = {"version":2,"tree":{"name":"root","children":[{"name":"cli.d.ts","children":[{"name":"home/whj/codes/cat-kit/packages/agent-context/src/cli.d.ts","uid":"a194fe0a-1"}]},{"name":"cli.js","children":[{"name":"home/whj/codes/cat-kit/packages/agent-context/src/cli.ts","uid":"a194fe0a-3"}]},{"name":"commands/done.js","children":[{"name":"home/whj/codes/cat-kit/packages/agent-context/src/commands/done.ts","uid":"a194fe0a-5"}]},{"name":"commands/install.js","children":[{"name":"home/whj/codes/cat-kit/packages/agent-context/src/commands/install.ts","uid":"a194fe0a-7"}]},{"name":"commands/printer.js","children":[{"name":"home/whj/codes/cat-kit/packages/agent-context/src/commands/printer.ts","uid":"a194fe0a-9"}]},{"name":"commands/status.js","children":[{"name":"home/whj/codes/cat-kit/packages/agent-context/src/commands/status.ts","uid":"a194fe0a-11"}]},{"name":"commands/sync.js","children":[{"name":"home/whj/codes/cat-kit/packages/agent-context/src/commands/sync.ts","uid":"a194fe0a-13"}]},{"name":"commands/validate.js","children":[{"name":"home/whj/codes/cat-kit/packages/agent-context/src/commands/validate.ts","uid":"a194fe0a-15"}]},{"name":"content/actions.js","children":[{"name":"home/whj/codes/cat-kit/packages/agent-context/src/content/actions.ts","uid":"a194fe0a-17"}]},{"name":"content/index.js","children":[{"name":"home/whj/codes/cat-kit/packages/agent-context/src/content/index.ts","uid":"a194fe0a-19"}]},{"name":"context/archiver.js","children":[{"name":"home/whj/codes/cat-kit/packages/agent-context/src/context/archiver.ts","uid":"a194fe0a-21"}]},{"name":"context/reader.js","children":[{"name":"home/whj/codes/cat-kit/packages/agent-context/src/context/reader.ts","uid":"a194fe0a-23"}]},{"name":"context/validator.js","children":[{"name":"home/whj/codes/cat-kit/packages/agent-context/src/context/validator.ts","uid":"a194fe0a-25"}]},{"name":"runner.js","children":[{"name":"home/whj/codes/cat-kit/packages/agent-context/src/runner.ts","uid":"a194fe0a-27"}]},{"name":"tools.js","children":[{"name":"home/whj/codes/cat-kit/packages/agent-context/src/tools.ts","uid":"a194fe0a-29"}]}],"isRoot":true},"nodeParts":{"a194fe0a-1":{"renderedLength":0,"gzipLength":0,"brotliLength":0,"metaUid":"a194fe0a-0"},"a194fe0a-3":{"renderedLength":1518,"gzipLength":0,"brotliLength":0,"metaUid":"a194fe0a-2"},"a194fe0a-5":{"renderedLength":1349,"gzipLength":0,"brotliLength":0,"metaUid":"a194fe0a-4"},"a194fe0a-7":{"renderedLength":985,"gzipLength":0,"brotliLength":0,"metaUid":"a194fe0a-6"},"a194fe0a-9":{"renderedLength":909,"gzipLength":0,"brotliLength":0,"metaUid":"a194fe0a-8"},"a194fe0a-11":{"renderedLength":944,"gzipLength":0,"brotliLength":0,"metaUid":"a194fe0a-10"},"a194fe0a-13":{"renderedLength":745,"gzipLength":0,"brotliLength":0,"metaUid":"a194fe0a-12"},"a194fe0a-15":{"renderedLength":758,"gzipLength":0,"brotliLength":0,"metaUid":"a194fe0a-14"},"a194fe0a-17":{"renderedLength":8872,"gzipLength":0,"brotliLength":0,"metaUid":"a194fe0a-16"},"a194fe0a-19":{"renderedLength":3024,"gzipLength":0,"brotliLength":0,"metaUid":"a194fe0a-18"},"a194fe0a-21":{"renderedLength":1012,"gzipLength":0,"brotliLength":0,"metaUid":"a194fe0a-20"},"a194fe0a-23":{"renderedLength":1573,"gzipLength":0,"brotliLength":0,"metaUid":"a194fe0a-22"},"a194fe0a-25":{"renderedLength":1039,"gzipLength":0,"brotliLength":0,"metaUid":"a194fe0a-24"},"a194fe0a-27":{"renderedLength":2037,"gzipLength":0,"brotliLength":0,"metaUid":"a194fe0a-26"},"a194fe0a-29":{"renderedLength":2174,"gzipLength":0,"brotliLength":0,"metaUid":"a194fe0a-28"}},"nodeMetas":{"a194fe0a-0":{"id":"/home/whj/codes/cat-kit/packages/agent-context/src/cli.d.ts","moduleParts":{"cli.d.ts":"a194fe0a-1"},"imported":[],"importedBy":[],"isEntry":true},"a194fe0a-2":{"id":"/home/whj/codes/cat-kit/packages/agent-context/src/cli.ts","moduleParts":{"cli.js":"a194fe0a-3"},"imported":[{"uid":"a194fe0a-30"},{"uid":"a194fe0a-31"},{"uid":"a194fe0a-4"},{"uid":"a194fe0a-6"},{"uid":"a194fe0a-10"},{"uid":"a194fe0a-12"},{"uid":"a194fe0a-14"}],"importedBy":[],"isEntry":true},"a194fe0a-4":{"id":"/home/whj/codes/cat-kit/packages/agent-context/src/commands/done.ts","moduleParts":{"commands/done.js":"a194fe0a-5"},"imported":[{"uid":"a194fe0a-32"},{"uid":"a194fe0a-33"},{"uid":"a194fe0a-34"}],"importedBy":[{"uid":"a194fe0a-2"}]},"a194fe0a-6":{"id":"/home/whj/codes/cat-kit/packages/agent-context/src/commands/install.ts","moduleParts":{"commands/install.js":"a194fe0a-7"},"imported":[{"uid":"a194fe0a-33"},{"uid":"a194fe0a-26"},{"uid":"a194fe0a-28"},{"uid":"a194fe0a-8"}],"importedBy":[{"uid":"a194fe0a-2"}]},"a194fe0a-8":{"id":"/home/whj/codes/cat-kit/packages/agent-context/src/commands/printer.ts","moduleParts":{"commands/printer.js":"a194fe0a-9"},"imported":[{"uid":"a194fe0a-32"}],"importedBy":[{"uid":"a194fe0a-6"},{"uid":"a194fe0a-12"}]},"a194fe0a-10":{"id":"/home/whj/codes/cat-kit/packages/agent-context/src/commands/status.ts","moduleParts":{"commands/status.js":"a194fe0a-11"},"imported":[{"uid":"a194fe0a-34"}],"importedBy":[{"uid":"a194fe0a-2"}]},"a194fe0a-12":{"id":"/home/whj/codes/cat-kit/packages/agent-context/src/commands/sync.ts","moduleParts":{"commands/sync.js":"a194fe0a-13"},"imported":[{"uid":"a194fe0a-28"},{"uid":"a194fe0a-26"},{"uid":"a194fe0a-8"}],"importedBy":[{"uid":"a194fe0a-2"}]},"a194fe0a-14":{"id":"/home/whj/codes/cat-kit/packages/agent-context/src/commands/validate.ts","moduleParts":{"commands/validate.js":"a194fe0a-15"},"imported":[{"uid":"a194fe0a-34"}],"importedBy":[{"uid":"a194fe0a-2"}]},"a194fe0a-16":{"id":"/home/whj/codes/cat-kit/packages/agent-context/src/content/actions.ts","moduleParts":{"content/actions.js":"a194fe0a-17"},"imported":[],"importedBy":[{"uid":"a194fe0a-18"}]},"a194fe0a-18":{"id":"/home/whj/codes/cat-kit/packages/agent-context/src/content/index.ts","moduleParts":{"content/index.js":"a194fe0a-19"},"imported":[{"uid":"a194fe0a-16"}],"importedBy":[{"uid":"a194fe0a-26"}]},"a194fe0a-20":{"id":"/home/whj/codes/cat-kit/packages/agent-context/src/context/archiver.ts","moduleParts":{"context/archiver.js":"a194fe0a-21"},"imported":[{"uid":"a194fe0a-35"},{"uid":"a194fe0a-32"}],"importedBy":[{"uid":"a194fe0a-34"}]},"a194fe0a-22":{"id":"/home/whj/codes/cat-kit/packages/agent-context/src/context/reader.ts","moduleParts":{"context/reader.js":"a194fe0a-23"},"imported":[{"uid":"a194fe0a-35"},{"uid":"a194fe0a-30"},{"uid":"a194fe0a-32"}],"importedBy":[{"uid":"a194fe0a-34"}]},"a194fe0a-24":{"id":"/home/whj/codes/cat-kit/packages/agent-context/src/context/validator.ts","moduleParts":{"context/validator.js":"a194fe0a-25"},"imported":[{"uid":"a194fe0a-30"},{"uid":"a194fe0a-32"}],"importedBy":[{"uid":"a194fe0a-34"}]},"a194fe0a-26":{"id":"/home/whj/codes/cat-kit/packages/agent-context/src/runner.ts","moduleParts":{"runner.js":"a194fe0a-27"},"imported":[{"uid":"a194fe0a-32"},{"uid":"a194fe0a-30"},{"uid":"a194fe0a-35"},{"uid":"a194fe0a-28"},{"uid":"a194fe0a-18"}],"importedBy":[{"uid":"a194fe0a-6"},{"uid":"a194fe0a-12"}]},"a194fe0a-28":{"id":"/home/whj/codes/cat-kit/packages/agent-context/src/tools.ts","moduleParts":{"tools.js":"a194fe0a-29"},"imported":[{"uid":"a194fe0a-30"},{"uid":"a194fe0a-32"}],"importedBy":[{"uid":"a194fe0a-6"},{"uid":"a194fe0a-12"},{"uid":"a194fe0a-26"}]},"a194fe0a-30":{"id":"node:fs","moduleParts":{},"imported":[],"importedBy":[{"uid":"a194fe0a-2"},{"uid":"a194fe0a-26"},{"uid":"a194fe0a-28"},{"uid":"a194fe0a-22"},{"uid":"a194fe0a-24"}]},"a194fe0a-31":{"id":"commander","moduleParts":{},"imported":[],"importedBy":[{"uid":"a194fe0a-2"}]},"a194fe0a-32":{"id":"node:path","moduleParts":{},"imported":[],"importedBy":[{"uid":"a194fe0a-4"},{"uid":"a194fe0a-26"},{"uid":"a194fe0a-28"},{"uid":"a194fe0a-8"},{"uid":"a194fe0a-22"},{"uid":"a194fe0a-24"},{"uid":"a194fe0a-20"}]},"a194fe0a-33":{"id":"@inquirer/prompts","moduleParts":{},"imported":[],"importedBy":[{"uid":"a194fe0a-4"},{"uid":"a194fe0a-6"}]},"a194fe0a-34":{"id":"/home/whj/codes/cat-kit/packages/agent-context/src/context/index.ts","moduleParts":{},"imported":[{"uid":"a194fe0a-22"},{"uid":"a194fe0a-24"},{"uid":"a194fe0a-20"}],"importedBy":[{"uid":"a194fe0a-4"},{"uid":"a194fe0a-10"},{"uid":"a194fe0a-14"}]},"a194fe0a-35":{"id":"node:fs/promises","moduleParts":{},"imported":[],"importedBy":[{"uid":"a194fe0a-26"},{"uid":"a194fe0a-22"},{"uid":"a194fe0a-20"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":false,"brotli":false,"sourcemap":false}};
|
|
4934
4934
|
|
|
4935
4935
|
const run = () => {
|
|
4936
4936
|
const width = window.innerWidth;
|
package/package.json
CHANGED
package/src/content/actions.ts
CHANGED
|
@@ -158,7 +158,7 @@ function renderImplement(): string {
|
|
|
158
158
|
2. 依据 \`## 内容\` 中的步骤逐项实施。
|
|
159
159
|
3. **验证循环**（全部通过前不可进入步骤 4）：
|
|
160
160
|
a. 逐项对照 \`## 内容\` 确认每个步骤已实施。
|
|
161
|
-
b. 运行项目验证：类型检查 →
|
|
161
|
+
b. 运行项目验证：类型检查 → 测试。
|
|
162
162
|
c. 若存在失败项 → 修复后回到 a 重新验证。
|
|
163
163
|
d. 全部通过 → 进入步骤 4。
|
|
164
164
|
4. 更新 \`plan.md\` 状态行：\`> 状态: 未执行\` → \`> 状态: 已执行\`。
|
|
@@ -230,7 +230,7 @@ function renderRush(): string {
|
|
|
230
230
|
2. 无需用户确认计划内容，直接进入 implement 流程。
|
|
231
231
|
3. 按 implement 协议执行全部步骤，包括验证循环：
|
|
232
232
|
a. 逐项对照 \`## 内容\` 确认每个步骤已实施。
|
|
233
|
-
b. 运行项目验证：类型检查 →
|
|
233
|
+
b. 运行项目验证：类型检查 → 测试。
|
|
234
234
|
c. 若存在失败项 → 修复后重新验证。
|
|
235
235
|
d. 全部通过 → 进入步骤 4。
|
|
236
236
|
4. 更新 \`plan.md\` 状态行为 \`已执行\`，更新 \`## 影响范围\`。
|
package/src/content/index.ts
CHANGED
|
@@ -37,10 +37,12 @@ function renderNavigator(target: ToolTarget): string {
|
|
|
37
37
|
| 给需求出计划、拆分任务 | plan | \`actions/plan.md\` |
|
|
38
38
|
| 重做计划、调整方案 | replan | \`actions/replan.md\` |
|
|
39
39
|
| 按计划开始做、实现当前计划 | implement | \`actions/implement.md\` |
|
|
40
|
-
|
|
|
41
|
-
|
|
|
40
|
+
| 实施后不满意、追加需求、修补问题 | patch | \`actions/patch.md\` |
|
|
41
|
+
| 无活跃计划时快速出计划并实施 | rush | \`actions/rush.md\` |
|
|
42
42
|
| 任务彻底完成、归档当前计划 | done | 运行 \`agent-context done\` |
|
|
43
43
|
|
|
44
|
+
> **消歧**：存在已执行的当前计划时，用户提出任何变更需求 → 一律走 **patch**，禁止走 plan / rush。
|
|
45
|
+
|
|
44
46
|
## 全局约束
|
|
45
47
|
|
|
46
48
|
- 状态机两态：\`未执行\`、\`已执行\`。
|
|
@@ -84,7 +86,7 @@ function renderFrontmatter(target: ToolTarget): string {
|
|
|
84
86
|
|
|
85
87
|
function renderOpenAIMetadata(): string {
|
|
86
88
|
return `interface:
|
|
87
|
-
display_name: "Agent Context"
|
|
89
|
+
display_name: "Agent Context Workflow"
|
|
88
90
|
short_description: "统一管理 .agent-context 计划生命周期"
|
|
89
91
|
default_prompt: "Use $ac-workflow to manage the current task through init, plan, replan, implement, patch, rush, or done."
|
|
90
92
|
|