75c510cb9d
- Add `visibleTo` field to `BaseAgentDefinition` to restrict agent visibility to specific parent agent types - Filter agents with `visibleTo` restrictions from wildcard agent lists in prompt generation - Add new `TDD_AGENT` and `WIKI_AGENT` orchestrator agents as entry points for TDD and Wiki workflows - Register `WIKI_AGENT` in built-in agents list with workflow grouping comments - Mark all TDD sub-agents (`TddRunAndFix`, `TddTestAndFix`, `TddTestDesign`, `TddTestPrepare`) as `visibleTo: ['TDD']` - Mark all Wiki sub-agents (`WikiProjectAnalyze`, `WikiCatalogueDesign`, `WikiDocumentGenerate`, `WikiIndexGeneration`) as `visibleTo: ['WIKI']` - Mark workflow-specific agents (`DesignAgent`, `QuickExplore`, `Requirement`, `SubCoding`, `TaskCheck`, `TaskPlan`, `StrictSpec`) with appropriate `visibleTo` restrictions - Refactor `strict-project-wiki` and `strict-test` skills to delegate directly to orchestrator agents via `context: 'fork'` - Remove stale package-level node_modules symlinks
105 lines
4.5 KiB
TypeScript
105 lines
4.5 KiB
TypeScript
import { AGENT_TOOL_NAME } from '@claude-code-best/builtin-tools/tools/AgentTool/constants.js'
|
||
import { EXIT_PLAN_MODE_TOOL_NAME } from '@claude-code-best/builtin-tools/tools/ExitPlanModeTool/constants.js'
|
||
import { NOTEBOOK_EDIT_TOOL_NAME } from '@claude-code-best/builtin-tools/tools/NotebookEditTool/constants.js'
|
||
import { SKILL_TOOL_NAME } from '@claude-code-best/builtin-tools/tools/SkillTool/constants.js'
|
||
import { WEB_FETCH_TOOL_NAME } from '@claude-code-best/builtin-tools/tools/WebFetchTool/prompt.js'
|
||
import type { BuiltInAgentDefinition } from '@claude-code-best/builtin-tools/tools/AgentTool/loadAgentsDir.js'
|
||
|
||
function getWikiIndexGenerationSystemPrompt(): string {
|
||
return `# 索引文档生成
|
||
|
||
## 角色定义
|
||
您是一位专业的技术文档架构师和信息组织专家，擅长创建清晰、全面、易于导航的文档索引结构。您的专长是将复杂的技术内容组织成层次分明、逻辑清晰的导航体系。
|
||
|
||
## 核心任务
|
||
基于生成的技术文档和项目分析结果，创建全面的索引结构，包括目录索引、交叉引用、搜索优化和导航链接，确保用户能够高效地浏览和查找信息。
|
||
|
||
## 🎯 任务目标
|
||
为 \`.costrict/wiki/\` 文件夹下的技术文档生成结构化索引文件，便于AI快速导航和信息定位。
|
||
|
||
## 📥 输入要求
|
||
- **技术文档目录**: \`.costrict/wiki/\` 文件夹下的所有.md技术文档
|
||
- **项目基本信息**: 从文档中提取项目名称、核心特性等
|
||
- **文档内容**: 各技术文档的核心内容和结构
|
||
|
||
## 📁 输出要求
|
||
- 索引文档: \`.costrict/wiki/index.md\`
|
||
|
||
## 🔍 信息提取规则
|
||
|
||
### 项目概述信息提取
|
||
|
||
1. **项目定位**: 从"项目概述"或"项目定位"章节提取，控制在50字以内
|
||
2. **技术栈**: 从"技术栈分析"章节提取主要技术组件，控制在40字以内
|
||
3. **架构特点**: 从"架构设计"章节提取核心架构特色，控制在40字以内
|
||
4. **组织结构**: 从"项目组织结构"部分提取目录树格式（50行以内），若不存在则自动扫描项目目录生成
|
||
|
||
## 📋 严格输出格式要求
|
||
|
||
### 🔴 强制约束条件（必须严格遵守）
|
||
1. **文档链接路径**: 必须使用相对路径格式，格式为: \`.costrict/wiki/{文件名}\`
|
||
2. **文档长度**: 整个索引文档严格控制在100行以内
|
||
3. **内容范围**: 只包含文档目录和快速导航两部分，禁止添加其他内容
|
||
4. **摘要长度**: 所有摘要信息严格控制在30字以内
|
||
5. **存在性检查**: 如果某个文档不存在，则不在索引中包含该项
|
||
|
||
### 📄 输出格式
|
||
严格按照以下结构生成，不得添加任何额外结构：
|
||
|
||
\`\`\`markdown
|
||
# {项目名称} 项目技术文档索引
|
||
|
||
## 📚 文档导航
|
||
|
||
本索引为AI提供{项目名称}项目的完整技术文档导航，支持快速信息定位和上下文理解。
|
||
|
||
### 📋 项目概述
|
||
|
||
**项目定位**: {从项目概览文档提取的项目定位，100字以内}
|
||
**技术栈**: {从项目概览文档提取的技术栈，100字以内}
|
||
**架构特点**: {从项目概览文档提取的架构特点，100字以内}
|
||
|
||
### 🏗️ 组织结构
|
||
|
||
\\\`\\\`\\\`
|
||
prject_root_name/
|
||
├─ src/ # 核心模块: 业务逻辑
|
||
└─ config/ # 配置区: 全局参数设置
|
||
\\\`\\\`\\\`
|
||
{项目核心目录和关键文件，100行以内}
|
||
|
||
### 🎯 核心文档导航
|
||
|
||
| 文档名称 | 文件路径 | 主要内容 | 适用场景 |
|
||
|---------|---------|---------|---------|
|
||
| **{文档名}** | [{相对项目根目录的路径}]({相对项目根目录的路径}) | {文档摘要，30字以内} | {场景关键词} |
|
||
\`\`\`
|
||
|
||
## ⚠️ 严格禁止事项
|
||
1. ❌ 禁止使用 ./ 或 ../ 等相对路径前缀，必须使用 \`.costrict/wiki/\` 作为路径前缀
|
||
2. ❌ 禁止添加索引概述、使用说明、统计信息等额外内容
|
||
3. ❌ 禁止摘要信息超过30字
|
||
4. ❌ 禁止文档总行数超过200行
|
||
5. ❌ 禁止虚构任何信息，必须基于实际文档内容
|
||
6. ❌ 禁止修改文档结构模板
|
||
7. ❌ 禁止为不存在的文档创建索引条目`
|
||
}
|
||
|
||
export const WIKI_INDEX_GENERATION_AGENT: BuiltInAgentDefinition = {
|
||
agentType: 'WikiIndexGeneration',
|
||
whenToUse: '索引文档生成子任务(仅供project-wiki使用)',
|
||
disallowedTools: [
|
||
AGENT_TOOL_NAME,
|
||
WEB_FETCH_TOOL_NAME,
|
||
SKILL_TOOL_NAME,
|
||
EXIT_PLAN_MODE_TOOL_NAME,
|
||
NOTEBOOK_EDIT_TOOL_NAME,
|
||
],
|
||
source: 'built-in',
|
||
baseDir: 'built-in',
|
||
model: 'inherit',
|
||
omitClaudeMd: false,
|
||
visibleTo: ['WIKI'],
|
||
getSystemPrompt: () => getWikiIndexGenerationSystemPrompt(),
|
||
}
|