ah-project

name	ah-project
description	Use when 需要启动新项目并自动完成编号检查、项目目录与主页创建，以及领域页项目关联更新时。

执行 Obsidian 的读取、检索、写入等动作时，优先调用官方技能：obsidian-cli。

项目创建自动化

目标：用一次流程完成“项目立项 + 编号分配 + 文件落盘 + 领域关联”，确保项目可立即执行。

启动即执行

1. 读取项目目录：{{notePaths.activeProjects}}/。
2. 读取项目总览：{{notePaths.activeProjects}}/📍 项目总览.md（若存在）。
3. 收集项目输入：名称、目标、截止日期、优先级、所属领域。

流程锁定规则（高优先级）

• 用户在回答中提到“阅读/笔记/回顾”等词，默认视为项目信息输入，不自动切技能。
• 仅在两种情况允许切换：
  • 用户明确输入其他命令（如 /ah-read）
  • 用户明确要求停止本次项目创建
• 流程完成标志：项目目录已创建 + 项目主页已写入 + 领域页已同步。

重要提醒

• 禁止使用示例数据；项目编号与名称必须来自真实目录扫描与用户输入。
• 项目编号必须先扫描后分配，禁止猜测“下一个编号”。
• 路径操作前先确认目标目录存在；不存在先创建。
• 涉及多领域时可多点关联，但项目主页路径唯一。

触发机制

• 主动触发：用户输入“新建项目 / 启动项目 / 立项”。
• 路由触发：从 ah 入口或周/月回顾中识别需要新开项目。

主流程

1. 阶段一：收集并确认项目信息。
2. 阶段二：扫描现有编号并确定新编号。
3. 阶段三：创建项目目录并生成项目主页。
4. 阶段四：更新项目总览与所属领域页关联。
5. 阶段五：输出创建结果与下一步建议。

关键执行规则（确定性）

• 编号格式需沿用当前知识库的实际样式（先扫描再决定，如 26-01 项目名）。
• 年份规则：同年内序号递增；跨年后从 01 重新开始。
• 项目主页模板：assets/项目模板.md。
• 项目主页路径：{{notePaths.activeProjects}}/{{编号}} {{项目名称}}/📍 项目总览.md。
• 主页必须包含基础字段：编号、目标、领域、优先级。
• 主页必须包含 Dataview 面板：项目文件目录（当前项目下全量文件）与最近更新（mtime 倒序）。
• 领域页路径固定：
  • {{notePaths.domainPages}}/🌱 内容创作.md
  • {{notePaths.domainPages}}/🌱 产品开发.md
  • {{notePaths.domainPages}}/🌱 个人成长.md
  • {{notePaths.domainPages}}/🌱 效率工具.md
• 若 {{notePaths.activeProjects}}/📍 项目总览.md 不存在，先创建最小索引结构再写入项目条目。
• 若无匹配领域页，先与用户确认是否新建，再用 /.opencode/skills/ah-init/references/领域页模板.md 创建并写入首个关联项目。

快速立项模式

触发：用户只想先开项目框架，细节稍后补。

最小交付：

1. 确定项目名称与所属领域（最低必填）。
2. 完成编号分配与目录创建。
3. 生成基础项目主页。
4. 更新项目总览与领域页。

输出标准

• 必须输出：
  • 新项目编号与完整路径
  • 已创建文件列表
  • 已更新的领域页列表
  • 下一步建议（完善成功标准/行动计划/支撑知识）
• 输出必须可追溯，包含可点击路径。

检查清单

• 已完成项目输入确认
• 已完成编号扫描与分配
• 已创建项目目录与项目主页
• 已更新项目总览
• 已同步领域页关联
• 已输出可追溯结果

渐进加载（按需读取）

• 详细流程与分支处理：references/workflow-and-domain-rules.md
• 输出模板与回执格式：references/output-templates.md
• 项目主页模板：assets/项目模板.md

相关技能

• ah-archive：项目完成后归档
• ah-week / ah-month：在回顾中跟踪项目推进
• ah-card：将项目经验沉淀为永久笔记