Agent Skills
› franklioxygen/agent-workflows
› project-initialization
project-initialization
GitHub用于引导新项目、绿地仓库初始化及工具链配置。通过执行标准化工作流,支持 Minimal/Standard/Complex 项目搭建,完成脚手架生成、验证与交接,确保初始环境合规且可开发。
Trigger Scenarios
创建新项目
初始化仓库
搭建绿地代码库
选择初始工具链
配置包管理
创建基础配置文件
验证初始脚手架
Install
npx skills add franklioxygen/agent-workflows --skill project-initialization -g -y
SKILL.md
Frontmatter
{
"name": "project-initialization",
"description": "使用 agent-workflows 的项目初始化工作流来启动新项目和绿地仓库;当 Codex 被要求创建新项目、初始化仓库、搭建绿地代码库、选择初始工具链、配置包管理、创建基础 README\/.gitignore\/配置文件或验证初始脚手架时使用。"
}
项目初始化
快速开始
- 找到最近的
agent-workflows库。如果它不在当前工作区附近,询问AGENT_WORKFLOWS_ROOT或该库路径。 - 阅读
project-initialization-agent-workflow.md。 - 阅读 ../_shared/references/skill-operating-rules.md。
- 直接应用工作流。除非用户明确要求模板,否则不要只是复述提示词。
- 在创建文件前,必须先拿到明确的目标目录。
执行规则
- 该技能用于新项目、绿地代码库、初始仓库脚手架和项目工具链设置。
- 把工作流文件视为预检、分诊、规划、脚手架搭建、验证和交接的唯一事实来源。
- 在分诊前先运行工作流中的预检,这样才能提前知道目标目录状态、父级工作区规则、本地说明、可用工具链以及无关本地变更。
- 对于 Minimal 项目,在确认目标目录后,用合理默认值直接搭建脚手架。
- 对于 Standard 和 Complex 项目,按工作流中的“规划 / 评审 / 搭建 / 验证 / 交接”顺序执行。
- 未经明确许可,不要提交或推送。
- 不要覆盖、回退、删除或重新格式化无关的用户变更。
- 如果目标目录缺失、有歧义,或意外地已经有内容,先停下来提问。
执行指引
- 确认目标目录并检查其当前状态。
- 加载并遵循
project-initialization-agent-workflow.md中的分诊门。 - 选择合适路径:
- Minimal:使用 Minimal Project Prompt。
- Standard:先收集需求,再创建/评审计划,然后搭建并验证。
- Complex:完整执行整个工作流,并分别进行评审与验证。
- 搭建脚手架时,让所有生成文件都留在已确认的目标目录内。
- 使用该生态系统相关的安装、lint、类型检查、构建、测试和冒烟命令进行验证。
- 报告创建的文件、配置的工具链、验证结果、偏差、已知限制和下一步建议。
参考资料
交接
- 如果初始化后的项目已经可以进入功能开发,则交接给功能开发工作流。
- 如果验证阶段暴露出脚手架中的局部缺陷,就在该工作流内修复。
- 如果验证暴露出更大的设计或技术决策问题,则先回到项目计划,再修改脚手架。
Version History
- 063f52c Current 2026-07-05 20:15


